+a Display the "attribute" line at the bottom of the screen.
If you don't like to contiuously have the line showing the current file's
attributes, you can switch this off by using the -a switch. As a side
effect, you will be able to use two more screen lines for the file window
display.
-a Don't display the "attribute" line.
+C On CDROM media, files containing data have often all execute
attributes set, so that
wish
tries to execute the file as a shell script when selected for display. By
specifying the
+C
option in conjunction with the
+c
option,
wish
removes internally all execute permission from ordinary files.
-C No execute permission removal is done on regular files.
+c On CDROM's conforming to the
High Sierra
or the
ISO-9660
standard a version number is appended to a regular file's name delimited
by a semicolon. This semicolon is interpreted by the shell as an end of
line delimiter. To get around this behaviour,
wish
escapes the semicolon by placing a backslash in front of the semicolon
if this option is selected.
-c Do not escape the semicolon in CDROM filenames.
+d Try to preserve the current directory when walking through
the directory tree.
-d Don't try to preserve the current directory.
+f Display "virtual" function key labels.
Wish
detects the presence of a Hewlett-Packard-Terminal by the presence
of the "xs"-flag in termcap or the "xhp"-flag in terminfo. If this flag is
not present,
wish
emulates the function key labels in the last line of the
screen. If this behaviour is not desired, use the -f switch to run
wish
without emulated function key labels.
-f Don't Display "virtual" function key labels.
+l Enable the detection and display of symbolic links. This option
only makes sense if the "attributes" line is displayed.
-l Disable the detection and display of symbolic links.
+n Enable display of filenames starting with a dot.
-n Disable display of filenames starting with a dot.
+p Display the current directory as "." in the file window
of the screen. Usually the first file displayed in the file window is the
"..", the directory above the current directory. This is convenient for
easy walking through the directory tree. Although the current directory,
".", is not displayed, it is present and included in the entry count in
the upper right corner of the file window. If you wish to display the
current directory too, use the +p switch to turn this option on.
-p Don't display the current directory as ".".
+r Wait for pressing RETURN after executing an external
command.
-r Don't wait for pressing RETURN after executing an external
command.
+w Enable the processing of wildcard filenames for file display.
The wildcard specification must be entered using the
.wishrc
file option "wildcard=" or by using
wish's
configuration screen.
-w Disable the processing of wildcard filenames.
-? Displays current version of
wish
and copyright and usage
information.
The next line in this window is the the command line, displaying the current history line number as it's prompt. One can cycle through the command line history by using the popular emacs control sequences. Any alphanumeric input typed at the keyboard is displayed here and executed by the users shell (system(3)) after pressing <return>.
With the cursor keys, the user moves a "cursor" or "current file", which is a highlighted bar, over the filenames in the file window. If a file is made the current selected file by placing the cursor on it, various operations can be done on it, i.e. if the file is a directory, and the user hits return, a change to that directory is done. If the file is an executable file, it is either executed as a binary executable or as a shell script. If the file is a data file it is displayed by the selected pager program - more options are available. If there are more files in a directory than fitting into the file window, it can be paged through by using the page up/down function keys.
Files can be marked in the file window and expanded in the commandline by the special wildcard character "%" - so if you mark several files in the file window, and type "rm % <RETURN>" in the commandline, all selected files will be deleted.
The current selected filename can be echoed onto the commandline for further processing by some other commands.
If there are more files in the directory than will fit into the file window, one can move through file window "pages" by using the PAGE UP and PAGE DOWN terminal keys. There is an indicator available in the lower right corner of the file window for telling the user if there is page above "^", a page below "V" or pages above and below "*" available beside the current one.
Backspace - Erases the character left of the cursor.
Delete - Erases the character under the cursor.
Return - Return key handling is dependent of the status of
the commandline:
Commandline contains characters:
The command string entered into the command line is terminated and executed
by handing it to the system() call to execute it.
Commandline is empty:
While you are maneuvering with the highlighting bar through the file
window, you are able to do the most natural commands depending on the
type of file to the current selected (highlighted) file by just
pressing <RETURN>. This means, that if your file is:
* a executable program, it is executed
* a data file, it is displayed using the pager program
* a directory, the current directory is changed to the highlighted one
Delete Char - Erases the character under the cursor.
Control-F - Forward one character on the commandline.
Control-B - Backward one character on the commandline.
Control-P - Previous commandline from history buffer.
Control-N - Next commandline from history buffer.
Control-D - If the commandline is empty, exit
wish.
If the commandline is not empty, delete the character under the cursor.
Control-K - Kill the line on the commandline from the cursor
position to the end of the commandline and place the string into the
kill-buffer. See also key
Control-Y.
Control-Y - Yank text from the kill-buffer (if any) onto the
commandline at the current cursor position. See also key
Control-K.
Control-A - Position the cursor at the beginning of the
commandline.
Control-E - Position the cursor at the endo of the commandline.
Control-L - Refresh display
Alphanumeric Characters Any alphanumeric, non-control character
typed on the keyboard is displayed on the commandline.
Cursor Right - Move the current file one position
to the right. If on the right margin, wrap onto the next line, first position.
If on the lowest right position, wrap to the upper left position.
Cursor Left - Move the current file one position
to the left. If on the left margin, wrap onto the previous line, last position.
If on the upper left position, wrap to the lowest right position.
Cursor Up - Move the current file one position up in the same column.
Cursor Down - Move the current file one position down in the same column.
Cursor Home - Move the current file to the upper left position.
Cursor Home Down - Move the current file to the lower right position.
Next Page - Display the next file window screen (if any).
Previous Page - Display the previous file window screen (if any).
Function Key 1 - Edit the current file with your editor.
This function is also executable by pressing "ESC 1".
Function Key 2 - Echo the current filename onto the commandline.
This function is also executable by pressing "ESC 2".
Function Key 3 - Display the help screen.
This function is also executable by pressing "ESC 3".
Function Key 4 - Enter the
wish
runtime configuration menu screen.
This function is also executable by pressing "ESC 4".
Function Key 5 - Mark the current filename. The current filename advances
one position to the right. [KEY_F(5)]
This function is also executable by pressing "ESC 5".
Function Key 6 - Unmark all marked filenames.
This function is also executable by pressing "ESC 6".
Function Key 7 - No function.
This function is also executable by pressing "ESC 7".
Function Key 8 - Close the current directory and open the the next
upper directory (this has the same effect as executing "cd .." on the commandline.
This function is also executable by pressing "ESC 8".
If wildcard processing is in effect, the label Entries in the upper right corner of the file window is replaced by the label Matches.
Filename wildcard processing affect all types of files with the exception of directories, which are always displayed.
Boolean Variables can be set/reset by using the stings "on" or "off"
after the variable name and an equal sign.
attributes - Enable/disable attribute line display
preserve - Enable/disable preserve directory
fkeys - Enable/disable virtual function key label display
links - Enable/disable link detection and display
point - Enable/disable display of the current directory in the file
window as "." (dot).
return - Enable/disable wait for pressing <RETURN> after a external
command is executed.
wildenable - Enable/disable wildcard filename processing.
cdrom - Enable/disable CDROM semicolon in filename processing.
cdnoprog - Enable/disable CDROM removal of execute permissions.
dotnames - Enable/disable the display of filenames starting with a dot.
pager - the partial or full filename of the program to be used as
the pager program.
editor - the partial or full filename of the program to be used as
the editor program.
wildcard - specify a wildcard expression to be used for selecting
filenames to be displayed in the file window.
delimiter - the delimiter character to be used to delimit the command
and the the attribute window from the file window.
You can leave the configuration menu by pressing CONTROL-D.
Pressing SPACE toggles a the value of a boolean variable.
A wildcard string can be entered by moving the curser onto the Wildcard field and pressing <RETURN>, the only editing key available is <BACKSPACE>. Leave the field by pressing <RETURN> again - remember to enable the processing of wildcards by setting the boolean variable WildEnabl to YES.
The variables in the lower half of the screen are just displayed but cannot be changed here. Use the .wishrc configuration file options to change these and restart wish.
HOME - mandatory, the users HOME directory
PAGER - optional, the pager program used to display text files, this
defaults to using "more".
EDITOR - optional, the ditor used for editing files, if this variable
does not exist, the environment variable VISUAL is used, if it also
does not exist, this defaults to "vi".
TERM - mandatory, the users termcap/terminfo entry
All rights are reserved except as explicitly granted by written permission of the author.
Wish is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
See the file COPYING, distributed with wish , for restriction and warranty information
The wildmat(3) library function used by wish to perform all types of wildcard matching was written by Rich $alz <rsalz@bbn.com> in 1986, and posted to Usenet. The version used here was taken from volume 17 of comp.sources.misc.
In contrast to PAM, which runs only on HP's own terminals, wish is curses based and should run on all sorts of terminals, although it was tested just with HP-terminals (HP2392A,HP700/9x) and DEC-terminals (VT100/VT220) and terminal emulators which come with X Windows (xterm, hpterm).
Wish began as a termcap based program on a Microware OS-9/68k machine, moved over to the HP-UX environment to replace PAM (still termcap based) and was then rewritten to use curses.
It is known to compile on OS-9 (using Reimer Mellin's curses library), on HP-UX 7.0, 8.0 and 9.0 using either HP's ANSI-C compiler or GCC from the FSF, on SUN Sparc's running SunOS 4.1 with the System V curses library, and on 386BSD and NetBSD using a SYSV - compatible curses library originally written by Pavel Curtis and enhanced and modified by Zeyd Ben-Halim.