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 ----
|
