diff --git a/twander.1 b/twander.1 index 60eb559..46d3dde 100644 --- a/twander.1 +++ b/twander.1 @@ -32,6 +32,12 @@ Specify the location and name of the configuration file. (default is ~/.twander) +If this file does not exist or cannot be opened, \'twander\' will +display a warning to that effect but continue to run. This is +reasonable behavior because \'twander\' provides a command to reload +the configuration file without exiting the program (which you would +presumably do after fixing the configuration file problem). + .TP .B -d Start in debug mode. (default: debug off) @@ -67,7 +73,7 @@ Turn off automatic refreshing of directory display. (default: refresh on) -Normally, \'twander\' re-reads and displays the current directory +Normally \'twander\' re-reads and displays the current directory every few seconds to reflect any changes that might have occured to that directory's contents. This option is useful on slow machines (or slow X connections) and/or when working with very large directories. @@ -163,7 +169,7 @@ .SS GENERAL PROGRAM COMMANDS -This family of commands controls the operation of \'twander\' itself: +This family of commands controls the operation of \'twander\' itself. .TP .B Quit Program @@ -262,7 +268,7 @@ .SS SELECTION KEYS This family of commands controls the selection of one or more (or no) -items in the current directory: +items in the current directory. .TP .B Select All Items @@ -301,6 +307,17 @@ Select first item in the directory. This will always be the ".." entry, but it is a quick way to get to the first part of a very long directory listing which does not all fit on-screen. +.PP + +The mouse can also be used to select one or more items. A +single-click of the left mouse button selects a particular item. +Clicking and dragging selects an adjacent group of items. Clicking an +item and then clicking a second item while holding down the "Shift" +key also selects an adjacent group of items. Finally, a group +non-adjacent items can also be selected. The first item is selected +with a single left mouse button click as usual. Each subsequent +(non-adjacent) item is then selected by holding down the "Control" +key when clicking on the item. .SS SCROLLING COMMANDS @@ -362,6 +379,9 @@ the \'notepad\' program (unless the association for ".txt" has been changed). +If \'twander\' determines that it is running on neither a Unix-like +or Win32 system, double-clicking on a file does nothing. + .TP .B Run User-Defined Command User-Defined (Single Letter) Key @@ -421,11 +441,31 @@ directories selected in the program GUI. By default, the program expects to find configuration information in -.B ~/.twander +.B $HOME/.twander but you can override this with the .B -c command line option. +Actually, \'twander\' can look in a number +of places to find its configuration file. It does this using +the following scheme (in priority order): + +.IP +If the -c argument was given on the command line, +use this argument for a configuration file. + +.IP +If -c was not given on the command line, but the HOME +environment variable is set, look for the a configuration +file as $HOME/.twander. + +.IP +If the HOME environment variable is not set +.B and +a -c command line argument was not provided, look +for a file called ".twander" in the directory from which +\'twander\' was invoked. + .SH CONFIGURATION FILE FORMAT