diff --git a/twander.1 b/twander.1 index 895e187..42a6b98 100644 --- a/twander.1 +++ b/twander.1 @@ -1,7 +1,9 @@ .TH twander 1 "TundraWare Inc." -.SH twander +.SH NAME +twander \- File Browser +.SH OVERVIEW Wander around a filesystem executing commands of your choice on selected files and directories. If you're new to \'twander\' and want to know why this program is better and different than whatever you're @@ -455,7 +457,10 @@ By default, the program expects to find configuration information in .B $HOME/.twander -but you can override this with the -c command line option. +but you can override this with the -c command line option. (Recommended +for Win32 systems - see the section below entitled, +.B INSTALLING \'twander\' +) Actually, \'twander\' can look in a number of places to find its configuration file. It does this using @@ -617,7 +622,7 @@ variable name in another User-Variable Definition so long as all these variable are defined by the time they appear in a Command String. The following is OK because all variables are defined by the time they -actually needed: +are actually needed: .nf Var1 = foo @@ -1106,12 +1111,12 @@ the command is complete and the window has input focus. .SH OTHER -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 Unix-like, you may have to first install Python and -then the appropriate release of Tkinter. This is the case, -for example, with FreeBSD. +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 +Unix-like systems, you may have to first install Python and then the +appropriate release of Tkinter. This is the case, for example, with +FreeBSD. .SH BUGS AND MISFEATURES The color options (-b, -f), font options (-n, -s, -w), and size option @@ -1174,14 +1179,27 @@ create a new directory to hold this file and add that directory path to the PATH environment variable. -On Win32, where to put the ".twander" configuration file raises an -interesting question. Microsoft operating systems normally do not set -the "HOME" environment variable, because they have no notion of a -"home" directory - Well, they do, but it is called "USERPROFILE" not -"HOME". So, you can either create a new user-specific environment -variable called HOME yourself (which points to your desired home -directory) or you can invoke \'twander\' with the -c argument to -explictly declare where it can find its configuration file. +.B IMPORTANT NOTE TO WIN32 USERS: +Windows has the old MS-DOS legacy of assuming that a "." begins a file +"extension". Although you can create and read files in the form +".something", it is not recommended because many Win32 programs get +confused when they see this. It is also difficult to remove files +named this way with the standard Windows programs and utilities. This +is especially the case for older Win32 operating systems like Win98. +For this reason, it is recommended that you rename the ".twander" +default configuration file provided in the program distribution to +something else like "twander.conf" and use the \'twander\' -c command +line option to point to this configuration file. + + +On Win32, where to put the configuration file raises an interesting +question. Microsoft operating systems normally do not set the "HOME" +environment variable, because they have no notion of a "home" +directory - Well, they do, but it is called "USERPROFILE" not "HOME". +So, you can either create a new user-specific environment variable +called HOME yourself (which points to your desired home directory) or +you can invoke \'twander\' with the -c argument to explictly declare +where it can find its configuration file. You can run the program several ways on Win32 systems: