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.

                                             ◄Up► ◄Contents► ◄Index► ◄Back►
─────Programmer's WorkBench─────────────────────────────────────────────────
 
     The Compile function compiles and builds targets in the project or
     runs external commands, capturing the result of the operation in
     the Build Results window. Under multithreaded environments, the
     commands run in the background.
 
     When the operation is complete, PWB scans the Build Results for
     error messages. To terminate scanning and suppress the summary
     dialog box, press CTRL+BREAK while PWB is scanning the Build
     Results. To permanently turn off scanning and the dialog box, set
     the Msgdialog switch to No. If scanning is turned off, you can
     still browse results using the Error commands on the Project menu.
     See: Msgdialog
          ◄Project menu, Next Error►
          ◄Project menu, Previous Error►
 
     Compile («compile»)
          Displays the status of the current background compile (if any)
          on the status bar.
 
     Arg Compile («arg» «compile»)
          Compiles the current file. This is equivalent to the Compile
          File command on the Project menu. Arg Compile fails if no
          project is open.
          See: _pwbcompile, ◄Project menu, Compile File►
 
     Arg <textarg> Compile («arg» <textarg> «compile»)
          Builds the target specified by <textarg>. This is equivalent
          to Project Build Target. Arg <textarg> Compile fails if no
          project is open.
          See: ◄Project menu, Build Target►
 
          To build the current project, execute Arg "all" Compile.
 
     Arg Meta <textarg> Compile («arg» <textarg> «meta» «compile»)
          Rebuilds the specified target and its dependents.
          See: _pwbrebuild, ◄Project menu, Rebuild All►
 
          This command is equivalent to specifying the NMAKE /a option.
          See: ◄NMAKE Options►
 
          TIP: You can also include NMAKE command-line macro definitions
               in the text you pass to the Compile function.
 
     Arg Meta Compile («arg» «meta» «compile»)
          Aborts the background operation after prompting for
          confirmation. Also clears the queue of pending background
          operations (if any).
 
     Arg Arg <textarg> Compile («arg» «arg» <textarg> «compile»)
          Runs the program or operating-system command specified by
          <textarg>. The output is displayed in the Compile Results
          window.
 
          Under multithreaded environments, the program runs in the
          background and the Build Results window is updated as the
          program executes. Several programs can be queued for
          background execution.
 
          WARNING: Do not use this command to execute an interactive
                   program. The program is able to change the display
                   but may not receive input. To run an interactive
                   program, use the Shell function («shell»).
                   See: Shell
 
     Returns
 
     True:  Operation successfully initiated.
     False: Operation not initiated.
 
     Update
 
     Arg Meta Compile
 
          In PWB 2.00, this is equivalent to the Cancel Build command.
          In PWB 1.x, there is no menu equivalent.
 
     See
 
      _pwbcancelbuild
      ◄Project menu, Cancel Build►
                                    -♦-