Programmer's WorkBench (pwb.hlp) (
Table of Contents;
Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software,
purely for historical purposes.
If you're looking for up-to-date documentation, particularly for programming,
you should not rely on the information found here, as it will be woefully
out of date.
User Switch
◄Example► ◄Up► ◄Contents► ◄Index► ◄Back►
─────Programmer's WorkBench─────────────────────────────────────────────────
User (Text)
The User switch adds a custom menu item to the PWB Run menu.
See: ◄Run menu, Customize Run Menu►
Syntax:
User: title,path,[arg],[out],[dir],[help],[prompt],[ask],[back],[key]
If any argument to the User switch contains spaces, it must be
enclosed in double quotation marks.
<title> Menu title for the program to be added. No other
command can have the same title.
Prefix the character to be highlighted as the access
key with a tilde ('~') or ampersand ('&'). If you do
not specify an access key, the first letter of the
title is used.
<path> Full path of the program.
If the program is on the PATH environment variable,
you can specify just the filename of the program.
<arg> Command-line arguments for the program.
To pass the name of the current file to the program,
specify '%s' in the command line.
See: ◄Filename-Parts Syntax►
Default: No arguments
<out> Name of a file to store program output. If no file is
specified and the program is run in the foreground,
the current file in PWB receives the output.
Default: No output file
<dir> Current directory for the program.
Default: PWB's current directory
<help> Text that appears on the status bar when the menu item
is selected.
Default: No help text
<prompt> Determines if PWB prompts for command-line arguments.
The value of <arg> is the Default response.
Specify "Y" to prompt, or any other character to run
the program without prompting for arguments.
Default: No prompt
<ask> Determines if PWB is to prompt for a keystroke before
returning to PWB.
Specify "Y" to prompt, or any other character to
return to PWB immediately after running the program.
Default: Return without prompting
<back> Determines if the program is run in the background
under a multithreaded environment.
Specify "Y" to run the program in the background, or
any other character to run it in the foreground. If
you run the program in the background, you must also
specify <output>.
Default: Run the program in the foreground
NOTE: Do not run programs which use the screen in the
background. The program's use of the screen
conflicts with PWB's use of the screen and
unpredictable behavior will result. Run programs
such as QuickHelp or a word processor in the
foreground.
<key> A single digit from 1 to 9, specifying a key from
ALT+F1 to ALT+F9 as the shortcut key for the command.
Default: No shortcut key
Default
By Default, no custom menu commands are defined.
See
Usercmd
◄_pwbuser<n>►
See
Printcmd
◄File menu, Print►
◄Run menu, Run DOS Command►
-♦-