diff --git a/twander.1 b/twander.1 index eadf8b8..f1915e5 100644 --- a/twander.1 +++ b/twander.1 @@ -1141,7 +1141,7 @@ case-sensitive everywhere else. This is because Windows systems allow case in filenames and attributes, but it is not significant - i.e., The case of a filename or attribute is ignored on Windows systems. You -can control this explicitly with the \fCWILDNOCASE=\fP configuration +can control this explicitly with the \fCWILDNOCASE\fP configuration option. If you set \fCWILDNOCASE=False\fP, it will force all wildcard filters and selections to be case-sensistive. Setting it to \fCTrue\fP makes the wildcarding case-insensitive. This option is @@ -1175,7 +1175,7 @@ This will present you with a dialog to enter your regular expression matching criteria described above. After you enter it, \fCtwander\fP will only display the files that match. The filter is reset (to no -filtering) when you manually referesh the directory (\fCREFRESH\fP) or +filtering) when you manually referesh the directory - with \fCREFRESH\fP (default: Control-l - or change directories. .TP @@ -1261,8 +1261,8 @@ .SS Managing The Size Of Dynamic Menus A number of these menus have "dynamic" content - their content changes -as the program runs. For example, the Directory, History, and -Wildcard menus all keep some sort of "history" of what the program has +as the program runs. For example, the Directory, History, Filter and +Select menus all keep some sort of "history" of what the program has done. Their content thus grows longer as the program is used. On Windows systems, if such menus grow too long to physically fit on @@ -1313,29 +1313,6 @@ be opened for some reason, the Commands Menu will be disabled (grayed out). -.SS Directories Menu (Alt-d) [Shift-Right-Mouse-Button] - -\fCtwander\fP keeps track of every directory visited. The previously -described command to move "Back" one directory allows directory navigation -in reverse traversal order - you can back up to where you started. -However, this feature "throws away" directories as it backs up, sort -of like an "undo" function. - -The "Directories" menu provides a slightly different approach to the -same task. It keeps permanent track of every directory visited and -displays that list in sorted order. This provides another way to move -directly to a previously visited directory without having to manually -navigate to it again, back up to it, or name it explictly using the -Change Directory command. - -Unless MAXMENU is set to 0, the Directory Menu shows the last MAXMENU -directories visited in alphabetically sorted order (unless you change -MAXMENUBUF to be smaller than MAXMENU). "Visited", in this case, is -stretching things a bit. - -The Directory Menu is emptied and grayed out when you press the -CLRHIST key. (default: Control-y) - .SS History Menu (Alt-h) [Shift-Control-Right-Mouse-Button] \fCtwander\fP keeps track of every command you attempt to execute, @@ -1369,6 +1346,29 @@ CLRHIST key. (default: Control-y) +.SS Directories Menu (Alt-d) [Shift-Right-Mouse-Button] + +\fCtwander\fP keeps track of every directory visited. The previously +described command to move "Back" one directory allows directory navigation +in reverse traversal order - you can back up to where you started. +However, this feature "throws away" directories as it backs up, sort +of like an "undo" function. + +The "Directories" menu provides a slightly different approach to the +same task. It keeps permanent track of every directory visited and +displays that list in sorted order. This provides another way to move +directly to a previously visited directory without having to manually +navigate to it again, back up to it, or name it explictly using the +Change Directory command. + +Unless MAXMENU is set to 0, the Directory Menu shows the last MAXMENU +directories visited in alphabetically sorted order (unless you change +MAXMENUBUF to be smaller than MAXMENU). "Visited", in this case, is +stretching things a bit. + +The Directory Menu is emptied and grayed out when you press the +CLRHIST key. (default: Control-y) + .SS Shortcut Menu (Alt-u) [Control-Right-Mouse-Button] This menu provides a way to access any of the Directory Shortcuts @@ -1378,6 +1378,64 @@ directory. On Windows systems using the Win32All extensions, there is also a shortcut to the Drive List View. +.SS Filter Menu (Alt-f) [Alt-Control-Middle-Mouse-Button] + +(Note that on Windows you must press Alt +.B then +Control +.B then +the Middle-Mouse-Button for this to work. Windows appears to care deeply +about keystroke order.) + +This menu provides a list of all previously used filtering "wildcard" +regular expressions. Any regular expressions defined in the +Configuration File (see below) using the "FILTERWILD = " statement will +also appear in this menu. This saves you the tedium of constantly +having to enter complex regular expression syntax every time you +wish to do wildcard-based selections. + +Selecting something from this menu brings up a dialog box which +allows you to edit the selected wildcard before using it. + +Bear in mind that the size of the displayed menu is governed by the +MAXMENU and MAXMENUBUF Configuration File options (see below). i.e., +Only the last MAXMENU number of wildcards are actually displayed on +the menu. + +The Filter Menu is emptied and grayed out when you press the +CLRHIST key. (default: Control-y) This history is +.B not +cleared if the Configuration File is reloaded. + +.SS Select Menu (Alt-l) [Alt-Control-Right-Mouse-Button] + +(Note that on Windows you must press Alt +.B then +Control +.B then +the Right-Mouse-Button for this to work. Windows appears to care deeply +about keystroke order.) + +This menu provides a list of all previously used selection "wildcard" +regular expressions. Any regular expressions defined in the +Configuration File (see below) using the "SELECTWILD = " statement will +also appear in this menu. This saves you the tedium of constantly +having to enter complex regular expression syntax every time you +wish to do wildcard-based selections. + +Selecting something from this menu brings up a dialog box which +allows you to edit the selected wildcard before using it. + +Bear in mind that the size of the displayed menu is governed by the +MAXMENU and MAXMENUBUF Configuration File options (see below). i.e., +Only the last MAXMENU number of wildcards are actually displayed on +the menu. + +The Select Menu is emptied and grayed out when you press the +CLRHIST key. (default: Control-y) This history is +.B not +cleared if the Configuration File is reloaded. + .SS Sorting Menu (Alt-s) [Alt-Shift-Right-Mouse-Button] (Note that on Windows you must press Alt @@ -1398,35 +1456,6 @@ You'll find the currently selected sorting options displayed in the program titlebar. -.SS Wildcard Menu (Alt-w) [Alt-Control-Right-Mouse-Button] - -(Note that on Windows you must press Alt -.B then -Control -.B then -the Right-Mouse-Button for this to work. Windows appears to care deeply -about keystroke order.) - -This menu provides a list of all previously used selection "wildcard" -regular expressions. Any regular expressions defined in the -Configuration File (see below) using the "WILDCARD = " statement will -also appear in this menu. This saves you the tedium of constantly -having to enter complex regular expression syntax every time you -wish to do wildcard-based selections. - -Selecting something from this menu brings up a dialog box which -allows you to edit the selected wildcard before using it. - -Bear in mind that the size of the displayed menu is governed by the -MAXMENU and MAXMENUBUF Configuration File options (see below). i.e., -Only the last MAXMENU number of wildcards are actually displayed on -the menu. - -The Wildcard Menu is emptied and grayed out when you press the -CLRHIST key. (default: Control-y) This history is -.B not -cleared if the Configuration File is reloaded. - .SS Help Menu (Alt-l) [No Mouse Shortcut] This menu provides information about various internal settings of @@ -2491,24 +2520,26 @@ .SS Wildcard Statements As discussed above, \fCtwander\fP 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-define -frequently needed wildcard strings in your Configuration -File using the following statement: +expression-based "wildcard" filtering and selection capabilities via +the FILTERWILD (default: Control-=) and SELWILD (default: Control-\\) +commands. These regular expressions can be complex and tedious to +enter by hand each time you need them. You can pre-define frequently +needed wildcard strings in your Configuration File using the following +statements: .ft C \" courier .nf - WILDCARD = regular-expression-string + WILDFILTER = regular-expression-string + WILDSELECT = regular-expression-string .fi .ft \" revert -This regular expression will then be pre-loaded into the Wildcard Menu -(making it easy to invoke by just clicking on it) when \fCtwander\fP starts. -You may place as many of these as you like in your Configuration File. -(Though the menu will be limited to displaying MAXMENU number of items - -see the section above on Program Option Statements.) +The regular expression will then be pre-loaded into either the Filter +or Select Menus respectively when \fCtwander\fP starts. This makes it +easy to use or modify complex wildcards over and over. You may place +as many of these as you like in your Configuration File. (Though the +menus will be limited to displaying MAXMENU number of items - see the +section above on Program Option Statements.) .SS Variables And Command Definitions @@ -4419,4 +4450,4 @@ .ft \" revert .SH DOCUMENT REVISION INFORMATION -$Id: twander.1,v 1.117 2005/02/03 11:17:14 tundra Exp $ \ No newline at end of file +$Id: twander.1,v 1.118 2005/02/04 08:53:26 tundra Exp $ \ No newline at end of file