diff --git a/twander.1 b/twander.1 index ded0ce7..46eb218 100644 --- a/twander.1 +++ b/twander.1 @@ -651,7 +651,73 @@ .SH INSTALLING \'twander\' -Installation of \'twander\' is fairly simple. +Installation of \'twander\' is fairly simple and takes only a few +moments. The most important thing before installing the program is to +make sure you have Python 2.2 (or later) with Tkinter support +installed on your system. + +One other note: However you install the program, it is probably +easiest to get started by editing the example ".twander" file to +taste. Be aware that this file is shipped with everything commented +out. You have to uncomment/edit the section relevant to your +operating system: Unix-like or Win32. + +.SS Installing Using The FreeBSD Port + +If you've installed \'twander\' using the FreeBSD port, all you have +to do is copy the example configuration file, ".twander" found in +/usr/local/share/doc/twander to your home directory and edit it to +taste. + +.SS Installing Manually On A Unix-like System + +Copy the "wander.py" file to a directory somewhere on your path. +(/usr/local/bin is a good candidate). Make sure this file has +permissions 755 and owner/group appropriate for your system +(root/wheel, root/root, or bin/bin). Copy the ".twander" file +to your home directory and edit to taste. + +To run the program, just type "twander.py" from a shell prompt. + +.SS Installing Manually On A Win32 System + +Copy the "twander.py" file to a directory somewhere on your path. or +create a new directory to hold this file and add that directory path +to the PATH environment variable. + +Where to copy the ".twander" configuration file is an interesting +question on Win32. 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 systemwide 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: + +.IP +Create a Win32 shortcut which points to the "twander.py" file +using the "pythonw" command to invoke it. This suppresses +the creation of a blank invocation window. For example, +you might have something like this in the "Target:" field +of your shortcut: + +.nf +"C:\\Program Files\\Python\\pythonw.exe" C:\\twander.py / +.fi + +.IP +Start a command line window and issue a command like the one +above directly from the command line. + +.IP +Use Windows Explorer (or better still, an already running instance +of \'twander\'!) to navigate to the directory where "twander.py" +is located. Double-click on the file. If Python is properly +installed, there should be an association for ".py" file types +and all should run just fine. + .SH DESIGN PHILOSOPHY Graphical User Interfaces (GUIs) are a blessing and a curse. On the