wguiwide.gml

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

.begnote
.note Important:
You can have only one project open at a time in the &vip.. If you
attempt to open or create a project while one already exists in the
&vip window, a message box appears informing you that the &vip is
closing the current project and asks if you want to save any changes
made to that project. Choose Yes, No, or Cancel in this box to
continue.
.endnote
.*
.beglevel
.*
.section Opening a Project
.*
.ix '&ide' 'opening a project'
.ix 'opening a project'
.begstep To create a new project:
.ix 'new project'
.step Choose New Project
from the File menu.
.result
The Enter Project Filename dialog appears on the screen where you
enter the name of the project you are creating.
.step Enter the desired name
in the File Name field and choose the desired directory.
.result
All projects must have the extension ".wpj".
.figure *depth='3.11' *scale=84 *file='ide11' Use the Enter Project Filename dialog to create a new project.
.step Click on OK
when completed.
.result
The Enter Project Filename dialog closes and the new project name
appears in the title bar of the &company &vip Project window. A New
Target dialog opens on the screen where you add a target to the new
project. Refer to the section Adding a Target for more information.
.endstep
.begstep To open an existing project:
.ix 'open project'
.step Choose Open Project
from the File menu.
.result
The Open dialog appears on the screen where you select the project you
want to open.
.figure *depth='3.11' *scale=84 *file='ide12' Use the Open dialog to open an existing project.
.step Choose the desired project.
.result
All projects have the extension ".wpj".
.step Click on OK
when the desired project appears in the File Name field.
.result
The Open dialog closes and the name of the selected project appears in
the title bar of the &company &vip Project window. If targets exist for
the selected project, windows representing the targets appear in the
main window.
.endstep
.*
.section Closing a Project
.*
.ix '&ide' 'closing a project'
.ix 'closing a project'
.ix 'close project'
.begstep To close the current project:
.step Choose Close Project
from the File menu.
.result
The &vip removes all target windows for the current project from the
&company &vip Project window. The project name disappears from the title
bar and the window is empty.
.endstep
.*
.section Saving a Project
.*
.np
.ix '&ide' 'saving a project'
.ix 'saving a project'
There are two ways of saving your current project. You can perform a
simple save where the project is updated with any changes made since
the last save or you can save the project under a different project
name using the Save Project As function.
.*
.beglevel
.*
.section Updating the Project
.*
.ix '&ide' 'updating a project'
.ix 'updating a project'
.ix 'save project'
.begstep To perform a simple save on your project:
.step Choose Save Project
from the File menu.
.result
The &vip updates the project specified in the title bar. The status bar
along the bottom of the window indicates that the save function is
being executed.
.endstep
.*
.section Saving the Project Under a New Name
.*
.ix '&ide' 'saving a project under a new name'
.ix 'saving a project under a new name'
.ix 'save project as'
.begstep To save the current project using a different name:
.step Choose Save Project As
from the File menu.
.result
The Save As dialog appears on the screen where you specify the file
name by which you want to save the current project.
.step Enter the desired project name
in the File Name field.
.result
This is the new name by which you want to save the current project.
This can be the name of a new project or an existing project.
.begnote
.note Important:
Entering the name of an existing project overwrites the contents of
that project with the contents of the current project.
.endnote
.step Choose the desired directory
for the project using the Directories list on the Save As dialog.
.step Click on OK
when completed.
.result
The Save As dialog closes and the new project name appears in the
title bar of the &company &vip Project window.
.endstep
.*
.endlevel
.*
.endlevel
.*
.section Working with Targets
.*
.np
.ix '&ide' 'targets'
.ix 'targets'
Once you have created a project, it is a simple matter to add
additional targets. You can also change the name of a target, remove
targets, change the target environment, and change the image type.
This section discusses the following topics:
.begbull $compact
.bull
Adding a Target
.bull
Minimizing a Target
.bull
Removing a Target
.bull
Renaming a Target
.bull
Marking a Target for Remake
.bull
Making Targets
.bull
Running a Target
.endbull
.*
.beglevel
.*
.section Adding a Target
.*
.np
.ix '&ide' 'adding a target'
.ix 'targets' 'adding'
You add targets to the current project using the New Target dialog.
When you create a new project, this dialog appears automatically. You
have two options when adding targets to a project: you can either
enter the name of a new target or you can choose an existing target,
previously created in another project. This section describes both
methods for adding a target.
.begstep To add a new target to the current project:
.step Choose New Target
from the Targets menu.
.result
The New Target dialog appears on the screen where you enter the
details of the target you are adding.
.figure *depth='3.24' *scale=64 *file='ide13' Enter the new target details in the New Target dialog.
.step Enter the target name
in the Target Name field.
.result
Enter the entire pathname to ensure the directory is created where you
want.
Depending on the nature of the target, it may or may not be able to
share the same directory as other pre-existing targets.
Generally, if the target shares one or more of the same source files as
other targets in the project, then it must be placed in its own
subdirectory.
The object files that are produced for the target may have different
attributes than a pre-existing target's object files (e.g., 16-bit vs
32-bit).
This is why the target should be placed in a separate subdirectory.
.step Select the desired Target Environment and Image Type
as desired.
.step Click on OK
when the Target Name, Target Environment and Image Type fields are
correct.
.result
If you specify a new directory in the target pathname, a message box
appears asking if you want to create the specified directory. Choose
Yes or No to continue. A window representing the new target appears on
the &company &vip Project window. The target name appears in the title
bar.
.np
The first line in this window describes the target. It specifies the
current mode, the target type. The current mode is represented by
either the letter D or R which appears in parentheses in front of the
target type. The letter D indicates that the target is placed in
Development mode. The letter R indicates that the target is placed in
Release mode. The rest of the window displays the source files for the
target.
.endstep
.figure *depth='3.78' *scale=60 *file='ide14' A project may have multiple targets.
.begstep To add an existing target to a current project:
.step Choose New Target
from the Targets menu.
.result
The New Target dialog appears on the screen.
.step Click on the Browse button.
.result
The Enter Target Filename dialog appears on the screen. This dialog
allows you to browse the directories and files and select the ".tgt"
file for the target you want to add.
.figure *depth='3.11' *scale=84 *file='ide15' Choose an existing target from the Pick Target Filename dialog for the current project.
.step Click on the desired target
to select it.
.result
The selected target appears in the File Name field.
.step Click on OK
to process the target selection.
.result
The Enter Target Filename dialog closes.
.step Click on OK
to close the New Target dialog.
.result
A window representing the new target appears on the &company &vip
Project window.
The target name appears in the title bar.
.np
The first line in this window describes the target. It specifies the
current mode and the target type. The current mode is represented by
either the letter D or R which appears in parentheses in front of the
target type. The letter D indicates that the target is placed in
development mode. The letter R indicates that the target is placed in
Release mode. The rest of the window displays the source files for the
target.
.endstep
.*
.section Minimizing a Target
.*
.np
.ix '&ide' 'minimizing a target'
.ix 'minimizing a target'
If you are working with a project that has multiple targets, the
&company &vip Project window can become cluttered. You can tidy your
window by minimizing the target windows that you are not currently
using.
.begstep To minimize a target window:
.step Click on the system box
in the upper left-hand corner of the target window you want to close.
.result
A menu appears listing the functions you can perform on the selected window.
.step Choose Minimize
from the menu.
.result
The selected target window closes and an icon appears along the bottom
of the screen representing that window. The name of the target appears
on or under the icon.
.step Double-click on the icon
to open the target window again.
.endstep
.figure *depth='3.78' *scale=60 *file='ide16' Minimize targets to reduce clutter in the project window.
.*
.section Removing a Target
.*
.np
.ix '&ide' 'removing a target'
.ix 'removing a target'
The procedure for removing a target from a project is simple. If your
project has multiple targets, it is important to ensure that the
target you want to remove is the one selected. Removing a target does
not permanently delete the target, it simply removes it from the
current project. If the target is attached to multiple projects, those
projects will not be affected by the removal of the selected target
from the current project.
.begstep To remove a target from the current project:
.step Click once on the target window
you want to remove from the project.
.result
The title bar of the selected target window is highlighted.
.step Choose Remove Target
from the Targets menu.
.result
A message box appears on the screen asking if you really want to
remove the selected target.
.step Choose OK
to continue.
.result
The message box closes and the selected target window disappears from
the &company &vip Project window.
.endstep
.*
.section Renaming a Target
.*
.np
.ix '&ide' 'renaming a target'
.ix 'renaming a target'
When renaming a target, you can either give it a new name or you can
give it the name of an existing target. Choosing an existing target
name overwrites the contents of the existing target with the contents
of the current target.
.begstep To rename a target:
.step Click once on the target window
you want to rename.
.result
The title bar of the selected target window is highlighted.
.step Choose Rename Target
from the Targets menu.
.result
The Rename Target dialog appears.
The Target Name, Target Environment, and Image Type of the selected
target appear in the appropriate fields.
.figure *depth='3.24' *scale=64 *file='ide17' Change a target's name using the Rename Target dialog.
.step Enter the new target name
in the Target Name field.
.orstep Click on the Browse button
and select an existing target name; click on OK when completed.
.result
The selected or entered target name appears in the Target Name field.
.step Verify that the Target Environment and Image Type are correct.
.step Click on OK
on the Rename Target window.
.result
The Rename Target dialog closes. The title bar of the selected target
window now displays the new target name.
.endstep
.*
.section Marking a Target for Remake
.*
.np
.ix '&ide' 'marking a target'
.ix 'marking a target'
Marking a target for remake ensures that the &vip will perform the link
the next time you make that target or make all targets. This function
is necessary if you are not using the Autodepend function in the Setup
Target submenu under the Targets menu. By marking a target for remake,
you control when and which targets need to be remade.
.begstep To mark a target for remake:
.step Click once on the target window
you want to mark.
.result
The title bar of the selected target window is highlighted.
.step Choose Mark Target for Remake
from the Targets menu.
.result
A message box appears asking if you want to also mark all of the
source files of the selected target.
.step Choose Yes or No
to continue.
.result
Choosing Yes marks all of the source files for the selected target as
well as the target itself. This means that the next time you do a
make, the source files for the selected target will be compiled.
Choosing No marks only the selected target for remake. In both cases,
the message box closes and you return to the &company &vip Project
window.