[debian-edu-commits] debian-edu/ 138/183: Added documentation for personality setting

Wed Jun 11 16:48:41 UTC 2014

This is an automated email from the git hooks/post-receive script.

ccscanf-guest pushed a commit to branch master
in repository desktop-profiles.

commit b2b0de659b5b68a3c20a730e5ac1f2907c77a637
Author: Bart Cornelis <cobaco at linux.be>
Date:   Fri Apr 13 20:56:45 2007 +0000

    Added documentation for personality setting
---
 20desktop-profiles_activateDesktopProfiles |  8 +++++---
 debian/changelog                           | 11 +++++++----
 desktop-profiles.7                         | 16 +++++++++++++++-
 3 files changed, 27 insertions(+), 8 deletions(-)

diff --git a/20desktop-profiles_activateDesktopProfiles b/20desktop-profiles_activateDesktopProfiles
index e778e4d..cd3a953 100644
--- a/20desktop-profiles_activateDesktopProfiles
+++ b/20desktop-profiles_activateDesktopProfiles
@@ -345,11 +345,11 @@ if (test $INSTALLED = true); then
   
 
   # sheep don't form an opintion, they just follow along
-  # so skip everything if set to be sheep
+  # so skip everything if personality is set to sheep
   if (test "$PERSONALITY" != sheep); then
 
     #################################################
-    # Make sure the variable we need are initialized
+    # Make sure the variables we need are initialized
     #################################################
     LISTINGS_DIRS=${LISTINGS_DIRS:-'/etc/desktop-profiles'}
     CACHE_DIR=${CACHE_DIR:-'/var/cache/desktop-profiles'}
@@ -370,7 +370,9 @@ if (test $INSTALLED = true); then
       # save UDEdir contents, as we might need it, then unset that var
       UDEdir_current=$UDEdir; unset UDEdir;
   
-      # read the cache, replacing markers with variables contents when present
+      # export the variable settings in the cache file after replacing 
+      # the placeholders for the current variable values with said values 
+      # (the location of placeholders is based on the active personalitytype)
       export $(cat "$CACHE_FILE" | sed -e "s|\\\$KDEDIRS|$KDEDIRS|" \
                             -e "s|\\\$XDG_CONFIG_DIRS|$XDG_CONFIG_DIRS|" \
                             -e "s|\\\$XDG_DATA_DIRS|$XDG_DATA_DIRS|" \
diff --git a/debian/changelog b/debian/changelog
index 0a532f6..7a61d6b 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,4 +1,4 @@
-desktop-profiles (1.4.14) UNRELEASED; urgency=low
+desktop-profiles (1.4.14) unstable; urgency=low
 
   * Adapted lintian override for csh/tcsh login hook to reflect change in
     lintian 1.23.25
@@ -10,11 +10,14 @@ desktop-profiles (1.4.14) UNRELEASED; urgency=low
     - don't create user path files if we don't add any gconf sources
   * Added observations about performance to README, and add zip with the
     performance test script and test data sets in /usr/share/doc
-  * Added caching of profile-activation in the simple case where the result
-    is a static machine wide set of profiles (that is when no group or command
+  * Added caching of profile-activation in the simple case where the resulting
+    profile assignment is always the same (i.e when no group or command
     requirements are present in potentially active profiles).
+  * desktop-profiles now has a personality setting that determines how it
+    reacts to the environment variables controlling the active profiles
+    already being set by some other agent.
 
- -- Bart Cornelis (cobaco) <cobaco at linux.be>  Wed, 13 Dec 2006 21:00:33 +0100
+ -- Bart Cornelis (cobaco) <cobaco at linux.be>  Mon, 09 Apr 2007 22:26:29 +0200
 
 desktop-profiles (1.4.13) unstable; urgency=low
 
diff --git a/desktop-profiles.7 b/desktop-profiles.7
index 222f965..3f11390 100644
--- a/desktop-profiles.7
+++ b/desktop-profiles.7
@@ -27,6 +27,19 @@ By default the Xsession.d script will assume the metadata files are authoritive,
 .IP NOTE:
 The default system-wide path contains a number of configuration sources not managed by desktop-profiles. In order to facilitate the management of all your configuration sources through desktop-profiles this package provides a script (/usr/sbin/path2listing) that looks at your current gconf configuration and adapts it so your configuration sources are all controlled by desktop-profiles (see the man page for path2listing or the /usr/share/doc/destkop-profiles/README for more information on this).
 
+.SH INTERACTION WITH OTHER AGENTS ACTIVATING PROFILES
+Since profiles are activated through environment variables one issue is how desktop-profiles deals with the situation where those environment variables have already been set up by other agents (such an agent could be another script, or the user). Desktop-profiles has a personality setting that determines how it handles such a situation:
+.IP \(bu 3
+autocrat: assume desktop-profiles is the only agent allowed to touch the environment variables, and consequently ignore the contents of already set environment variables.
+.IP \(bu 3
+rude: profiles added by desktop-profiles take precedence over profiles added by other agents.
+.IP \(bu 3
+polite: profiles added by other agents take precedence over profiles added by desktop-profiles.
+.IP \(bu 3
+sheep: just meekly follow along with what the other agents have set, don't change anything (this essentially deactivates desktop-profiles).
+.PP
+The default personality setting of desktop-profiles is polite.
+
 .SH WHERE TO FIND THE PROFILE METADATA
 The metadata is specified in .listing files that are placed in the /etc/desktop-profiles directory. The format of those files is specified in the 'FORMAT OF .listing FILES'-section below.
 .IP NOTE:
@@ -114,7 +127,8 @@ Programs _may_ merge the files the different profiles. If the merging encounters
 .IP   
 See http://rox.sourceforge.net/choices.html for a more detailed description.
 .IP \(bu 3
-.B GNUSTEP (through GNUSTEP_PATHLIST)
+.B GNUSTEP 
+(through GNUSTEP_PATHLIST)
 .IP
 Profiles in GNUSTEP parlance are called domains, and by default GNUSTEP will look in 4 domains (the location of which is indicated by the GNUSTEP_USER_ROOT, GNUSTEP_LOCAL_ROOT, GNUSTEP_NETWORK_ROOT, and GNUSTEP_SYSTEM_ROOT variables). Though it is possible to specify extra domains to use through the GNUSTEP_PATHLIST variable, it isn't often done as configuration files are currently only searched for in the user domain.
 .IP

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/debian-edu/pkg-team/desktop-profiles.git

