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
                                    -♦-