[liboobs] Add new values to OobsUserHomeFlags

[Milan Bouchet-Valat <milanbv src gnome org>]

commit 327d0a5ee8f3412ad94f94ee0a53df38eba35d4d
Author: Milan Bouchet-Valat <nalimilan club fr>
Date:   Tue Aug 17 20:38:55 2010 +0200

    Add new values to OobsUserHomeFlags
    
    Add OOBS_USER_CHOWN_HOME, OOBS_USER_COPY_HOME and
    OOBS_USER_ERASE_HOME. These new flags are introduced by
    the system-tools-backends 2.10.1, which we now require; they
    are used by the gnome-system-tools 2.31.91.
    
    Also improve comments about this enum.

 configure.in     |    2 +-
 oobs/oobs-user.h |   20 ++++++++++++++++++--
 2 files changed, 19 insertions(+), 3 deletions(-)
---
diff --git a/configure.in b/configure.in
index fe44b2e..2bb5bbe 100644
--- a/configure.in
+++ b/configure.in
@@ -33,7 +33,7 @@ AC_SUBST(LT_AGE)
 
 GLIB_REQUIRED=2.14.0
 DBUS_REQUIRED=0.70
-STB_REQUIRED=2.9.2
+STB_REQUIRED=2.10.1
 HAL_REQUIRED=0.5.9
 
 dnl set gettext stuff
diff --git a/oobs/oobs-user.h b/oobs/oobs-user.h
index 25a75d6..1dded3a 100644
--- a/oobs/oobs-user.h
+++ b/oobs/oobs-user.h
@@ -56,9 +56,25 @@ struct _OobsUserClass {
   void (*_oobs_padding4) (void);
 };
 
+/**
+ * OobsUserHomeFlags:
+ * @OOBS_USER_REMOVE_HOME: When removing an #OobsUser, also remove home dir; when
+ *     committing, if home dir changes, remove old home dir.
+ * @OOBS_USER_CHOWN_HOME: When creating or committing an #OobsUser, recursively
+ *     change the owner of home dir to user and main group.
+ * @OOBS_USER_COPY_HOME: When committing an #OobsUser and if home dir changes,
+ *     copy old home to new path, overwriting files if needed (!).
+ * @OOBS_USER_ERASE_HOME: When committing an #OobsUser and if home dir changes,
+ *     delete already present directory.
+ *
+ * Determine special behaviors regarding the home directory. Flags only apply to
+ * some operations (commit, add or delete user), and have no effect in other cases.
+ */
 typedef enum {
-  OOBS_USER_REMOVE_HOME = 1,
-  OOBS_USER_CHOWN_HOME  = 1 << 1
+  OOBS_USER_REMOVE_HOME  = 1,
+  OOBS_USER_CHOWN_HOME   = 1 << 1,
+  OOBS_USER_COPY_HOME    = 1 << 2,
+  OOBS_USER_ERASE_HOME   = 1 << 3
 } OobsUserHomeFlags;
 
 GType oobs_user_get_type (void);