diff --git a/twander.1 b/twander.1 index cfdfd6b..c88d6be 100644 --- a/twander.1 +++ b/twander.1 @@ -1020,10 +1020,10 @@ the maximum size of dynamic menus (see the section below on the \*(CF which explains how such options are actually set. The MAXMENU option specifies the maximum number entries -.B we will be displayed +.B that will be displayed in any dynamic menu. (\*(TW internally tracks MAXMENUBUF number of -items for each dynamic menu.) This defaults to 32 as is intended as a -way to keep the menu size reasonable. +items for each dynamic menu.) This defaults to 32 as is intended +to keep the menu size reasonable. If you set MAXMENU=0, it means you are .B disabling @@ -2099,6 +2099,27 @@ \*(TW treats them like a User-Defined Variable as described below. +.SS Wildcard Statements + +As discussed above, \*(TW provides powerful regular +expression-based "wildcard" selection capabilities +via the SELWILD command. (default: Control-\\) These +regular expressions can be complex and tedious to enter +by hand each time you need them. You can pre-defined +frequently needed wildcard strings in your Configuration +File using the following statement: + +.nf +WILDCARD = regular-expression-string +.fi + +This regular expression will then be pre-loaded into the Wildcard Menu +(making it easy to invoke by just clicking on it) when \*(TW starts. +You may place as many of these as you like in your \*(CF. +(Though the menu will be limited to displaying MAXMENU number of items - +see the section above on Program Option Statements.) + + .SS Variables And Command Definitions Most programs "ship from the factory" with a pre-defined @@ -2125,27 +2146,6 @@ any combination of three variable types: User-Defined Variables, Environment Variables, and Built-In Variables. -.SS Wildcard Statements - -As discussed above, \*(TW provides powerful regular -expression-based "wildcard" selection capabilities -via the SELWILD command. (default: Control-\\) These -regular expressions can be complex and tedious to enter -by hand each time you need them. You can pre-defined -frequently needed wildcard strings in your Configuration -File using the following statement: - -.nf -WILDCARD = regular-expression-string -.fi - -This regular expression will then be pre-loaded into the Wildcard Menu -(making it easy to invoke by just clicking on it) when \*(TW starts. -You may place as many of these as you like in your \*(CF. -(Though the menu will be limited to displaying MAXMENU number of items - -see the section above on Program Option Statements.) - - .SS User-Defined Variables And Environment Variables User-Defined Variables are defined using the syntax: @@ -2745,16 +2745,14 @@ .fi To make it easy to create conditional blocks based on the type of -system you're running, \*(TW automatically pre-defines two -variables which provide information about your system: - -.nf -Variable Name Typical Values --------------------------------- - -\& .OS nt, posix -\& .PLATFORM freebsd4, linux-i386, win32 -.fi +system you're running, \*(TW automatically pre-defines two variables +which provide information about your system: +.B \&.OS +(typically: nt, posix) and +.B \&.PLATFORM +(typically: freebsd4, linux-i386, win32). You should run \*(TW and +examine the "User-Defined Variables" section of the Help Menu to see +how these variables are set on your system. These predefined variables show up as "User Defined Variables" in the various \*(TW Help and Debug outputs, but they begin with a period to @@ -2794,7 +2792,7 @@ .IP \(bu 4 The ".endif" statement must appear on the line by itself. Nothing -other than whitespace may precede it, and nothing (other than a +other than whitespace may precede it, and nothing (other than whitespace or a comment) may follow it. .P @@ -3064,6 +3062,29 @@ On Win32, environment variables are set via the System Properties menu. +.SS \*(TW Loads Slowly + +\*(TW is a fairly large Python program and can take a few seconds to +load and initialize, especially on older, slower systems. You can +speed this up a bit by creating an optimized byte-code version of +the program as follows (make sure you have appropriate administrative +permission to do this): + +.nf +1) Go to the directory where the twander.py file is located. +2) Type the following command: python -O +3) Once Python is loaded type: import twander +4) Exit \*(TW. +5) Exit Python by pressing Control-d on Unix or + Control-z on Win32. +6) You will now see a new file in this directory: twander.pyo + This file should be significantly smaller than twander.py. +7) Now you can run the program by entering: python twander.pyo + on Unix/Win32 or pythonw twander.pyo on Win32. +8) You have to repeat this procedure each time you install + a new version of twander.py +.fi + .SS Cannot Enter Certain Directories On Win32 Win32 allows file/directory names to contain non-ASCII @@ -3471,7 +3492,6 @@ .fi - .SH OTHER File/Directory name sorting is done without-case sensitivity on @@ -3543,8 +3563,10 @@ .B GOTCHAS. .IP \(bu 4 -This program has not been tested on MacOS. Please let us know how/if -it works there and any issues you discover. +This program has not been tested on MacOS. It has been reported that +Python on MacOS X returns \'posix\' as its OS name. If true, \*(TW +should work as written, though we've not verified this. Please let us +know how/if it works there and any issues you discover. .SH INSTALLING \*(TW