Power GUI Programming with VisualAge C++/powergui.iso/trialva/ibmcppw/help/iwfwcs35.hlp

OS/2 Help File | 1996-02-23 | 42.5 KB | 1,635 lines

ΓòÉΓòÉΓòÉ 1. Project window ΓòÉΓòÉΓòÉ

The Project window is where you manipulate source files and other project
parts, and launch tools that work on particular files or an entire project.

Typically, you interact with the project window by:

  Entering a wildcard pattern or type name in the parts filter entry field, to
   filter the project parts that are displayed at any one time.
  Selecting one or more files, then selecting an item from the popup menu of
   one of the files.
  Selecting an item from the popup menu of the window background.
  Selecting an item from one of the pulldown menus of the window. (Some of the
   entries under the Project and Selected pulldown menus are the same as
   entries on the popup menus.)
  Double-clicking on a project part that is listed in the window.
  Clicking on icons in the toolbar of the window. These icons represent
   frequently accessed features that are also available through menus or other
   controls.

 The output of some tools is displayed in the monitor window. The monitor is an
 editor command shell window. Besides displaying the output of  tools like the
 compiler and linker, the monitor also provides a fast way to correct
 compilation errors. Double-clicking on a compilation error message brings up
 an editor window with the source file, and the line in error highlighted.
 After you correct the error, you can recompile by selecting Compile from the
 Project menu in the monitor window, or by returning to the project window and
 invoking the compiler as you did originally.

 The monitor runs actions sequentially. If the monitor runs an application that
 doesn't return, like a GUI application, then the next monitored action, like a
 build,  will not run. You need to end the first application so that the next
 monitored action can execute.

 Menu-Bar Choices

  Project
  Selected
  Edit
  View
  Options
  Help

 Controls

  Near the top of the window is the project toolbar. A choice under the View
   menu lets you hide the toolbar.
  The Project parts container is where you manipulate the files and other
   parts that make up the project.

   Within this container, you can:

    - Double-click on a project part to run its default action.
    - Select a project part and then select from its popup menu (which is
      displayed by pressing mouse button 2).
    - Press mouse button 2 in the blank area away from the project parts, and
      select from the popup menu for the container itself.

   Selections under the View pulldown menu let you open different views of this
   container:

    - Icon view
    - Tree view

  An information line provides an explanation of  the toolbar buttons as the
   mouse moves over them. The Information line choice under the View menu lets
   you hide the information line.


ΓòÉΓòÉΓòÉ 1.1. Project parts container ΓòÉΓòÉΓòÉ

This region of the project window displays a collection of the files and other
projects that are parts of the current project.

Related information

  This container is part of the project window.
  You filter the contents of this container with the parts filter field on the
   project toolbar. Press the Enter key within this field when changing the
   filter.
  You view different representations of the contents of this container with
   the Icon, Tree choices under the View pulldown menu.
  After selecting one or more project parts in this container, you operate on
   those parts by selecting from the Selected pulldown menu or from the popup
   menu of one of the parts.
  After creating or deleting files, you display the updated contents of the
   container by selecting the Refresh now choice under the View pulldown menu.
  You select directories whose contents are displayed in this container using
   the Directories page of the project settings notebook.


ΓòÉΓòÉΓòÉ 1.2. Project menu ΓòÉΓòÉΓòÉ

Use the entries under this menu to perform operations that affect the whole
project, not just a particular subset of project parts.

This menu consists of a list of all the actions that are project-scoped, based
on their Action applies to setting.

The entries under the Project menu are also available from the background popup
menu within the Project window.

Menu Summary

  Open Project
  Create new project
  Close Project
  Exit WorkFrame


ΓòÉΓòÉΓòÉ 1.2.1. Open project ΓòÉΓòÉΓòÉ

Opens an existing project.

To open a project, you specify the name of the project file. The project file,
with the extension iwp, contains general project information and the project
settings. The project file does not need to be stored in one of its project's
source directories, but it does need to be stored in the same directory as the
project options file.

The project options file, with the file extension iwo, contains the options
settings for the project tools. The project file and options file also need to
have the same name.


ΓòÉΓòÉΓòÉ 1.2.2. Create new project ΓòÉΓòÉΓòÉ

Displays the Project Smarts window where you can create a new project.


ΓòÉΓòÉΓòÉ 1.2.3. Close project ΓòÉΓòÉΓòÉ

Closes the project view, but WorkFrame is not exited.


ΓòÉΓòÉΓòÉ 1.2.4. Exit WorkFrame ΓòÉΓòÉΓòÉ

Closes the project view and exits WorkFrame.


ΓòÉΓòÉΓòÉ 1.3. Selected menu ΓòÉΓòÉΓòÉ

Use the entries under this menu to perform an action on the project parts that
are selected in the project window.

If no project parts are selected, or if no actions apply to all of the selected
parts, this menu has no items. The items vary depending on the actions that
apply to the selected project parts.


ΓòÉΓòÉΓòÉ 1.4. Edit Menu ΓòÉΓòÉΓòÉ

Use the entries under this menu to select or deselect all parts displayed in
the parts container.

Menu Summary

  Select all
  Deselect all


ΓòÉΓòÉΓòÉ 1.4.1. Select All ΓòÉΓòÉΓòÉ

Selects all of the parts in the container.


ΓòÉΓòÉΓòÉ 1.4.2. Deselect All ΓòÉΓòÉΓòÉ

Deselects parts in the container that you selected.


ΓòÉΓòÉΓòÉ 1.5. View Menu ΓòÉΓòÉΓòÉ

Use the entries under this menu to customize the way information is presented
in the project window.

Menu Summary

  Icon
  Tree
  Settings
  Information line
  Toolbar
  Refresh now


ΓòÉΓòÉΓòÉ 1.5.1. Icon view ΓòÉΓòÉΓòÉ

The Icon view lists the project parts as icons.

Related information

  This view is part of the project window.
  Tree view


ΓòÉΓòÉΓòÉ 1.5.2. Tree view ΓòÉΓòÉΓòÉ

The Tree view lists the project parts as a tree structure, with files grouped
according to the directories where they are located.

Related information

  This view is part of the project window.
  Icon view


ΓòÉΓòÉΓòÉ 1.5.3. Settings ΓòÉΓòÉΓòÉ

Use the entries under this cascading menu to take fast paths to commonly
referenced pages in the Project Settings notebook, where you can change various
properties of the project.

Menu Summary

  Target
  Directories
  Environment Variables
  Name


ΓòÉΓòÉΓòÉ 1.5.4. Information line ΓòÉΓòÉΓòÉ

Toggles whether the information line at the bottom of the window is displayed
or hidden. You might not need the information line if you use the View pulldown
menu to change the tool bar to a textual representation or turn on the hover
help for the tool bar.


ΓòÉΓòÉΓòÉ 1.5.5. Toolbar ΓòÉΓòÉΓòÉ

Changes the appearance of any toolbar in this window.

Menu Summary

  Show
  Hover help
  Style


ΓòÉΓòÉΓòÉ 1.5.5.1. Show ΓòÉΓòÉΓòÉ

Selects whether the project toolbar is displayed in the window. Deselect it if
you use the menus or accelerator keys exclusively.


ΓòÉΓòÉΓòÉ 1.5.5.2. Hover help ΓòÉΓòÉΓòÉ

Selects whether or not brief explanations of each toolbar icon are displayed
next to the icon as the mouse moves over the toolbar. Deselect it if you are
familiar with the toolbar icons, if the explanations in the information line
are sufficient, or if the performance overhead of this help slows down your
work.


ΓòÉΓòÉΓòÉ 1.5.5.3. Style ΓòÉΓòÉΓòÉ

Selects whether the tool bar should label its icons with graphics, text, or
both:

Menu Summary

  Graphic and text
  Graphic only
  Text only


ΓòÉΓòÉΓòÉ 1.5.5.4. Graphic and text ΓòÉΓòÉΓòÉ

Displays both a graphic icon and text label for each toolbar item.


ΓòÉΓòÉΓòÉ 1.5.5.5. Graphic only ΓòÉΓòÉΓòÉ

Displays a graphic icon for each toolbar item.


ΓòÉΓòÉΓòÉ 1.5.5.6. Text only ΓòÉΓòÉΓòÉ

Displays a text label for each toolbar item.


ΓòÉΓòÉΓòÉ 1.5.6. Refresh now ΓòÉΓòÉΓòÉ

Displays all the information in the window again. Use this selection if project
parts are created or deleted while a project view is open.


ΓòÉΓòÉΓòÉ 1.6. Options menu ΓòÉΓòÉΓòÉ

Use the entries under this menu to change the options (the runtime parameters
used by the tool) for actions used in the makefile.


ΓòÉΓòÉΓòÉ 1.6.1. Build Smarts ΓòÉΓòÉΓòÉ

The Build Smarts menu item brings up a dialog where you can change the options
for Build Smarts. Build Smarts lets you quickly modify options that affect the
way your project is built.


ΓòÉΓòÉΓòÉ 1.7. Help Menu ΓòÉΓòÉΓòÉ

Use the entries under this menu to get instructions for the WorkFrame graphical
user interface.

Menu Summary

  Help index
  General help
  Using help
  How do I
  Product information


ΓòÉΓòÉΓòÉ 1.7.1. Help index ΓòÉΓòÉΓòÉ

The Help Index menu item launches the index for WorkFrame online help.


ΓòÉΓòÉΓòÉ 1.7.2. General Help ΓòÉΓòÉΓòÉ

The General Help menu item launches the online help for WorkFrame.


ΓòÉΓòÉΓòÉ 1.7.3. Using Help ΓòÉΓòÉΓòÉ

The Using Help menu item launches the help information for using the
Information Presentation Facility (IPF).


ΓòÉΓòÉΓòÉ 1.7.4. How do I Help ΓòÉΓòÉΓòÉ

The How Do I menu item launches the WorkFrame How Do I information. It provides
step-by-step instructions on how to perform tasks using WorkFrame.

Click here to launch the WorkFrame How Do I... information.


ΓòÉΓòÉΓòÉ 1.7.5. VisualAge for C++ Help Menu Items ΓòÉΓòÉΓòÉ

The central portion of the Help PullDown menu is dedicated to all the online
documentation that is shipped with VisualAge for C++. Making a selection from
any of these Cascade menus launches the VisualAge for C++ documentation
associated with the menu item. You can find the same documentation in the
Information notebook found in the VisualAge for C++ Desktop folder.

The Cascade menus are organized as follows:

 At A Glance
           Provides general information about VisualAge for C++, such as
           installing the product, a notebook that accesses the sample
           programs, and answers to frequently asked questions.

 Using VisualAge for C++
           Provides direct access to the individual sections of the User's
           Guide. For example, if you are using the Browser, you would look in
           the Browsing section for more information.

 How Do I... Selections
           Provides access to the How Do I... information for each component of
           VisualAge for C++. Use How Do I... information to find out how to
           perform common tasks within VisualAge for C++.

 C/C++
           Provides access to the information that is specific to programming
           in C and C++.

 Class Libraries
           Provides access to the VisualAge for C++ Open Class Library
           documentation.

 Visual Programming
           Provides access to the information that is specific to creating your
           programs visually.

 IPF, and Editing
           Provides access to the IPF and Editor references.

 SOM
           Provides access to the information specific to SOM.

 Windows Programming
           Provides access to information about programming with the Win32
           Software Development Kit.


ΓòÉΓòÉΓòÉ 1.7.6. Product Information Help ΓòÉΓòÉΓòÉ

The Product Information menu item provides information about this release of
WorkFrame.


ΓòÉΓòÉΓòÉ 1.8. Project toolbar ΓòÉΓòÉΓòÉ

Use the toolbar at the top of the Project window to quickly perform a common
WorkFrame operation; most of these operations can also be selected from menus.

 Build smarts
      Displays the Build smarts window where you can set build features for
      your projects.

 Project Monitor
      Displays the Project Monitor window for the project.

 How Do I?
      Displays the online How Do I? help for WorkFrame.  It contains
      instructions for how to accomplish common WorkFrame tasks.

 In the middle of the toolbar is the parts filter, where you select which
 project parts are displayed in all the open views of the project.

 The right-hand side of the project toolbar also contains buttons for launching
 frequently-used, project-scoped actions like Build, Debug, and Run.

 Related information

  Toolbars choice of View pulldown menu


ΓòÉΓòÉΓòÉ 1.9. Parts filter ΓòÉΓòÉΓòÉ

Enter the file mask or type name that determines which project parts to list in
the project window. To use multiple masks, separate them with a semicolon. You
can also select one of the available types from the dropdown list box.

You must press the Enter key to refresh the contents of the view using the new
filter, and to save the the current setting of the parts filter. It is saved
for all project views.


ΓòÉΓòÉΓòÉ 2. Project settings notebook ΓòÉΓòÉΓòÉ

Use the Project Settings notebook to change various properties of the project.

Pages

  Target defines the names of the target file and makefile.
  Directories defines the source and working directories.
  Environment Variables defines the environment variables.
  Name defines the name of the project.

 Related information

  These settings affect the appearance of the project window.


ΓòÉΓòÉΓòÉ 2.1. Target page ΓòÉΓòÉΓòÉ

Use this page to define the file that is ultimately produced by building the
project, and the name of the makefile that generates the target file.

If the target is an executable file, you can also enter options to be passed to
it at run time as if they were typed on the command line.

Controls

 Name
      Enter the name, including the extension, of the target file that will be
      produced by building the project.

 Run options
      This field only applies when the target file is an executable program.
      Enter any runtime parameters that you want to pass to the target program
      as if they were entered on the command line.

 Makefile
      Enter the name of the makefile to use when building the project. When you
      use MakeMake to generate a makefile for the project, it will save the
      makefile with this name.

      A project can have more than one makefile, for example, one that builds
      the target with debug information and another that builds it optimized,
      but WorkFrame recognizes only one as the designated makefile of the
      project. Makefiles are recognized by having either the name makefile or
      the .mak file extension.

 OK
      The OK button closes the dialog and saves all the changes made to fields
      in the notebook. Close the dialog with this pushbutton rather than with
      the System menu to preserve any changes you have made.

 Cancel
      The Cancel button exits the project notebook without saving changes made
      to fields in the notebook.

 Undo
      The Undo button returns the fields on the page to the value they had when
      the notebook was opened.

 Help
      The Help button displays help for the overall notebook.

 Related information

  This page is part of the project settings notebook.


ΓòÉΓòÉΓòÉ <hidden> Target field ΓòÉΓòÉΓòÉ

Enter the name, including the extension, of the target file that will be
produced by building the project.


ΓòÉΓòÉΓòÉ <hidden> Run options ΓòÉΓòÉΓòÉ

This field only applies when the target file is an executable program. Enter
any runtime parameters that you want to pass to the target program as if they
were entered on the command line.


ΓòÉΓòÉΓòÉ <hidden> Makefile ΓòÉΓòÉΓòÉ

Enter the name of the makefile to use when building the project. When you use
MakeMake to generate a makefile for the project, it will save the makefile with
this name.

A project can have more than one makefile, for example, one that builds the
target with debug information and another that builds it optimized, but
WorkFrame recognizes only one as the designated makefile of the project.
Makefiles are recognized by having either the name makefile or the .mak file
extension.


ΓòÉΓòÉΓòÉ <hidden> Target page ΓòÉΓòÉΓòÉ

Use this page to define the file that is ultimately produced by building the
project, and the name of the makefile that generates the target file.

If the target is an executable file, you can also enter options to be passed to
it at run time as if they were typed on the command line.

Controls

 Name
      Enter the name, including the extension, of the target file that will be
      produced by building the project.

 Run options
      This field only applies when the target file is an executable program.
      Enter any runtime parameters that you want to pass to the target program
      as if they were entered on the command line.

 Makefile
      Enter the name of the makefile to use when building the project. When you
      use MakeMake to generate a makefile for the project, it will save the
      makefile with this name.

      A project can have more than one makefile, for example, one that builds
      the target with debug information and another that builds it optimized,
      but WorkFrame recognizes only one as the designated makefile of the
      project. Makefiles are recognized by having either the name makefile or
      the .mak file extension.

 OK
      The OK button closes the dialog and saves all the changes made to fields
      in the notebook. Close the dialog with this pushbutton rather than with
      the System menu to preserve any changes you have made.

 Cancel
      The Cancel button exits the project notebook without saving changes made
      to fields in the notebook.

 Undo
      The Undo button returns the fields on the page to the value they had when
      the notebook was opened.

 Help
      The Help button displays help for the overall notebook.

 Related information

  This page is part of the project settings notebook.


ΓòÉΓòÉΓòÉ 2.2. Directories page ΓòÉΓòÉΓòÉ

Use this page to specify which directories contain the files that are part of
this project.

Controls

 Source Directories for project files
      Enter the names of one or more directories that contain the files that
      are part of the project.

      If a directory does not exist, a WorkFrame prompt will let you decide
      whether or not to create it. The Yes button will create the directory and
      close the settings notebook. The No button will not create the directory,
      and will also close the settings notebook. Use the Cancel button to
      return to the Directories page of the settings notebook without creating
      the directory.

 Working directory
      After selecting the directories for project files, select one of them as
      the Working directory. This is the directory where output files are
      created except for output files, like a makefile, that have been
      specified with a different path name. When actions are executed, this
      directory is their current directory.

 OK
      The OK button closes the dialog and saves all the changes made to fields
      in the notebook. Close the dialog with this pushbutton rather than with
      the System menu to preserve any changes you have made.

 Cancel
      The Cancel button exits the project notebook without saving changes made
      to fields in the notebook.

 Undo
      The Undo button returns the fields on the page to the value they had when
      the notebook was opened.

 Help
      The Help button displays help for the overall notebook.

 Related information

  This page is part of the project settings notebook.


ΓòÉΓòÉΓòÉ <hidden> Source directories ΓòÉΓòÉΓòÉ

Enter the names of one or more directories that contain the files that are part
of the project.

If a directory does not exist, a WorkFrame prompt will let you decide whether
or not to create it. The Yes button will create the directory and close the
settings notebook. The No button will not create the directory, and will also
close the settings notebook. Use the Cancel button to return to the Directories
page of the settings notebook without creating the directory.


ΓòÉΓòÉΓòÉ <hidden> Working directory ΓòÉΓòÉΓòÉ

After selecting the directories for project files, select one of them as the
Working directory. This is the directory where output files are created except
for output files, like a makefile, that have been specified with a different
directory. When actions are executed, this directory is their current
directory.


ΓòÉΓòÉΓòÉ <hidden> Directories page ΓòÉΓòÉΓòÉ

Use this page to specify which directories contain the files that are part of
this project.

Controls

 Source Directories for project files
      Enter the names of one or more directories that contain the files that
      are part of the project.

      If a directory does not exist, a WorkFrame prompt will let you decide
      whether or not to create it. The Yes button will create the directory and
      close the settings notebook. The No button will not create the directory,
      and will also close the settings notebook. Use the Cancel button to
      return to the Directories page of the settings notebook without creating
      the directory.

 Working directory
      After selecting the directories for project files, select one of them as
      the Working directory. This is the directory where output files are
      created except for output files, like a makefile, that have been
      specified with a different pathname. When actions are executed, this
      directory is their current directory.

 OK
      The OK button closes the dialog and saves all the changes made to fields
      in the notebook. Close the dialog with this pushbutton rather than with
      the System menu to preserve any changes you have made.

 Cancel
      The Cancel button exits the project notebook without saving changes made
      to fields in the notebook.

 Undo
      The Undo button returns the fields on the page to the value they had when
      the notebook was opened.

 Help
      The Help button displays help for the overall notebook.

 Related information

  This page is part of the project settings notebook.


ΓòÉΓòÉΓòÉ 2.3. Environment Variables page ΓòÉΓòÉΓòÉ

Use this page to view and specify the environment variables for the project.
The environment variables defined are active only for your project without
affecting variables set in other sessions. The environment variables are set
for any tool launched from a WorkFrame project.

Controls

 Environment Variables
      Enter the names of one or more environment variables and the values to
      set them to, each variable on a separate line. Use the format name=value,
      where name is the name of the environment variable, and value is the
      value you want the variable set to.

 OK
      The OK button closes the dialog and saves all the changes made to fields
      in the notebook. Close the dialog with this pushbutton rather than with
      the System menu to preserve any changes you have made.

 Cancel
      The Cancel button exits the project notebook without saving changes made
      to fields in the notebook.

 Undo
      The Undo button returns the fields on the page to the value they had when
      the notebook was opened.

 Help
      The Help button displays help for the overall notebook.

 Related information

  This page is part of the project settings notebook.


ΓòÉΓòÉΓòÉ <hidden> Environment variables ΓòÉΓòÉΓòÉ

Enter the names of one or more environment variables and the values to set them
to, each variable on a separate line. Use the format name=value, where name is
the name of the environment variable, and value is the value you want the
variable set to.


ΓòÉΓòÉΓòÉ <hidden> Environment Variables page ΓòÉΓòÉΓòÉ

Use this page to view and specify the environment variables for the project.
The environment variables defined are active only for your project without
affecting variables set in other sessions. The environment variables are set
for any tool launched from a WorkFrame project.

Controls

 Environment Variables
      Enter the names of one or more environment variables and the values to
      set them to, each variable on a separate line. Use the format name=value,
      where name is the name of the environment variable, and value is the
      value you want the variable set to.

 OK
      The OK button closes the dialog and saves all the changes made to fields
      in the notebook. Close the dialog with this pushbutton rather than with
      the System menu to preserve any changes you have made.

 Cancel
      The Cancel button exits the project notebook without saving changes made
      to fields in the notebook.

 Undo
      The Undo button returns the fields on the page to the value they had when
      the notebook was opened.

 Help
      The Help button displays help for the overall notebook.

 Related information

  This page is part of the project settings notebook.


ΓòÉΓòÉΓòÉ 2.4. Name page ΓòÉΓòÉΓòÉ

Use this page to change the name for the project. The name appears in the
project window's title bar.

Controls

 Project Name
      Enter the name of the project.

 OK
      The OK button closes the dialog and saves all the changes made to fields
      in the notebook. Close the dialog with this pushbutton rather than with
      the System menu to preserve any changes you have made.

 Cancel
      The Cancel button exits the project notebook without saving changes made
      to fields in the notebook.

 Undo
      The Undo button returns the fields on the page to the value they had when
      the notebook was opened.

 Help
      The Help button displays help for the overall notebook.

 Related information

  This page is part of the project settings notebook.


ΓòÉΓòÉΓòÉ <hidden> Project name ΓòÉΓòÉΓòÉ

Enter the name of the project. The project name appears in the project window's
title bar.


ΓòÉΓòÉΓòÉ <hidden> Name page ΓòÉΓòÉΓòÉ

Use this page to change the name for the project. The name appears in the
project window's title bar.

Controls

 Project Name
      Enter the name of the project.

 OK
      The OK button closes the dialog and saves all the changes made to fields
      in the notebook. Close the dialog with this pushbutton rather than with
      the System menu to preserve any changes you have made.

 Cancel
      The Cancel button exits the project notebook without saving changes made
      to fields in the notebook.

 Undo
      The Undo button returns the fields on the page to the value they had when
      the notebook was opened.

 Help
      The Help button displays help for the overall notebook.

 Related information

  This page is part of the project settings notebook.


ΓòÉΓòÉΓòÉ <hidden> OK button ΓòÉΓòÉΓòÉ

The OK button closes the dialog and saves all the changes made to fields in the
notebook. Close the dialog with this pushbutton rather than with the System
menu to preserve any changes you have made.


ΓòÉΓòÉΓòÉ <hidden> Cancel button ΓòÉΓòÉΓòÉ

The Cancel button exits the project notebook without saving changes made to
fields in the notebook.


ΓòÉΓòÉΓòÉ <hidden> Undo button ΓòÉΓòÉΓòÉ

The Undo button returns the fields on the page to the value they had when the
notebook was opened.


ΓòÉΓòÉΓòÉ <hidden> Help button ΓòÉΓòÉΓòÉ

The Help button displays help for the overall notebook.


ΓòÉΓòÉΓòÉ 2.5. Delete ΓòÉΓòÉΓòÉ

The Delete menu item brings up a dialog to delete a project part.


ΓòÉΓòÉΓòÉ 2.6. Move ΓòÉΓòÉΓòÉ

The Move menu item brings up a dialog to move a project part.


ΓòÉΓòÉΓòÉ 2.7. Copy ΓòÉΓòÉΓòÉ

The Copy menu item brings up a dialog to copy a project part.


ΓòÉΓòÉΓòÉ 2.8. Copy/Move dialog ΓòÉΓòÉΓòÉ

Use this dialog to copy or move a project part.

Controls

 New filename
      When moving or copying a single part, you can enter a new name. The new
      name is optional if the destination directory does not have a part with
      the same name.

 Target directory
      Enter the name of the destination directory.

 Copy or Move
      Performs the copy or move operation.

 Cancel
      Exits without performing the operation or saving data.

 Help
      Displays this help panel.


ΓòÉΓòÉΓòÉ <hidden> Copy or move button ΓòÉΓòÉΓòÉ

The Copy or Move button performs the copy or move operation.


ΓòÉΓòÉΓòÉ <hidden> Cancel button ΓòÉΓòÉΓòÉ

Exits without performing the operation or saving data.


ΓòÉΓòÉΓòÉ <hidden> Help button ΓòÉΓòÉΓòÉ

Displays this help panel.


ΓòÉΓòÉΓòÉ <hidden> Target directory ΓòÉΓòÉΓòÉ

Enter the name of the destination directory.


ΓòÉΓòÉΓòÉ <hidden> New filename ΓòÉΓòÉΓòÉ

When moving or copying a single part, you can enter a new name. The new name is
optional if the destination directory does not have a part with the same name.


ΓòÉΓòÉΓòÉ <hidden> Tool help ΓòÉΓòÉΓòÉ

For help on this tool, refer to the Using VisualAge for C++ menu item on the
Help menu. This item provides direct access to the individual sections of the
User's Guide.


ΓòÉΓòÉΓòÉ 3. Build Options ΓòÉΓòÉΓòÉ

Use this notebook to set the options used by a Build action. You can customize
the build for speed, efficiency, convenience, and single-user or team
development.

Pages

  Actions
  Make
  Project
  Display

 Controls

 OK (in notebook frame)
      Closes the dialog and saves all the settings. Close the dialog with this
      pushbutton rather than with the System menu to preserve any changes you
      have made.

 Reset (in notebook frame)
      Restores all pages to the same settings as when you opened the dialog.
      The Reset button on each page restores the page to the same settings as
      when you opened the dialog.

 Default (in notebook frame)
      Restores all pages to their default values. The Default button on each
      page restores the pages to the default values.

 Cancel (in notebook frame)
      Exits without performing the operation or saving data. Closing this
      dialog using the System menu has the same effect:  changes are not saved.

 Help (in notebook frame)
      Displays help for the overall dialog. The Help button on each page
      displays help for that page.

 Related information

  You can also run this utility from the command line. Enter IBUILD /? for
   information about the command-line options. IBUILD takes a maximum of nine
   parameters.
  Background information about the Build utility


ΓòÉΓòÉΓòÉ <hidden> Build Options ΓòÉΓòÉΓòÉ

Use this notebook to set the options used by a Build action. You can customize
the build for speed, efficiency, convenience, and single-user or team
development.

Pages

  Actions
  Make
  Project
  Display

 Controls

 OK (in notebook frame)
      Closes the dialog and saves all the settings. Close the dialog with this
      pushbutton rather than with the System menu to preserve any changes you
      have made.

 Reset (in notebook frame)
      Restores all pages to the same settings as when you opened the dialog.
      The Reset button on each page restores the page to the same settings as
      when you opened the dialog.

 Default (in notebook frame)
      Restores all pages to their default values. The Default button on each
      page restores the pages to the default values.

 Cancel (in notebook frame)
      Exits without performing the operation or saving data. Closing this
      dialog using the System menu has the same effect:  changes are not saved.

 Help (in notebook frame)
      Displays help for the overall dialog. The Help button on each page
      displays help for that page.

 Related information

  You can also run this utility from the command line. Enter IBUILD /? for
   information about the command-line options. IBUILD takes a maximum of nine
   parameters.
  Background information about the Build utility


ΓòÉΓòÉΓòÉ 3.1. Actions ΓòÉΓòÉΓòÉ

The settings on this page determine which of the actions in the project are
processed by the build action. You can do partial builds by omitting some
actions.

The choices here override the similar choices you can make in the MakeMake
utility.

Controls

 MakeMake
      Runs the MakeMake utility to produce a new makefile separately from this
      dialog.

 Reset
      Restores the page to the same settings as when you opened the dialog.

 Default
      Sets the fields on the page to the default values.

 Help
      Displays this help panel.

 Related information

  Selecting actions for Build and Make


ΓòÉΓòÉΓòÉ 3.2. Make ΓòÉΓòÉΓòÉ

The settings on this page determine how the Build action generates and runs
makefiles.

Controls

 Generate a makefile
      Select this check box if you want WorkFrame to automatically determine
      file dependencies and produce a new makefile each time this Build action
      is executed. Deselect this check box if you have your own makefile that
      you want the Build action to use.

 Replace makefiles not generated by MakeMake
      This check box is a safety feature to prevent WorkFrame from accidentally
      overwriting a customized makefile. Select it if you want WorkFrame to
      overwrite the existing makefile, regardless of any modifications you have
      made to it.

 Generate a dependency file
      Select this check box if you want the dependency information to be stored
      in a separate file, rather than as part of the makefile. If  you do not
      select this option, then the dependencies are stored in the makefile.

 Dependency file extension
      If the build is to generate a separate dependency file, enter the
      extension here. The default is .dep.

 makefile generator
      Allows you to replace the program that generates a makefile, if you want
      the generated makefiles to be compatible with some other make utility.

      The generator program must transform intermediate (.$MM extension) files
      to finished makefiles.

 Make command
      If you want the build process to use a Make command other than the
      WorkFrame-supplied default, enter the command here.

 Reset
      Restores the page to the same settings as when you opened the dialog.

 Default
      Sets the fields on the page to the default values.

 Help
      Displays this help panel.


ΓòÉΓòÉΓòÉ 3.3. Project ΓòÉΓòÉΓòÉ

The settings on this page determine how to process projects that are nested
inside one another, and allow you to speed up builds of projects for which you
are the only developer or builder.

Controls

 Use build settings from parent project
      Leave this check box selected unless this project is nested within
      another, and you want to build it with different settings than its parent
      project.

      When this check box is selected, the parent's Build settings override any
      settings for this project.

 Pass build settings to subprojects
      Select this check box to allow any nested projects to assume this
      project's Build settings. If you do not select this check box, and the
      subprojects are set to use the Build settings from their parent, they
      will assume the Build settings from this project's parent instead, if one
      exists. If this project is at the root of a project hierarchy, its
      subprojects must define Build settings of their own or their builds will
      fail.

 Build any subprojects first
      Deselect this check box to perform a partial build. The current project
      will be built, but any projects nested inside it will not. For example,
      you might want to build an executable without rebuilding a DLL upon which
      it depends.

 Lock the project as it is built
      Leave this check box selected unless you are the only person who will be
      building the project. It speeds up the build process by omitting checks
      that prevent multiple simultaneous builds of the same project.

 Ensure the project target is not in use
      Select this check box to have the build utility check if the target can
      be accessed before starting the build. If the target is in use, the build
      will not start.

 Reset
      Restores the page to the same settings as when you opened the dialog.

 Default
      Sets the fields on the page to the default values.

 Help
      Displays this help panel.


ΓòÉΓòÉΓòÉ 3.4. Display ΓòÉΓòÉΓòÉ

The settings on this page determine what kinds of interactive prompts to
display during a build.

Controls

 Prompt if errors are detected during build
      Select this check box if you will be watching the build in person, and
      might want to react to any errors that occur. With this option selected,
      the build utility will display a message box when user action can be
      taken on an error. Deselect it if you will leave the build running
      unattended, or if you want the build to run to completion regardless of
      any errors that occur.

 Display the MakeMake window during build
      Select this check box if you want to explicitly create a makefile using
      MakeMake during a build. This check box allows you to customize the
      makefile generation each time the build is run.

 Reset
      Restores the page to the same settings as when you opened the dialog.

 Default
      Sets the fields on the page to the default values.

 Help
      Displays this help panel.


ΓòÉΓòÉΓòÉ <hidden> Background information about the Build utility ΓòÉΓòÉΓòÉ

The WorkFrame Build utility eliminates the need for explicitly generating and
maintaining makefiles.  It uses the MakeMake utility to generate a new makefile
each time a Build is initiated. Selecting the Rebuild all action will build all
targets, even if they are not out of date with respect to their dependent
files. The Build normal action will effectively perform a Make action by only
building the out-of-date files.

Build Prerequisites

The Build utility relies on a well-defined project setup to correctly generate
the build rules and dependency information for your project:

  The project dependencies must be expressed within the project hierarchy.

  Correct Build options, especially the build actions, must be set.

 You start a build action on your project by selecting either Build normal or
 Rebuild all from the Project pull-down menu or toolbar.


ΓòÉΓòÉΓòÉ <hidden> Selecting actions for Build and Make ΓòÉΓòÉΓòÉ

You can select the build actions from the Actions list box in the Build options
dialog, or you can run the MakeMake utility and select Build actions there.
Where you select the Build actions depends on:

  Whether you want to have descendant projects use the same set of Build
   actions.  If you do, you will need to:

     1. Select the Build actions from the Actions list box in the Build options
        dialog.
     2. Select the Pass Build settings to child projects on the Project page in
        the Build options dialog.
     3. In the Build options for the descendant projects, select the Use build
        settings from parent project in the Project page (this is the default).

   The Build actions you select in the Actions list box apply to all the source
   files in the project based on their type. If you want the Build actions to
   apply to only some of the source files in the project, you must select the
   Build actions and applicable source files from MakeMake.

  Whether you want to explicitly select source files to which the Build
   actions should apply.  If you do, you will need to select the Build actions
   from MakeMake.  Descendant projects cannot use the current project's Build
   actions if they are specified from MakeMake.

   MakeMake saves the actions from your last successful makefile generation. If
   you already have a makefile generated by MakeMake, you can use the
   previously saved actions by deselecting any actions selected in the Actions
   list box.

   Note:   If any actions in the Build options Actions list box are selected,
           those actions are used for the Build, even if Build actions were
           previously set from MakeMake. Deselect any selected actions in the
           Actions list box if you want the settings from MakeMake to apply to
           your build.


ΓòÉΓòÉΓòÉ 4. MakeMake window ΓòÉΓòÉΓòÉ

Use the MakeMake utility to create a makefile.

First, select the actions you want incorporated in the makefile from the
Actions list.

Next, select which files you want used from the Source files list box. This
listbox shows you which project files match the source types for the selected
actions.

Ensure that files are selected for those actions that need to be performed
first.

When you have finished selecting the actions and files, select the Start button
to begin generating the makefile. If you want to halt processing, select Stop.
Once the makefile has been created, you can select the Change push button to
view or modify it in the Results window. (You can force the Results to display
automatically by selecting Always show makefile from the Options menu.)

Select the Refresh button to restore the selected actions and source files to
the original set of actions and source files.

Controls

 Actions
      All the file-scoped actions that are applicable building targets are
      listed here. Select the actions that are needed, and they will be
      incorporated into the make rules.

      If you have multiple actions that use the same input file types, only
      select one action for each file type.

      If you want to select all or nearly all of the actions, you can select
      Select all from the popup menu and deselect the ones you do not want.

 Source files
      The list of files that can be used as input files for the selected
      actions. The list is empty until you select one or more actions from the
      previous list box.

      Select or deselect items to include or omit particular files from the
      build. The selected files are used to build the make dependency list.

      If you want to select all or nearly all of the files, you can select
      Select all from the popup menu and deselect the ones you do not want.

 Start
      Generates an internal representation of the makefile, creating make rules
      and dependencies based on the selected actions and files.

      To update the actual makefile, select one of the "Save" choices under the
      File menu.

 Stop
      Interrupts the generation of the makefile. Any existing makefile is not
      modified.

 Change
      Displays  MakeMake Results window in which you can change the makefile,
      and dependency file if applicable, before saving them.

 Refresh
      Displays the lists of actions and files again, in case the project has
      been updated while MakeMake is running.

 Menu-Bar Choices

  File
  Options
  Help

 Related information

  You can also run this utility from the command line using the IMKMK command.
   See the VisualAge for C++ User's Guide for information about the command
   line options. IMKMK takes a maximum of nine parameters.
  Selecting actions for Build and Make


ΓòÉΓòÉΓòÉ 4.1. File ΓòÉΓòÉΓòÉ

Use this pulldown menu to perform open, save, and exit operations for the
MakeMake program.

Menu choices

  Open project
  Save makefile
  Save and close
  Exit


ΓòÉΓòÉΓòÉ 4.1.1. Open project ΓòÉΓòÉΓòÉ

Selects a project for which to generate a makefile, then reads the list of
applicable actions and files from the project.


ΓòÉΓòÉΓòÉ 4.1.2. Save makefile ΓòÉΓòÉΓòÉ

Saves the generated makefile back into the project, overwriting any earlier
version of the same file. If you do not save the makefile before exiting from
MakeMake, the updated makefile information is lost.


ΓòÉΓòÉΓòÉ 4.1.3. Save and close ΓòÉΓòÉΓòÉ

Provides a fast way to perform these two final operations when you are finished
using MakeMake:

  Save makefile
  Exit


ΓòÉΓòÉΓòÉ 4.1.4. Exit ΓòÉΓòÉΓòÉ

Exits from the MakeMake program.

Make sure to save the new or updated makefile before selecting Exit.


ΓòÉΓòÉΓòÉ 4.2. Options ΓòÉΓòÉΓòÉ

Use this pulldown menu to customize the display areas, generated make rules,
and prompts for the MakeMake program.

Menu choices

  Select new files
  Always show makefile
  Depend on makefile
  Exit without verification


ΓòÉΓòÉΓòÉ 4.2.1. Select new files ΓòÉΓòÉΓòÉ

Toggles whether files are automatically selected as they are added to the
Source files list box.


ΓòÉΓòÉΓòÉ 4.2.2. Always show makefile ΓòÉΓòÉΓòÉ

Toggles whether the makefile and dependency file are automatically displayed
after being generated, so that you can edit them before saving them. If this
item is not selected, you can display the Results window by selecting the
Change pushbutton.


ΓòÉΓòÉΓòÉ 4.2.3. Depend on makefile ΓòÉΓòÉΓòÉ

Toggles whether to add the makefile as a dependency to each make rule, so that
everything will be built again after the makefile is changed.


ΓòÉΓòÉΓòÉ 4.2.4. Exit without verification ΓòÉΓòÉΓòÉ

Toggles whether to display a confirmation prompt when you try to exit from the
MakeMake utility.


ΓòÉΓòÉΓòÉ 4.3. Help menu ΓòÉΓòÉΓòÉ

Use the entries under this menu to get instructions for the WorkFrame graphical
user interface.

Menu Summary

 Help index
      The Help Index menu item launches the index for WorkFrame online help.

 General Help
      The General Help menu item launches the online help for MakeMake.

 Using Help
      The Using Help menu item launches the help information for using the
      Information Presentation Facility (IPF).

 How do I Help
      The How Do I menu item launches the WorkFrame .How Do I information. It
      provides step-by-step instructions on how to perform tasks using
      WorkFrame

 Product Information
      The Product Information menu item provides information about this release
      of WorkFrame.


ΓòÉΓòÉΓòÉ <hidden> Select all ΓòÉΓòÉΓòÉ

Selects all the items in the list box.


ΓòÉΓòÉΓòÉ <hidden> Deselect all ΓòÉΓòÉΓòÉ

Deselects all the items in the list box.


ΓòÉΓòÉΓòÉ <hidden> MakeMake window ΓòÉΓòÉΓòÉ

Use the MakeMake utility to create a makefile.

First, select the actions you want incorporated in the makefile from the
Actions list.

Next, select which files you want used from the Source files list box. This
listbox shows you which project files match the source types for the selected
actions.

Ensure that files are selected for those actions that need to be performed
first.

When you have finished selecting the actions and files, select the Start button
to begin generating the makefile. If you want to halt processing, select Stop.
Once the makefile has been created, you can select the Change push button to
view or modify it in the Results window. (You can force the Results to display
automatically by selecting Always show makefile from the Options menu.)

Select the Refresh button to restore the selected actions and source files to
the original set of actions and source files.

Controls

 Actions
      All the file-scoped actions that are applicable building targets are
      listed here. Select the actions that are needed, and they will be
      incorporated into the make rules.

      If you have multiple actions that use the same input file types, only
      select one action for each file type.

      If you want to select all or nearly all of the actions, you can select
      Select all from the popup menu and deselect the ones you do not want.

 Source files
      The list of files that can be used as input files for the selected
      actions. The list is empty until you select one or more actions from the
      previous list box.

      Select or deselect items to include or omit particular files from the
      build. The selected files are used to build the make dependency list.

      If you want to select all or nearly all of the files, you can select
      Select all from the popup menu and deselect the ones you do not want.

 Start
      Generates an internal representation of the makefile, creating make rules
      and dependencies based on the selected actions and files.

      To update the actual makefile, select one of the "Save" choices under the
      File menu.

 Stop
      Interrupts the generation of the makefile. Any existing makefile is not
      modified.

 Change
      Displays  MakeMake Results window in which you can change the makefile,
      and dependency file if applicable, before saving them.

 Refresh
      Displays the lists of actions and files again, in case the project has
      been updated while MakeMake is running.

 Menu-Bar Choices

  File
  Options
  Help

 Related information

  You can also run this utility from the command line using the IMKMK command.
   See the VisualAge for C++ User's Guide for information about the command
   line options. IMKMK takes a maximum of nine parameters.
  Selecting actions for Build and Make


ΓòÉΓòÉΓòÉ 4.4. MakeMake Results window ΓòÉΓòÉΓòÉ

Use this window to view and alter the makefile once it has been created and
before it has been saved.

If you chose to create a separate dependencies file, a second page appears
behind the makefile page. You can edit the dependencies file in the same manner
as you edit the makefile.

To edit the makefile:

  1. Scroll to the area you want to change. (By selecting one of the targets in
     the Targets list, you can automatically scroll to the statements
     describing how to build that target.)

     Note:   If you insert or delete lines, selecting a target may no longer
             take you to the correct line in the makefile.

  2. The makefile list box acts as a simple text editor. To edit the makefile,
     move the cursor to the area you want to change and start typing. Remember,
     any editing changes you make will not be reflected if the MakeMake tool is
     used to replace the makefile later.

  3. Close this window after you have finished making the changes.

 Since the MakeMake utility creates an ASCII file, you can also modify the file
 with an editor.

 Warning:  Any changes you make (within the MakeMake Results window or an
 editor) will not be restored the next time you use the MakeMake utility to
 replace the makefile.

 If you decide to undo all the changes you made to the makefile after the
 MakeMake Results window was opened, select the Cancel push button.

 Controls

 Targets produced
      Shows the names of all the targets in the makefile. Select a target to
      display the part of the makefile that defines it.

 Make and dependency file notebook
      Shows the contents of the makefile, and the dependency file if one was
      created, in a notebook dialog. You can edit the contents of these files
      by changing the text in the notebook.

 Ok
      Saves any changes you have made to the generated files, and closes the
      window.

 Cancel
      Removes any changes you have made to the generated files, and closes the
      window.

 Help
      Displays help for the MakeMake Results window.


ΓòÉΓòÉΓòÉ <hidden> MakeMake Results window ΓòÉΓòÉΓòÉ

Use this window to view and alter the makefile once it has been created and
before it has been saved.

If you chose to create a separate dependencies file, a second page appears
behind the makefile page. You can edit the dependencies file in the same manner
as you edit the makefile.

To edit the makefile:

  1. Scroll to the area you want to change. (By selecting one of the targets in
     the Targets list, you can automatically scroll to the statements
     describing how to build that target.)

     Note:   If you insert or delete lines, selecting a target may no longer
             take you to the correct line in the makefile.

  2. The makefile list box acts as a simple text editor. To edit the makefile,
     move the cursor to the area you want to change and start typing. Remember,
     any editing changes you make will not be reflected if the MakeMake tool is
     used to replace the makefile later.

  3. Close this window after you have finished making the changes.

 Since the MakeMake utility creates an ASCII file, you can also modify the file
 with an editor.

 Warning:  Any changes you make (within the MakeMake Results window or an
 editor) will not be restored the next time you use the MakeMake utility to
 replace the makefile.

 If you decide to undo all the changes you made to the makefile after the
 MakeMake Results window was opened, select the Cancel push button.

 Controls

 Targets produced
      Shows the names of all the targets in the makefile. Select a target to
      display the part of the makefile that defines it.

 Make and dependency file notebook
      Shows the contents of the makefile, and the dependency file if one was
      created, in a notebook dialog. You can edit the contents of these files
      by changing the text in the notebook.

 Ok
      Saves any changes you have made to the generated files, and closes the
      window.

 Cancel
      Removes any changes you have made to the generated files, and closes the
      window.

 Help
      Displays help for the MakeMake Results window.