diff --git a/twander.1 b/twander.1 index 5dc0025..334ec08 100644 --- a/twander.1 +++ b/twander.1 @@ -906,6 +906,58 @@ of the currently selected files and directories to the Program Memory desired. +.SS Sorting Options + +\*(TW provides a variety of ways to sort the display. These can be +selected with either a keystroke or from the Sorting Menu (see below). +The meaning of the sort depends on whether or not you are in Drive +List View (see +.B ADVANCED WIN32 FEATURES +below). The table below summarizes the keys associated with +sorting and their meaning in the two possible views: + +.nf + Program + Function Sort Order In Sort Order In +Key Name Normal View Drive List View +--- -------- ------------ --------------- + +Shift-F10 SORTBYNONE No Sort No Sort +Shift-F1 SORTBYPERMS Permissions Label/Share String +Shift-F2 SORTBYLINKS Links Drive Type +Shift-F3 SORTBYOWNER Owner Free Space +Shift-F4 SORTBYGROUP Group Total Space +Shift-F5 SORTBYLENGTH Length Drive Letter +Shift-F6 SORTBYTIME Time Ignored +Shift-F7 SORTBYNAME Name Ignored +Shift-F11 SORTREV Reverse Order Reverse Order +Shift-F12 SORTSEP Separate Dirs Ignored +.fi + +An easy way to remember these is that the function key number +for the primary sort keys corresponds to the column position +of the key in a detailed display. For instance, Shift-F1 +sorts by column 1, Shift-F2 by column 2, and so forth. + +These sorting options are available +.B whether or not details are currently available. +For example, you can toggle details off, but still sort by one of +the now invisible details such as Owner, Length, and so on. + +SORTREV reverses the order of the sort. + +SORTSEP toggles whether or not directories and files should be grouped +separately or displayed in absolute sort order. If enabled, +directories will be displayed first, then files. If the sort is +reversed via SORTREV, and SORTSEP is enabled, the directories will +appear +.B after +the files, sorted by whatever sort key has been chosen. SORTSEP +is not meaningful in Drive List View and is ignored. + +You'll find the currently selected sorting options displayed in the +program titlebar. + .SH MENU OPTIONS @@ -1048,6 +1100,19 @@ CLRHIST key. (default: Control-y) +.SS Sorting Menu (Alt-s) [No Mouse Shortcut] + +This menu provides a way to select any of the available sorting +options. It is context-sensitive and will show entries appropriate to +what kind of "view" the program is currently displaying. That is, it will +show options which make sense for both "normal" view as well as "Drive +List View" (see the +.B ADVANCED WIN32 FEATURES +section below). + +You'll find the currently selected sorting options displayed in the +program titlebar. + .SS Wildcard Menu (Alt-w) [Alt-Control-Right-Mouse-Button] \ @@ -1616,6 +1681,52 @@ display. .TP +.B SORTBYFIELD [String] (Name) + +Specifies which field is to be used as the sort key. May be one of +the fields below under "Sort Key" (case-insensitive). The equivalent +field name for Drive List View (see +.B ADVANCED WIN32 FEATURES +section below) is shown in the second column, however +these may +.B not +be used as arguments for SORTBYFIELD. For example, if you plan to +start the program in Drive List View and want to sort by Drive Type, +use: SORTBYFIELD=Links. + +.nf + Equivalent + Sort Key Drive List View Field + -------- --------------------- + No Sort No Sort + Permissions Label/Share String + Links Drive Type + Owner Free Space + Group Total Space + Length Drive Letter + Time Drive Letter + Name Drive Letter +.fi + +.TP +.B SORTREVERSE [Boolean] (False) + +Specifies whether to reverse the sort order or not. If True and +SORTSEPARATE is also True, then the directory list will appear at the +.B end +of the display in addition to being reverse ordered. + +.TP +.B SORTSEPARATE [Boolean] (True) + +Determines whether directories and files should be separated or +mingled in absolute sort order in the display. By default, they are +separated with directories sorted according to SORTBYFIELD order but +appearing before any files in the display. + +This option is ignored in Drive List View. + +.TP .B STARTDIR [String] (Directory In Which Program Started) This allows you to force a starting directory of your choice no matter @@ -2909,7 +3020,7 @@ .SS Program Starts Very Slowly \*(TW attempts to determine the name of the host on which it is -running at program startup. This is used in the title bar display. +running at program startup. This is used in the titlebar display. It first looks to see if the environment variable HOSTNAME is set, and uses that value if it is. If this variable is not set, \*(TW does a socket call to see if it can determine the hostname that way.