diff --git a/twander.1 b/twander.1 index 39812b6..c85a125 100644 --- a/twander.1 +++ b/twander.1 @@ -230,7 +230,7 @@ Program name and version number. .IP \(bu 4 -Login name and domain of current user. +Login name and machine/domain of current user. .IP \(bu 4 The path of the directory you are currently viewing. If @@ -244,10 +244,15 @@ the filter, you will see the word "NOT" before the filter string. .IP \(bu 4 -The total number of files in this directory. +An indication of whether or not "dotfiles" are currently hidden. .IP \(bu 4 -The total size of all the files in this directory. +The total number of files in this directory. The ".." entry is +not included in this count. + +.IP \(bu 4 +The total size of all the files in this directory. The size of the ".." +directory is not included in this total. .IP \(bu 4 They key used to sort the display. If a reverse sort is @@ -1251,6 +1256,60 @@ to edit the wildcard before actually doing another wildcard filter or selection. This allows use to modify previous wildcards for new use. +.SS Hiding Dotfiles + +By convention on Unix and many other systems, files or directories +whose names begin with a dot ('.') are usually used as configuration +files (directories). Unless you specifically want to edit a +configuration, you typically do little or nothing with these files. +Since there can be quite a few of them on a modern system, it's +helpful to be able to block them from view. + +By default, dotfiles are not hidden, but this can be changed with +the HIDEDOTFILES configuration option. + +By default, files or directories whose names begin with a period (".") +are considered dotfiles. You can change this dotfile "introducer" +string with the DOTFILE configuration option. + +.TP +.B Toggle Dotfile Hiding (TOGHIDEDOT) +Control-9 + +This toggles dotfile hiding, on- and off. The program starts up +with dotfiles visible or hidden as defined by the HIDEDOTFILES +program option. Thereafter, TOGHIDEDOT can be used to make +these files and directories visible or not. + +.P +Unlike Wildcard Filters (which test the entire displayed line), +dotfile hiding is triggered only by the +.B name +of the file or directory. + +If you change DOTFILE to some other string, be aware that the test to +see if a file (or directory) name starts with this string is +.B case-sensitive. +If you set DOTFILE to "De", it will not hide files starting with "de", +for example. + +The current state of dotfile hiding is displayed in the window title +bar, immediately after the Filter information. + +Note that even though you cannot see the files with this option +enabled, commands you write can still operate on these files. For +example, if you define a command that does something like: + +.ft C \" courier +.nf + c cleandot rm .*~ +.fi +.ft \" revert + + +This command will remove any backup (~) files, whether or not you can +see them in the interface. + .SH MENU OPTIONS @@ -1894,6 +1953,28 @@ characters, \fC[ ]{ }\fP since these are used as delimiters in the \fCtwander\fP configuration language. + +.TP +.B DOTFILE [String] (.) + +It is a convention on Unix (and other systems) that files or +directories whose names begin with a period are program configuration +files (directories). \fCtwander\fP has the ability to hide these +so-called "dotfiles". (See the section above entitled +.B Hiding Dotfiles +for the details.) \fCtwander\fP treats any file or directory whose +name begins with the string defined by DOTFILE as a dotfile for this +purpose. + +For example, if you set \fCDOTFILE=Xyz\fP, all files or +directories whose names begin with "Xyz", will be hidden when you +tell \fCtwander\fP to hide dotfiles. Notice that if you change this +option from its default, you may use any string to be the dotfile +"introducer", but it is always treated with case-sensitivity. For +instance, in our example, files beginning with "XYZ" would not be +hidden. + + .TP .B FCOLOR [String] (green) @@ -1967,6 +2048,17 @@ This selects the help menu Font Weight. + +.TP +.B HIDEDOTFILES [Boolean] (False) + +Sets whether the program hides "dotfiles" by default. (See previous +section entitled +.B Hiding Dotfiles +for the details of this feature.) This value can be toggled with +the TOGHIDEDOT (default: Control-9) key binding. + + .TP .B MAXMENU [Numeric] (32) @@ -4681,4 +4773,4 @@ .ft \" revert .SH DOCUMENT REVISION INFORMATION -$Id: twander.1,v 1.123 2005/02/04 23:37:43 tundra Exp $ \ No newline at end of file +$Id: twander.1,v 1.124 2005/02/17 20:53:01 tundra Exp $ \ No newline at end of file