diff --git a/twander.1 b/twander.1 index 6415046..f486828 100644 --- a/twander.1 +++ b/twander.1 @@ -154,17 +154,28 @@ Options set on the command line +.P This means, for example, that the environment variable overrides a corresponding setting in the Configuration File, but the command line overrides the environment variable. Furthermore, there are many program options which can .B only be set/changed the Configuration File and are not available in -either the environment variable or on the command line. +either the environment variable or on the command line. -Reloading the Configuration File (see READCONF below) causes this -4-step assessment to take place again, thereby allowing \'twander\' to -reflect any changes made in the configuration. +This also means that options set on the command line are not read +until after the Configuration File has been processed. So, the -q +argument on the command line will not inhibit warnings generated +during the reading of the Configuration File. This is best done by +adding the statement, "WARN=False" at the top of the Configuration +File. + +If the Configuration File is reloaded while the program is running +(see the READCONF key below), any options set in the file will have +the last word. This allows you to edit the Configuration File and +have your changes reflected in a running instance of \'twander\', but +it also means that the environment variable/command line arguments are +ignored after initial program startup. .SH KEYBOARD USE @@ -373,7 +384,12 @@ As described later in this document, \'twander\' provides enhanced features for Win32 users who also install Mark Hammond's \'win32all\' extensions for Python on Win32. This key binding will toggle those -advanced features on- and off. +advanced features on- and off. This is useful if you happen to +be examining a very large directory. The \'win32all\' features, +while handy, can be computationally expensive and make updates of +a directory with many entries somewhat slow. This toggle is provided +as a means to temporarily disable the advanced features when viewing +such a directory. .SS DIRECTORY NAVIGATION @@ -1522,6 +1538,16 @@ .SH OTHER + +File/Directory name sorting is done without-case sensitivity on +Win32 systems because the underlying operating system does not +observe case. + +Because this program has not been tested on anything other than +Unix-like and Win32 systems, command execution by double-click +or pressing Enter is inhibited on all other operating systems +by default. + You must have Python 2.2 or later installed as well as Tkinter support installed for that release. In the case of Win32, Tkinter is bundled with the standard Windows Python distribution. In the case of @@ -1583,6 +1609,40 @@ To run the program, just type "twander.py" from a shell prompt. +.B Red Hat Linux Users Please Note: +RH Linux (and possibly other Linux systems) install two versions of +Python. Version 1.52 is called \'python\', and Version 2.2 is called +\'python2\'. \'twander\' requires the latter and will not run on the +former. As shipped, \'twander\' invokes Python with the Unix shell +"#!" mechanism using the name \'python\' - which in this case is the +wrong version. You can work around this problem one of several ways: + +.IP \(bu 4 +Rename \'python\' to \'python1\' and then rename \'python2\' +to \'python\'. (Not Recommended - could break other programs.) + +.IP \(bu 4 +Write an alias or shell script which explicity starts +\'twander\' with the correct version of Python: + +.nf +#!/bin/sh +python2 twander.py $* +.fi + +.IP \(bu 4 +Change the first line of the \'twander\' code to refer +to \'python2\' instead of \'python\'. + +.P +Red Hat users who have upgraded from earlier versions should +also note that you may have files in your home directories owned by +owners and groups which are not defined in the system! \'twander\' +shows the owner and group fields for such files as numbers rather than +names. As best as we can determine, this is caused when an RH +installation is updated from an older version. + + .SS Installing Manually On A Win32 System Copy the "twander.py" file to a directory somewhere on your path, or