[env-switcher-cvs] CVS: env-switcher/man switcher.1,1.8,1.9

[Jeff S. <jsq...@us...>]

Update of /cvsroot/env-switcher/env-switcher/man
In directory sc8-pr-cvs1:/tmp/cvs-serv29178/man

Modified Files:
	switcher.1 
Log Message:
Update to the man page about limitations of the command line parsing scheme


Index: switcher.1
===================================================================
RCS file: /cvsroot/env-switcher/env-switcher/man/switcher.1,v
retrieving revision 1.8
retrieving revision 1.9
diff -C2 -r1.8 -r1.9
*** switcher.1	13 Feb 2003 22:48:28 -0000	1.8
--- switcher.1	16 Jan 2004 15:37:29 -0000	1.9
***************
*** 137,141 ****
  .PP
  The "--system", "--user", "--force", and "--silent" arguments can be
! also be used.
  .PP 
  When
--- 137,143 ----
  .PP
  The "--system", "--user", "--force", and "--silent" arguments can be
! also be used.  Note that "--system", "--user", etc., must be the last
! arguments on the command line, due to limitations of switcher's
! command line parsing scheme.  See the BUGS section, below.
  .PP 
  When
***************
*** 156,162 ****
  or
  .I user
! indicating which level the attribute is actually set at, "name"
! will be the name of the attribute shown, and "value" will be the value
! of the attribute.
  .IP --add-tag
  Add the tag to the
--- 158,166 ----
  or
  .I user
! indicating which level the attribute is actually set at, "name" will
! be the name of the attribute shown, and "value" will be the value of
! the attribute.  Note that the "--system" or "--user" switch must be
! the last argument on the command line, due to limitations of
! switcher's command line parsing scheme.  See the BUGS section, below.
  .IP --add-tag
  Add the tag to the
***************
*** 202,206 ****
  .I --user
  is specified or no scoping argument is given, the attribute and value
! are written to the user-level default file for the current user.
  .IP "--rm-attr <attribute> [--system|--user]"
  Remove the attribute
--- 206,213 ----
  .I --user
  is specified or no scoping argument is given, the attribute and value
! are written to the user-level default file for the current user.  Note
! that the "--system" or "--user" switch must be the last argument on
! the command line, due to limitations of switcher's command line
! parsing scheme.  See the BUGS section, below.
  .IP "--rm-attr <attribute> [--system|--user]"
  Remove the attribute
***************
*** 213,217 ****
  .I --user
  is specified or no scoping argument is given, the attribute is removed
! from the user-level default file for the current user.
  .SH NOMENCLATURE
  .I switcher
--- 220,227 ----
  .I --user
  is specified or no scoping argument is given, the attribute is removed
! from the user-level default file for the current user.  Note that 
! the "--system" or "--user" switch must be the last argument on the command
! line, due to limitations of switcher's command line parsing scheme.
! See the BUGS section, below.
  .SH NOMENCLATURE
  .I switcher
***************
*** 376,379 ****
--- 386,399 ----
  is effectively disabled for all users who do not specifically use
  .IR switcher .
+ .SH BUGS
+ Due to limitations in switcher's command line parsing scheme, the
+ ordering or arguments listed in this man page and in the help messages
+ must be preserved.  For example, "--user" and "--system" must be the
+ last arguments on the command line.
+ .PP
+ This is certainly fixable, but it would probably require an overhaul
+ the parsing system, and probably ditching the Perl AppConfig module
+ that is currently used for parsing (due to limitations of AppConfig).
+ I just don't have the time to do that right now.  :-)
  .SH FILES
  The defaults are maintained in ini-style text files.  These files can