Copyright: Copyright © ARM Ltd 02/06/95


yesyesyes 2yesARM Project Manager HelpAPMyesyes02/06/95


Table of Contents

The Toolbar

The Status Bar

Windows	Menus	Dialog boxes

Project Output	File	File Open

Edit 	File Save

View	New Project

Project	Edit Project

Window	Open Project

Help	Project Dependencies

Tool Parameters

Compiler Options

Compiler Errors

Compiler Warnings

Compiler Features

Assembler Options

Linker Options

Project Options

Editor Options

Directory Options

DecAOF Options

Add Project File

Print File

Printer Setup

Find Text

Replace Text

View Build Logs

About the ARM Project Manager

Go To Line

Change Filename


Edit Parameters
Tool Parameters

The Tool Parameters dialog box allows you to specify tool-specific options for a source file. These are the options which would appear on a command-line invocation of the tool.

The example below shows the equivalent of:

armcc count.c -o count1.o

These parameters are only applied for the specified source file. For a summary of tool parameters see

the Software Development Toolkit Reference Manual.


Edit Project

The Edit Project dialog box enables you to add or remove project files, and to specify tool parameters for each file.

The following options are avaialble:

Add...	Opens the Add Project File dialog box and allows you to add a file

to the project.

Remove	Removes a selected file from the project.

Edit Selected	Allows you to edit a selected file using your default editor.

Alter Name...	Allows you to change the name of a selected file.

Edit Params...	Opens the Tools Parameters dialog box and allows you to add

parameters for the tools.


About the ARM Project Manager

This indicates which version of the software you are using.


View Build Logs

This option allows you to view selected build logs using the dialog box shown below.

You can use this option to debug build problems.


Open Project

The Open Project dialog box enables you to open an existing project.

Choosing which Project to Open

The following options allow you to specify which project to open:

File Name	Lists files with the extension you select in the List Files of Type box.

List Files of Type	Select the files of type *.apj to choose a project.

Directories	Selects the directory in which the ARM Project Manager has stored the

project you wish to open.

Drives	Selects the drive in which the ARM Project Manager has stored the

project you wish to open.

Network...	Connects to a network location.


New Project

The New Project dialog box enables you to create a new project. You can specify a new

project by entering the project name in the filename field shown below.

The following options allow you to open a new project in a specified location:

File Name	Specifies the name of the new project.

Directories	Specifies the directory where the new project will be created.

Drives	Specifies on which drive the new project will be created.


Add Project File

The following dialog box allows you to add a file to your project:


Help file produced by  K.Mockford & E.Hall as part of the Windows Toolkit development process.


Project Dependencies

This dialog box displays the file dependencies in your project.

Double-click a file entry to edit it, or alternatively select a file entry and click on Edit File.

Select an object file (.o) and click on DecAOF... to display detailed information about the object..


Save File

This dialog box allows you to save files in the ARM Project Manager.

Choosing a filename

The following options allow you to specify a filename for the file you wish to save:

File Name	Lists files with the extension you select in
the Save Files of Type box.

Save Files of Type	Selects the type of file you want to save:

*.c	C source

*.cpp	C++ source

*.s	armasm source

*.h	Header

*.mak	Make

*.map	Memory model MAP

Directories	Selects the directory in the ARM Project Manager

where you wish to save the file.

Drives	Selects the drive in  the ARM Project Manager
where you wish to store the file.

Network...	Connects to a network location.


Compiler Options

The Project Manager has the following Compiler options:

Optimisations

Space	Performs optimisations to reduce image size  at the expense of

increased execution time.

Time	Performs optimisations to reduce execution time at the expense

of a larger image.

Default	Balances the above two options.

Source

ANSI	Indicates that the source is ANSI C.

PCC	Indicates that the source is K&R old style (PCC) C.

Errors... 	Opens the Errors dialog box.

Warnings... 	Opens the Warnings dialog box.

Features... 	Opens the Features dialog box.


Compiler Errors

The Project Manager allows you to suppress the following Compiler errors:


Compiler Warnings

The Project Manager allows you to suppress the following Compiler warnings:


Compiler Features

The Project Manager allows you to select the following Compiler features:


Assembler Options

The Project Manager has the following Assembler options:


Project Output Window

The Project Output window displays a summary of the currently open project.  To view a project

summary, choose Show from the Project menu. An example of a project summary is shown below.

The project summary shows the source files and the command-line options used.

The compiler options are set in the Compiler Options dialog box.

The Linker options are set in the Linker dialog box.

This window also displays the errors and warnings from the most recent build. Double-click on an

error to load the source file into your default editor and move to the line containing the error.

This window also displays the detailed information about an object file when you click on the

DecAOF button in the Show Dependencies dialog box.


Linker Options

The Linker Options dialog box allows you to add command-line optinos, eg. -info sizes

and gives full details of code size.


Project Options

The Project Manager has the following Project options:

Project Type	Specifies whether the project is built into an image or a library.

Command Line	Specifies the arguments for the image when it is run in the Debugger.

Endian	Specifies the endianness.

Build	Builds your project as a Debug or Release version.

Debug	Uses the -g command-line option for the compiler

and assembler.

Release	Generates fully optimised code. Note that the linker

will still generate

debug information unless you use the -nodebug

option with the linker.

Tools	Specifies the tools to be used.

Target Processor	Specifies the target processor.

A full dependency scan opens each source file to determine included headers. Without a full dependency

scan, each object is only rebuilt if the respective source files have been modified. There is no check to

see if included headers have changed. A full dependency scan will be required in most cases.


Go To Line

The following dialog box allows you to move to a specified line in the file:


Change Filename

The following dialog box allows you to change the name of a project file:


Entering Data

There are several places within the Project Manager where you may be required to enter information, for example when moving to a specified line in the file, when altering the name of a file or when choosing the DecAOF options:

For help in these operations click on the approapriate dialog box entry:

Go To dialog box

Change Name dialog box

DecAOF Options dialog box


Editor Options

The Project Manager has the following Editor options:

Tab Stops	Specifies the tab settings.

Font...	Displays the Font dialog box and allows you to specify the

font, style and size of the text.

Use CodeWright	Specifies CodeWright as the default editor.

CodeWright must have DDE enabled. See the Release Notes

for information on enabling DDE.

Location	Specifies the location of the CodeWright executable.

Browse...	Allows you to select your location by viewing the directory hierarchy.


Directory Options

The Project Manager has the following Directory options:

Project Manager	Specifies the location of the Project Manager.

Libraries	Specifies the location of the Libraries.

Tools	Specifies the location of the tools.

Note: 	If you are using Windows 3.1, the tools directory should be the location

of the DOS extended tools, ie. the DOS directory.

If you are using Windows95 or WindowsNT, the tools directory shouold

be the location of the WIN32 console tools, ie. the BIN directory.


DecAOF Options

DecAOF is the ARM object file disassembler. It can display information stored in an object file.

The DecAOF Options dialog box allows you to set DecAOF command-line options.

The following options are available:

b	Prints only the area declarations

a	Prints area contents in hex

d	Prints area declarations

r	Prints relocation directives (and implicitly includes -d)

c	Disassembles code areas (and implicitly includes -d)

g	Prints debug areas

q	Gives a quick report of the area sizes only

s	Prints symbol tables

t	Prints string tables


Print File

The following options allow you to specify how the document should be printed:

Printer	This is the active printer and printer connection.

Choose the Setup option to change the printer and printer connection.

Setup	Displays a Print Setup dialog box, so  you can select a printer

and printer connection.

Print Range	Specifies the pages you want to print:

All	Prints the entire document.

Selection	Prints the currently selected text.

Pages	Prints the specified range of pages.

Copies	Specifies the number of copies you want to print for the above page range.

Collate Copies	Prints copies in page number order, instead of separated multiple copies of each page.

Print Quality	Selects the quality of the printing.  Generally, lower quality printing takes less time to produce.


Print Progress Dialog

The Printing dialog box is shown during the time that The The ARM Project Manager is sending output to the printer.  The page number indicates the progress of the printing.

To abort printing, choose Cancel.


Print Preview toolbar

The print preview toolbar offers you the following options:

Print

Bring up the print dialog box, to start a print job.

Next Page

Preview the next printed page.

Prev Page

Preview the previous printed page.

One Page / Two Page

Preview one or two printed pages at a time.

Zoom In

Take a closer look at the printed page.

Zoom Out

Take a larger look at the printed page.

Close

Return from print preview to the editing window.


Printer Setup

The following options allow you to select the destination printer and its connection.

Printer	Select the printer you want to use.  Choose the Default Printer

or choose the Specific Printer option and select one of the current

installed printers shown in the box. You install printers and configure ports

using the Windows Control Panel.

Orientation	Choose Portrait or Landscape.

Paper Size	Select the size of paper.

Paper Source	Some printers offer multiple trays for different paper sources.

Specify the tray here.

Options	Displays a dialog box where you can make additional choices about printing,

specific to the type of printer you have selected.

Network...	Choose this button to connect to a network location, assigning it a new drive letter.


File Page Setup Command
Page Setup command (File menu)

<< Write application-specific help here. >>


File Print command
File menu commands

The File menu offers the following commands:

Command	Action	Toolbar Shortcut	Keyboard Shortcut
New	Creates a new document.		CTRL+N
Open...	Loads an existing document Opens the File Open dialog box.		CTRL+O
Close	Closes an opened document.
Save	Saves an opened document using the same filename.		CTRL+S
Save As...	Saves an opened document to a specified file name. Opens the Save As dialog box.
Print...	Prints a document. Opens the Print dialog box.		CTRL+P
Print Preview	Displays the document on the screen as it would appear when printed.
Print Setup...	Selects a printer and printer connection.
Exit	Exits the ARM Project Manager.

You can use the numbers and filenames listed at the bottom of the File menu to open

the last four documents used. Choose the number that corresponds with the

document you want to open.


Select All
Edit menu commands

The Edit menu offers the following commands:

Command	Action	Toolbar Shortcut	Keyboard Shortcut
Undo	Reverses the previous editing operation.		CTRL+Z
Cut	Cuts the selected data from the document and moves it to the clipboard.		CTRL+X
Copy	Copies the selected data from the document to the clipboard.		CTRL+C
Paste	Pastes data from the clipboard into the document.		CTRL+V
Delete	Deletes the selected data from the document.		DEL
Select All	Selects all data in the document.
Find...	Finds a specified string in the document. Opens the Find dialog box.		Alt+F3
Repeat	Repeats the previous find operation.		F3
Replace...	Replaces occurrences of a specified string in the document. Opens the Replace dialog box.
Go To...	Goes to a specified line in the document. Opens the Go To Line dialog box.


Close Project
 Project menu commands

The Project menu offers the following commands:

Command	Action	Toolbar Shortcut	Keyboard Shortcut
New...	Starts a new project. Opens the New Project dialog box.
Open...	Opens an existing project. Opens the Open Project dialog box.
Edit...	Allows you to edit the source files in a project. Opens the Edit Project dialog box.
Show	Displays a project summary.
Close	Closes a project.
Compile	Compiles the file in the currently selected editor window.		Ctrl+F8
Build	Checks for source files which have been edited since the project was last built and builds them into  the target application.
Rebuild All	Rebuilds the target application from scratch.
Stop Build	Abandons the build.
Execute	Invokes the Debugger and runs the image.
Debug	Invokes the Debugger and loads the image. A breakpoint is set on the first instruction in main.
Scan Dependencies	Calculates dependencies between project files.
Show Dependencies...	Displays dependencies between project files. Opens the Project Dependencies dialog box.


View Buildlogs
View menu commands

The View menu offers the following commands:

Command	Action	Toolbar Shortcut	Keyboard Shortcut
Next Error	Moves to the next error in the source file.		F4
Previous Error	Moves to the previous error in the source file.		SHIFT+F4
Build Logs...	Allows you to view the build log files. Opens the Build Logs dialog box.
Toolbar	Displays or hides the Toolbar.
Status Bar	Displays or hides the Status Bar


Window menu commands

The Window menu offers the following commands, which enable you to arrange multiple views of multiple documents in the application window:

Command	Action
Cascade	Arranges windows in an overlapped fashion.
Tile	Arranges windows in a non-overlapped fashion.
Arrange Icons	Arranges icons of closed windows.

The ARM Project Manager displays a list of currently open document windows at the bottom of the Window menu.  A check mark appears in front of the windowt name of the active window.  Choose a window from this list to bring it to the front.


Help menu commands

The Help menu offers the following commands, which provide you assistance with this application:

Command	Action
Index	Offers you an Index of topics on which you can get help.
Using Help	Provides general instructions on using help.
About ARM Project Manager...	Displays the version number of this application.


Open File
File Open

This dialog box allows you to open files in the ARM Project Manager.

Choosing which file to open

The following options allow you to specify which file to open:

File Name	Lists files with the extension you select in
the List Files of Type box.

List Files of Type	Selects the type of file you want to open:

*.c	C source

*.cpp	C++ source

*.s	armasm source

*.h	Header

*.mak	Make

*.map	Memory model MAP

*.*	All

Directories	Selects the directory in which the ARM Project Manager

has stored the file you want to open.

Drives	Selects the drive in which the ARM Project Manager
has stored the file you want to open.

Network...	Connects to a network location.


Redo command (Edit menu)

<< Write application-specific help here. >>


Opening or Adding Files and Projects

You can create a new project, open an existing project, add a file to a project or

open a file using the following dialog boxes:

New Project dialog box

Open Project dialog box

Add Project File dialog box

Open File dialog box

Click ion the appropriate dialog box  name to get help.


toolbar
The Toolbar

The Toolbar is displayed across the top of the application window, below the menu bar.  It provides quick mouse access to many of the ARM Project Manager's functions.

Hiding/showing the Toolbar

To hide or show the Toolbar, choose Toolbar from the View menu (ALT, V, T).

Document Editing Options

The Project Manager Toolbar has the following document editing options:

New	Opens an editor window for a new document.

Open	Loads an existing document.

This option lets you choose a file from the Open File dialog box.

Save	Saves a document.

Cut	Removes the current selection from the document and places it in the clipboard.

Copy	Copies the current selection to the clipboard.

Paste	Pastes clipboard contents at the cursor position.

Print	Prints the document.

Project Management Options

The Project Manager Toolbar has the following Project Management options:

View Logs	Opens the  View Logs dialog box.

This allows you to view the logged output of each compile,

assemble and link operation.

Edit Project	Opens the Edit Project dialog box.

This allows you to edit the source files in your project.

Show Dependencies	Opens the Project Dependencies dialog box.

Show Project	Displays a project summary.

Compile File	Compiles the currently selected file.

Build	Builds the target application.

Rebuild All	Rebuilds the target application from scratch.

Stop Build	Abandons the build.

Execute	Invokes the Debugger and runs the image.

Debug	Invokes the Debugger and loads the image.

A breakpoint is set on the first entry in main.


status bar
The Status Bar

The status bar is displayed at the bottom of the The ARM Project Manager window.

Showing/hiding the Status Bar

To show or hide the status bar, use the Status Bar command in the View menu (ALT, V, S)

Left Area

The left area of the status bar describes actions of menu items as you use the arrow keys to navigate through menus.

This area similarly shows messages that describe the actions of toolbar buttons as you press them, before releasing them.

If you do not wish to execute the toolbar command you are viewing, release the mouse button while the pointer is off the toolbar button.

Right Area

The right areas of the status bar indicate which of the following keys are latched down:

Indicator	Description

CAP	The Caps Lock key is latched down.

NUM	The Num Lock key is latched down.

SCRL	The Scroll Lock key is latched down.


New command (Window menu)

Use this command to open a new window with the same contents as the active window.  You can open multiple document windows to display different parts or views of a document at the same time.  If you change the contents in one window, all other windows containing the same document reflect those changes.  When you open a new window, it becomes the active window and is displayed on top of all other open windows.


Help Using Help Command
Context Help command

Use the Context Help command to obtain help on some portion of The ARM Project Manager.  When you choose the Toolbar's Context Help button, the mouse pointer will change to an arrow and question mark.  Then click somewhere in the The ARM Project Manager window, such as another Toolbar button.  The Help topic will be shown for the item you clicked.

Shortcut

Keys:	SHIFT+F1


Title Bar

<< Show your application's title bar here. >>

The title bar is located along the top of a window.  It contains the name of the application and document.

To move the window, drag the title bar.  Note: You can also move dialog boxes by dragging their title bars.

A title bar may contain the following elements:

Application Control-menu button

Document Control-menu button

Maximize button

Minimize button

Name of the application

Name of the document

Restore button


Scroll bars

Displayed at the right and bottom edges of the document window.  The scroll boxes inside the scroll bars indicate your vertical and horizontal location in the document.  You can use the mouse to scroll to other parts of the document.

<< Describe the actions of the various parts of the scrollbar, according to how they behave in your application. >>


Size command (System menu)

Use this command to display a four-headed arrow so you can size the active window with the arrow keys.

After the pointer changes to the four-headed arrow:

1.	Press one of the DIRECTION keys (left, right, up, or down arrow key) to move the pointer to the border you want to move.

2.	Press a DIRECTION key to move the border.

3.	Press ENTER when the window is the size you want.

Note:  This command is unavailable if you maximize the window.

Shortcut

Mouse:	Drag the size bars at the corners or edges of the window.


Move command (Control menu)

Use this command to display a four-headed arrow so you can move the active window or dialog box with the arrow keys.

Note:  This command is unavailable if you maximize the window.

Shortcut

Keys:	CTRL+F7


System Minimize Command
Minimize command (application Control menu)

Use this command to reduce the The ARM Project Manager window to an icon.

Shortcut

Mouse:	Click the minimize icon [image] on the title bar.

Keys:	ALT+F9


Maximize command (System menu)

Use this command to enlarge the active window to fill the available space.

Shortcut

Mouse:	Click the maximize icon [image] on the title bar; or double-click the title bar.

Keys:	CTRL+F10 enlarges a document window.


Next Window command (document Control menu)

Use this command to switch to the next open document window.  The ARM Project Manager determines which window is next according to the order in which you opened the windows.

Shortcut

Keys:	CTRL+F6


Previous Window command (document Control menu)

Use this command to switch to the previous open document window.  The ARM Project Manager determines which window is previous according to the order in which you opened the windows.

Shortcut

Keys:	SHIFT+CTRL+F6


Close command (Control menus)

Use this command to close the active window or dialog box.

Double-clicking a Control-menu box is the same as choosing the Close command.

Note:  If you have multiple windows open for a single document, the Close command on the document Control menu closes only one window at a time.  You can close all windows at once with the Close command on the File menu.

Shortcuts

Keys: 	CTRL+F4 closes a document window

ALT+F4 closes the <<YourType>> window or dialog box


Restore command (Control menu)

Use this command to return the active window to its size and position before you chose the Maximize or Minimize command.


Switch to command (application Control menu)

Use this command to display a list of all open applications.  Use this "Task List" to switch to or close an application on the list.

Shortcut

Keys:	CTRL+ESC

Dialog Box Options

When you choose the Switch To command, you will be presented with a dialog box with the following options:

Task List

Select the application you want to switch to or close.

Switch To

Makes the selected application active.

End Task

Closes the selected application.

Cancel

Closes the Task List box.

Cascade

Arranges open applications so they overlap and you can see each title bar.  This option does not affect applications reduced to icons.

Tile

Arranges open applications into windows that do not overlap.  This option does not affect applications reduced to icons.

Arrange Icons

Arranges the icons of all minimized applications across the bottom of the screen.


View Ruler Command
Ruler command (View menu)

<< Write application-specific help here. >>


Choose Font Dialog
Choose Font dialog box

<< Write application-specific help here. >>


Choose Color Dialog
Choose Color dialog box

<< Write application-specific help here. >>


Find command (Edit menu)

<< Write application-specific help here. >>


Find Dialog
Find Text

The following dialog box allows you to serach for text in a given file:


Replace command (Edit menu)

<< Write application-specific help here. >>


Replace Dialog
Replace Text

The following dialog box allows you to search for specified text and replace each occurence

with other specified text:


Repeat command (Edit menu)

Use this command to repeat the last editing command carried out.  The Repeat menu item changes to Can't Repeat if you cannot repeat your last action.

Shortcut

Key:	F4


Clear command (Edit menu)

<< Write application-specific help here. >>


Edit Clear All
Clear All command (Edit menu)

<< Write application-specific help here. >>


Next Pane Command
Next Pane

<< Write application-specific help here. >>


Prev Pane Command
Prev Pane

<< Write application-specific help here. >>


Modifying the Document

<< Write application-specific help here that provides an overview of how the user should modify a document using your application.

If your application supports multiple document types and you want to have a distinct help topic for each, then use the help context i.d. generated by running the MAKEHELP.BAT file produced by AppWizard.  Alternatively, run MAKEHM as follows:

makehm IDR_HIDR_,0x2000 resource.h

If the IDR_ symbol for one of your document types is, for example, IDR_CHARTTYPE, then the help context i.d. generated by MAKEHM will be HIDR_CHARTTYPE.

Note, AppWizard defines the HIDR_DOC1TYPE help context i.d. used by this help topic for the first document type supported by your application.  AppWizard produces an alias in the .HPJ file for your application, mapping HIDR_DOC1TYPE to the HIDR_ produced by MAKEHM for that document type. >>


No Help Available

No help is available for this area of the window.


No Help Available

No help is available for this message box.

<< If you wish to author help specific to each message box prompt, then remove the AFX_HIDP_xxx values from the [ALIAS] section of your .HPJ file, and author a topic for each AFX_HIDP_xxx value.  For example, AFX_HIDP_INVALID_FILENAME is the help topic for the Invalid Filename message box. >>