wguiwide.gml

开放源码的编译器open watcom 1.6.0版的源代码

.endstep
.*
.section Making Targets
.*
.np
.ix '&ide' 'making a target'
.ix 'making a target'
The Make function in the Targets menu creates an executable for the
selected target. When you perform this function, the &vip compiles the
source files for the selected target into object files. The object
files are then linked together to create the target file.
.np
There are two make functions available to you for targets: Make and
Make All. The Make All function in the Actions menu tells the &vip to
compile and link all of the targets for the current project. This can
be a lengthy process, depending upon the number of targets in your
project, so you may choose to only make targets to which changes have
been made. This enables you to see if they can be made successfully.
.np
Performing the Make function opens the &vip Log window which allows you
to monitor the progress of the make.
.begstep To make a single target:
.step Click once on the target window
you want to make to select it.
.result
The title bar of the selected target window is highlighted.
.step Choose Make
from the Targets menu.
.result
The &vip Log window opens along the bottom of the &company &vip Project
window. In the log window you can monitor the make procedure.
.us Execution Complete
appears in the &vip Log window when the make is completed on the
selected target. If the make is successful an executable file for the
selected target can be found in the directory associated with the
target window.
.figure *depth='3.78' *scale=60 *file='ide18' Use the &vip Log window to monitor the make procedure.
.endstep
.begstep To make all targets for the current project:
.step Choose Make All
from the Actions Menu.
.result
The &vip Log window opens along the bottom of the &company &vip Project
window. In the log window you can monitor the make procedure.
.us Execution Complete
appears in the &vip Log window when the make is completed on the
targets. If the make is successful an executable file for each target
in the project can be found in the directory associated with the
target window.
.endstep
.*
.beglevel
.*
.section Viewing the Make Command for a Target
.*
.np
.ix '&ide' 'viewing make commands'
.ix 'viewing make commands'
With the &vip you can use the Show Make Command function to display the
makefile commands for the selected target. These are the commands that
will be used to compile the selected target when you choose the
function Make from the Targets menu or Make All from the Actions menu.
.begstep To view the make commands for targets:
.step Click once on the target window
whose makefile commands you want to view.
.result
The title bar of the selected target window is highlighted.
.step Choose Target Options
from the Targets menu.
.result
A submenu appears on the screen from the Target Options menu.
.step Choose Show Make Command
from the Target Options submenu.
.result
The Target Command dialog appears on the screen. This dialog
displays the makefile commands for the selected target.
.figure *depth='2.45' *scale=81 *file='ide19' The Target Command dialog displays the makefile commands for the selected target.
.step Click on OK
to close the dialog.
.endstep
.*
.endlevel
.*
.section Running a Target
.*
.np
.ix '&ide' 'running a target'
.ix 'running a target'
Once you have compiled and linked your target using the Make function,
you can run the target to execute the program.
.begstep To run a target:
.step Click once on the target window
you want to run.
.result
The title bar of the selected target window is highlighted.
.step Choose Run
from the Targets menu.
.result
The &vip executes the target program.
.figure *depth='3.14' *scale=63 *file='ide20' Run from the Targets menu runs the target.
.endstep
.*
.beglevel
.*
.section Other Run Functions
.*
.np
.ix '&ide' 'running programs'
.ix 'running programs'
In the &wide you can run programs other than the targets in your
current project window. Use the run functions in the Actions menu to
specify the program you want to run. The Run item runs the specified
program under your host environment. The Run Batch item runs the
specified program in the &vip Log window.
.begstep To run other programs in the &vip:
.step Choose Run
from the Actions menu.
.orstep Choose Run Batch
from the Actions menu.
.result
A Run or Run Batch dialog appears on the screen. These dialogs are
identical.
.figure *depth='1.32' *scale=100 *file='ide21' Use the Run (or Run Batch) dialog to run other programs in the &vip..
.step Enter the name of the program
you want to run in the Command field.
.step Click on OK
to run the specified program.
.result
The dialog closes and the specified program runs, either under the
host environment or in the &vip Log window.
.endstep
.*
.endlevel
.*
.section Setting Application Parameters
.*
.np
.ix '&ide' 'setting options'
.ix 'setting options'
The Targets and Sources menus and their submenus are divided into
sections. Horizontal lines separate each section. The menu items in
the bottom sections of the Targets and Sources menus are actions that
you can perform on the selected target or source file in the current
project. If there are switches that can be set for these actions,
there are corresponding menu item entries in the bottom sections of
the submenus. Choose Target Options and Source Options from their
respective menus to display the submenus.
.*
.endlevel
.*
.section Working with Source Files
.*
.np
.ix '&ide' 'source files'
.ix 'source files'
Once your project has a target you need to add source files to the
target. The procedure for adding a source file to a target is simple.
Once you have source files that make up your target, you can also
change the name of a source file and remove source files. This section
discusses the following topics:
.begbull $compact
.bull
Adding Source Files
.bull
Removing Source Files
.bull
Renaming a Source File
.bull
Marking a Source File for Remake
.bull
Making Source Files
.bull
Viewing Included Files
.endbull
.*
.beglevel
.*
.section Adding Source Files
.*
.np
.ix '&ide' 'adding source files'
.ix 'source files' 'adding'
You add source files to the selected target (the target whose title
bar is currently highlighted) using the Add File(s) dialog. The
current project must have a target in order to use the New Source
function. You have two options when adding source files to a target:
you can either enter the name of a new source file or you can choose
an existing source file. When adding existing source files you can use
the file browser, type sources one at a time into the Add File(s)
dialog, or use wild cards in the Add File(s) dialog. This section
describes all methods for adding source files.
.np
The extension you use with the source file name determines the
compiler that the &vip uses to create the target. For example, the ".c"
extension, invokes the &company C compiler to make the target. You can
specify several different compilers:
.begnote $compact
.note xxx.asm
.ix 'extensions' '.asm'
The ".asm" extension invokes the &asmname..
.note xxx.c
.ix 'extensions' '.c'
The ".c" extension invokes the &company C compiler.
.note xxx.cpp
.ix 'extensions' '.cpp'
The ".cpp" extension invokes the &company C++ compiler.
.note xxx.for
.ix 'extensions' '.for'
The ".for" extension invokes the &company FORTRAN 77 compiler.
.note xxx.hlp
.ix 'extensions' '.hlp'
The ".hlp" extension invokes either the Win16, OS/2, or
Win32 compiler.
.note xxx.rc
.ix 'extensions' '.rc'
The ".rc" extension invokes the &company resource compiler.
.note xxx.res
.ix 'extensions' '.res'
The ".res" extension invokes the &company Resource Editor.
.note xxx.sqc
.ix 'extensions' '.sqc'
The ".sqc" extension invokes the embedded SQL preprocessor and the
&company C compiler.
.note xxx.sqp
.ix 'extensions' '.sqp'
The ".sqp" extension invokes the embedded SQL preprocessor and the
&company C++ compiler.
.endnote
.*
.begstep To add new source files to the selected target:
.step Choose New Source
from the Sources menu.
.result
The Add File(s) dialog appears where you specify the name(s) of the
source file(s) you are adding. Source names must be filenames with
extensions; pathnames are not required.
.np
For the OS/2 &vip, you can add multiple source files to the target at
one time by inserting a space between each filename you enter into
the filenames field.
.np
For all other systems, you can enter the names of the source files
(with extensions) in the File Name field, one at a time. Once you have
typed a name in the File Name field, you can add it to the list of
source files to be included by clicking the Add button. Individual
names can be removed from the "add" list by selecting them and
clicking the Remove button.
.figure *depth='4.86' *scale=90 *file='ide22' Add one or several source files to a target using the Add File(s) dialog.
.step Enter the source file name(s).
.np
For the OS/2 &vip, enter all the names into the field separating each
name by a space. Click on OK when done.
.np
For all other systems, enter one name at a time into the File Name
field, pressing Enter or clicking on Add after each one has been
entered.
Click on Close when done.
.np
The Add File(s) dialog closes and the selected source file(s) appear
in the selected target window on the &company &vip Project window.
.np
The source files are grouped by their file extensions and appear in
alphabetical order. You can expand and collapse the list of source
files by clicking on the folder icon to the left of the header.
.endstep
.*
.begstep To add existing source files to the selected target using the file browser:
.step Choose New Source
from the Sources menu.
.result
The Add File(s) dialog appears on the screen.
.np
For the OS/2 &vip, click on the Browse button and the Pick Filename
dialog appears on the screen. This dialog allows you to browse the
directories and files and select the source file(s) you want to add to
the current target. Click on the desired source file to select it.
The selected source file(s) appear highlighted in the Pick Filename
dialog.
When done browsing files, click on OPEN to add the selected files. The
Pick Filename dialog closes. When done selecting files, click on OK.
.np
For all other systems, you can use the file browser to select files.
The type of files displayed in file list window can be controlled by
modifying the List Files of Type field. Once you have selected a name
from the file list, you can add it to the list of source files to be
included by clicking the Add button. All files in the file list can be
added by clicking the Add All button. Individual names can be removed
from the "add" list by selecting them and clicking the Remove button.
When done, click on Close to add the selected files.
.np
The Add File(s) dialog closes and the selected source file(s) appear
in the selected target window on the &company &vip Project window.
.np
The source files are grouped by their file extensions and appear in
alphabetical order. You can expand and collapse the list of source
files by clicking on the folder icon to the left of the header.
.endstep
.*
.begstep To add existing source files to the selected target using wild cards:
.step Choose New Source
from the Sources menu.
.result
The Add File(s) dialog appears on the screen.
.np
For the OS/2 &vip, enter the source file name pattern in the
filename(s) field using wild cards. For example, enter
.fi sou*.c
to add all source files whose name begins "sou" and have a ".c"
extension to the current target. When done, click on OK to add the
selected files.
.hint
Even when entering wild cards, you can add multiple source file groups
by separating each entry with one space (e.g., sou*.c sou*.cpp).
.ehint
.np
For all other systems, enter the source file name pattern in the File
Name field using wild cards. For example, enter
.fi sou*.c
to select all source files whose name begins "sou" and have a ".c"
extension. Click on the Add All button to add all the names that match
the wild card pattern. Individual names can be removed from the "add"
list by selecting them and clicking the Remove button.
When done, click on Close to add the selected files.
.np
The Add File(s) dialog closes and the selected source file(s) appear
in the selected target window on the &company &vip Project window.
.np
The source files are grouped by their file extensions and appear in
alphabetical order. You can expand and collapse the list of source
files by clicking on the folder icon to the left of the header.
.endstep
.*
.section Removing a Source File
.*
.np
.ix '&ide' 'removing source files'
.ix 'source files' 'removing'
The procedure for removing a source file from a project is simple. You
can remove one source at a time or you can remove all source files
with a common file extension from the target. Removing a source file
does not permanently delete the it. The &vip simply removes it from the
current target. If the removed source file is common to multiple
targets, the other targets will not be affected by the removal of the
selected source file.
.begstep To remove one source file from a target:
.step Click once on the source file
you want to remove from the target.
.result
The selected source file appears highlighted in the target window.
.step Choose Remove Source
from the Sources menu.
.result
A message box appears asking if you are sure you want to remove the
selected source file.
.step Click on the Yes button.
.result
The message box closes and the &vip removes the selected source file
from the target window.
.endstep
.begstep To remove a group of source files from a target:
.step Click once on the header
to the right of the folder icon of the source files group you want to
remove from the target.
.result