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

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

Update of /cvsroot/env-switcher/env-switcher/man
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv25148

Modified Files:
	switcher.1 
Log Message:
Document the switcher-reload command.


Index: switcher.1
===================================================================
RCS file: /cvsroot/env-switcher/env-switcher/man/switcher.1,v
retrieving revision 1.9
retrieving revision 1.10
diff -C2 -r1.9 -r1.10
*** switcher.1	16 Jan 2004 15:37:29 -0000	1.9
--- switcher.1	8 Mar 2004 16:43:39 -0000	1.10
***************
*** 12,15 ****
--- 12,17 ----
  .PP
  switcher <tag> <command> [<args>]
+ .PP
+ switcher-reload
  .SH DESCRIPTION
  .I switcher
***************
*** 33,36 ****
--- 35,59 ----
  at a time.
  .PP
+ Note that 
+ .I switcher
+ usually only edits defaults for
+ .I future
+ shell invocations.  Specifically, it does
+ .I not
+ change the current environment.  Although this is for a variety of
+ good technical reasons, it can cause unexpected behavior if a user
+ runs a switcher command and then wonders why the environment has not
+ bee changed.  The
+ .I switcher-reload
+ command is provided for this purpose.  It will re-initialize the
+ environment according to whatever the current set of
+ switcher-specified settings are.  Hence, users now have two choices
+ after running
+ .IR switcher :
+ 1) run
+ .IR switcher-reload ,
+ or 2) load a new shell (e.g., logout and log back in again, launch a
+ new shell and/or window, etc.).
+ .PP
  .I switcher
  allows for a set of system-level defaults as well as user-level
***************
*** 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
--- 409,412 ----