wguiwide.gml

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

The selected header appears highlighted in the target window.
.figure *depth='3.78' *scale=60 *file='ide23' Click on the header to remove all source files with a common file extension.
.step Choose Remove Source
from the Sources menu.
.result
A message window appears asking if you want to remove all source files
with the selected file extension.
.step Choose OK
to continue.
.result
The message box closes and the &vip removes the selected group of
source files from the target.
.endstep
.*
.section Renaming a Source File
.*
.np
.ix '&ide' 'renaming source files'
.ix 'source files' 'renaming'
When renaming a source file, you can either give it a new name or you
can give it the name of an existing source file. Choosing an existing
source file name overwrites the contents of that source file with the
contents of the current source file.
.begstep To rename a source file:
.step Click once on the source file
you want to rename.
.result
The selected source file appears highlighted in the target window.
.step Choose Rename Source
from the Sources menu.
.result
The Rename File dialog appears where you enter the new name of the
selected source file.
.np
.figure *depth='3.78' *scale=60 *file='ide24' Use the Rename File dialog to rename the selected source file.
.step Enter the new source file name
in the field.
.orstep Click on the Browse button
and select an existing source file name; click on OK when completed.
.result
The selected or entered source file name appears in the
Rename File dialog.
.step Click on OK
on the Rename File dialog.
.result
The Rename File dialog closes. The target window displays the updated
source file.
.endstep
.*
.section Marking a Source File for Remake
.*
.np
.ix '&ide' 'marking source files for remake'
.ix 'source files' 'marking for remake'
The Mark Source for Remake function in the Sources menu enables you to
mark a source file to ensure that the &vip will recompile it the next
time you make the target. This function is useful because although
changes may not have been made to the selected source file, changes
may have been made to a source file on which the selected source file
depends. This function is necessary if you are not using the
Autodepend function in the Target Options submenu under the Targets
menu. Marking source files for remake gives you control over when and
which source files need to be remade.
.np
With the Mark function you can mark an individual source file or a
group of source files with a common file extension.
.begstep To mark a source file or a group of source files for remake:
.step Click once on the source file
you want to mark.
.orstep Click once on the header
of the group of source files you want to mark.
.result
The selection is highlighted in the target window.
.step Choose Mark Source for Remake
from the Sources menu.
.result
If you selected a group of source files to mark, a message box appears
asking if you want to also mark all of the source files of the
specified extension.
.step Choose Yes
to continue.
.result
The message box disappears and the &vip marks all of the source files
in the selected group to be recompiled.
.endstep
.*
.section Making Source Files
.*
.np
.ix '&ide' 'making source files'
.ix 'source files' 'making'
The Make function in the Sources menu enables you to compile a
selected source file into an object file. You can also perform the
Make function on a group of source files with a common file extension.
.np
Performing the Make function opens the &vip Log window which allows you
to monitor the progress of the make.
.begstep To make source files:
.step Click once on the source file
you want to make.
.orstep Click once on the header
of the group of source files you want to make.
.result
The selected source files are highlighted in the target window.
.step Choose Make
from the Sources 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 source files.
.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 Source File
.*
.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 source file. These are the commands
that will be used to compile the selected source file when you choose
the function Make from the Sources menu.
.begstep To view the make commands for source files:
.step Click once on the source file
whose makefile commands you want to view.
.orstep Click once on the header
of the group of source files whose makefile commands you want to view.
.result
The selected source file or group header is highlighted.
.step Choose Source Options
from the Sources menu.
.result
A submenu appears on the screen from the Source Options menu.
.step Choose Show Make Command
from the Source Options submenu.
.result
The Source Command dialog appears on the screen. This dialog
displays the makefile commands for the selected source file or source
file header.
.figure *depth='1.2' *scale=73 *file='ide25' The &vip Source Command dialog displays the makefile commands for the selected source file(s).
.step Click on OK
to close the dialog.
.endstep
.*
.endlevel
.*
.section Viewing Included Files
.*
.np
.ix '&ide' 'viewing included files list'
.ix 'viewing included files list'
The Included Files function in the Sources menu enables you to select
a source file and view a list of all of the files included by that
source file. This is a list of all files on which the selected source
file depends. From this list you can select included files and edit
them.
.np
Because the selected source file depends on the files in this list, it
is necessary to remake it if changes are made to any of the included
files. If you are using the Autodepend function, the &vip automatically
remakes the source file if any of the included files are modified.
.begstep To view the list of included files:
.step Click on the source file
whose list of included files you want to view.
.result
The selected source file is highlighted in the target window.
.step Choose Included Files
from the Sources menu.
.result
The Files Included dialog appears on the screen. This dialog lists all
source files on which the selected source files depends.
.endstep
.begstep To edit a source file from the File Included dialog:
.step Click once on the source file
in the included files list that you want to edit.
.result
The selected source file is highlighted in the File Included dialog.
.step Click on OK.
.orstep Double-click
on the selected source file.
.result
The Files Included dialog closes and the &vip invokes the appropriate
editor for the selected included file. The editor appears and you can
edit the file. Close the editor when you are finished making the
desired changes to return to the &company &vip Project window.
.endstep
.*
.endlevel
.*
.section Using the &vip Log Window
.*
.np
.ix '&ide' 'using the log window'
.ix 'using the log window'
.ix 'log window' 'using the'
When you compile a target or source file, the &vip Log window appears
along the bottom of the screen. Once this window is open it remains on
your screen until you close the project. However, to maximize your
project window space you can minimize the &vip Log window when it is
not being used.
.np
The Log menu contains three functions that you use in relation to the
&vip Log window. This section discusses the following functions:
.begbull $compact
.bull
Stopping the Make Function
.bull
Getting Help
.bull
Editing the Source File
.bull
Saving the Log
.endbull
.*
.beglevel
.*
.section Stopping the Make Function
.*
.np
.ix '&ide' 'stopping the make'
.ix 'stopping the make'
Choosing to make a source file, target, or all targets can be a
lengthy process. The Stop function in the Log menu gives you the
opportunity to cancel the make function once it has started. This
is a useful function in case you decide that you do not want to
continue with the make.
.begstep To stop the make function:
.step Choose Stop
from the Log menu.
.result
A message box appears asking if it is okay to interrupt the
executing process.
.step Click on OK
to continue.
.result
The message box closes and the &vip stops the make function. The &vip
Log window displays the message
.us Stop Invoked
followed by the message
.us Execution Complete.
.endstep
.*
.section Getting Help
.*
.np
.ix '&ide' 'getting help'
.ix 'getting help'
The Help on Message function in the Log menu gives you access to
on-line help information for the selected error message in the &vip
Log window.
.begstep To reveal help for an error message:
.step Click once on the error message
in the &vip Log window on which you want information.
.result
The selected error message is highlighted in the &vip Log window.
.step Choose Help on Message
from the Log menu.
.result
This opens the Help window. Information on the selected error message
appears in this window.
.step Choose Close
from the system menu on the Help window to cancel the Help facility.
.result
The Help window closes and you return to the &vip Log window.
.endstep
.*
.section Editing the Source File
.*
.np
.ix '&ide' 'editing source'
.ix 'editing source'
.ix 'source files' 'editing'
The Edit File function in the Log menu allows you to select an error
message in the &vip Log window and edit the corresponding source file.
This function invokes the appropriate editor for the source file and
positions your cursor in the source code where the error occurred (if
the error message contained line and column information).
.begstep To edit a source file:
.step Click once on the error message
in the &vip Log window that you want to edit.
.result
The selected error message is highlighted in the &vip Log window.
.step Choose Edit File
from the Log menu.
.orstep Double-click
on the selected error message.
.result
Both of these actions open the appropriate editor. If the &edname
appears and the error message contained column and line details, your
cursor will be positioned at the error in the source code.
.step Make the required changes
to the source file and exit the Editor.
.endstep
.*
.section Saving the Log
.*
.np
.ix '&ide' 'saving the log'
.ix 'saving the log'
The Save Log As function in the Log menu allows you to save the contents
of the Log window into a file.
.begstep To save the log:
.step Choose Save Log As
from the Log menu.
.result
The Save Log As dialog appears where you specify the filename by which you
want to save the contents of the Log window.
.step Enter the desired log name
in the File Name field.
.step Specify the directory
to which you want to save the log.
.step Click on the OK button.
.result
The &vip closes the Save Log As dialog and saves the current log as
specified
.endstep
.*
.endlevel
.*
.section The &vip Switches
.*
.np
.ix '&ide' 'setting switches'
.ix 'setting switches'
.ix 'switches' 'setting'
There are a number of different switches you can set in the &wide..
Switches enables you to change the way the various tools, such as
compilers and linkers, perform their jobs. The switches discussed in
this section are:
.begbull $compact
.bull
Release and Development Switches
.bull
Target and Source File Switches
.bull
The Autodepend Switch
.endbull
.np
This section discusses the different switches available in the &vip and
how you can use them.
.*
.beglevel
.*
.section Using Release and Development Switches
.*
.np
.ix '&ide' 'release switches'
.ix 'release switches'
.ix 'sw