debian man page for path2listing

PATH2LISTING(1) 					      General Commands Manual						   PATH2LISTING(1)

NAME
       path2listing - script facilitating the conversion to managing gconf configuration sources with desktop-profiles

SYNOPSIS
       path2listing [options]

DESCRIPTION
       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 desktop-profiles_path2listing.listing file containing metadata for all known configuration sources,
       assigning a precedence value to each encountered configuration source so that:

	      a) the order of sources is the same

	      b) there is space between the precedence values of the various sources to allow for inclusion of additional profiles in the future.

	      c) all mandatory sources have a positive precedence value, and all non-mandatory sources have a negative precedence value

       In addition to generating the desktop-profiles_path2listing.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).

OPTIONS
       -d,--distance

	      distance between the precedence values of each successive pair of configuration sources (defaults to 50), the idea  being  that  you
	      leave some space to insert future sources.

       -f, --file

	      path file to convert (defaults to /etc/gconf/2/path)

       -h, --help

	      display the help message

       -o, --output-file

	      file to put the generated metadata in (defaults to /etc/desktop-profiles/desktop-profiles_path2listing.listing). If this file exists
	      a backup copy will be made prior to overwriting it.

       --no-replace-file

	      don't replace the path file we're converted with one assuming desktop-profiles manages activation

FILES
       /etc/gconf/2/path - systemwide gconf path file, default path file to convert

       /etc/desktop-profiles/desktop-profiles_path2listing.listing - default name for the file containing the generated metadata

AUTHOR
       This manual page was written by Bart Cornelis <cobaco@skolelinux.no>.

SEE ALSO
       desktop-profiles(7)

desktop-profiles						   May 07, 2005 						   PATH2LISTING(1)