[debian-edu-commits] debian-edu/ 90/183: Updated man page for conversion script

[Alexander Alemayhu]

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 78a7d7cc298ac5860d1726cab02068c0f18af276
Author: Bart Cornelis <cobaco at linux.be>
Date:   Fri Sep 30 22:53:41 2005 +0000

    Updated man page for conversion script
---
 path2listing.1 | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/path2listing.1 b/path2listing.1
index 37ccb5d..dcd6c09 100644
--- a/path2listing.1
+++ b/path2listing.1
@@ -7,13 +7,15 @@ path2listing \- script facilitating the conversion to managing gconf configurati
 path2listing [options]
 
 .SH DESCRIPTION
-This script will generate the metadata (.listing file) needed by desktop-profiles to manage the configuration sources activated (directly or indirectly through included path files) by the path file it is called on (which is the global one by default). 
-.PP
-In addition to generating the necessary metadata the script 
-will also replace the converted path file by one that assumes
-that desktop-profiles manages the activation of all configuration sources (unless you tell it not to off course).
+This script takes a single gconf path file (the systemwide one, i.e. /etc/gconf/2/path, when not told otherwise) and reads through it in order to create an ordered list of known configuration sources (it will recurse into included path files when necessary). Using that ordered list it will then create a path2listing_generated.listing file containing metadata for all known configuration sources, assigning a precedence value to each encountered configuration source so that:
+.IP 
+a) the order of sources is the same 
+.IP 
+b) there is space between the precedence values of the various sources to allow for inclusion of additional profiles in the future.
+.IP
+c) all mandatory sources have a positive precedence value, and all non-mandatory sources have a negative precedence value
 .PP
-NOTE: a backup copy will be made of all files that are changed
+In addition to generating the path2listing_generated.listing file, this script will also replace the converted path file by one that assumes that desktop-profiles manages all configuration sources (NOTE: a backup copy of all changed files is made, so you can always go back to the previous situation).
 
 .SH OPTIONS
 .PP

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