Copyright: Copyright © ARM Ltd 02/06/95


yes 2yesyesyesARM Debugger for WindowsWINDBGyesyes02/06/95


Table of Contents

The Toolbar

The Status Bar

Windows	Menus	Dialog boxes

Execution Window	File menu	Open File

Console Window	Edit menu	Save Console Contents

RDI Log Window	View menu	Regular Expression Search

Variables	Window menu	Display Coprocessor Registers

Low Level Symbols	Help menu	Configuring EmbeddedICE

Breakpoints	Search menu	RDI Debugger Configuration

Registers	Execute menu	ARMulator Debugger Configuration

Watchpoints	Options menu	Set or Edit Breakpoint

Search Paths	Item menu	Set or Edit Watchpoint

Source Files	View Expression

Function Names	Go To Source Line

Backtrace	Memory Address

Memory	Disassembly Address

Source Window	RDI Log Level

Debugger Internals	Go To Address

Disassembly Window	Display Format

Text Font

Save RDI Log

Put File

Modify Item

Getting Files and Adding Search Paths

Command Line Arguments


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


The Toolbar

The Toolbar is displayed across the top of the application window. It provides quick

mouse access to many of the ARM Debugger's tools.

Showing/hiding the Toolbar

To show or hide the Toolbar, choose Toolbar from the View menu.

Loading and Debugging the Image

The ARM Debugger has the following options for loading and debugging the image:

Load Image...	Loads an image and specifies any command-line arguments

to be passed to the image.

This option displays the Open File dialog box.

Toggle Breakpoint	Sets or removes a breakpoint at the current execution marker.

Toggle Watchpoint	Sets or removes a watchpoint.

Reload	Reloads the current image.

Toggle Profiling	Activates or deactivates the ARM Profiler.

Evaluate Expression	Evaluates a specified expression as you step through the program.

This option displays the View Expression dialog box.

Executing or Stepping through the Program

The ARM Debugger has the following options for executing and stepping through the program:

Go	Starts execution of the program.

Stop	Stops execution of the program.

Step Into	Steps through the program following all of the function calls.

Step Out	Returns from the current location in a called function to its originating code,

immediately after the function call.

Step	Steps through the program

- line by line if just the source of the program is displayed

- machine instruction by machine instruction if the source is

  interleaved with disassembly.

It does not step into functions.

Viewing the Program Values

The ARM Debugger has the following options for viewing variables and expressions within the program:

Locals	Displays the values of all the local variables as you step through the program.

User Regs	Displays a breakdown of the registers in User mode, allowing you to examine

the contents of the register at the current location in your program.

Memory	Allows you to view  memory at a specified address.

This option displays the Memory Address dialog box.

Disassembly	Allows you to view memory interpreted as machine instructions at a specified address.

This option displays the Disassembly Address dialog box.

Back Trace	Displays information about all currently active procedures, starting with the most recent.


The Status Bar

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

Showing/hiding the Status Bar

To show or hide the status bar, choose Status Bar from the View menu.

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 want to execute the toolbar

command you are viewing, release the mouse button while the pointer is off the toolbar button.

The left area of the status bar also reports the state of the Debugger, eg. Breakpoint #1 and is

useful for determining why the Debugger has stopped.

Right Area

The right area of the status bar indicates 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.


Execution Window

The execution window displays the currently executing program.

The current portion of the program is displayed as:

- machine instructions (disassembly)

- source code

- interleaved source code and disassembly


Console Window

The console window allows you to interact with the executing program.

Anything printed by the program is displayed in this window.

You must enter any input required by the program in this window.


RDI Log Window

The RDI Log window displays the low-level communication messages between the

Debugger and the target processor.

To enable RDI logging, choose RDI Log Level from the Options menu.


File Open command
Open File

The following dialog box appears when you choose Load Image from the File menu.

Choosing the Image to Open

The following options allow you to specify the image to load:

File Name	You can enter the name of the image here

Arguments	You can specify any command line arguments required by the program here.


Save

This dialog box allows you to:

- Save the contents of the console window to a specified file

- Save the contents of the RDI Log to a specified file

- Save a file to a specified location.

Specifying the File

The following options allow you to specify the file:

File Name	Enter your specified filename.

Save File as Type	Selects the type of file you wish to save.

Directories	Selects the directory where you wish to save the file.

Drives	Selects the drive on which you wish to save the file.

Network...	Connects to a network location.


Regular Expression Search

The following dialog box allows you to search through memory, disassembly or source for

specified text and moves to the line or address of that specified text.


Display Coprocessor Registers

The following dialog box allows you to display specified coprocessor registers.


Configuring EmbeddedICE

The following options are available:

Load Agent...	Allows you to select a new agent file to download to EmbeddedICE ROM.

Load Config...	Allows you to download a configuration data file describing the target processor.

Select	Selects which of the downloaded or built in configuration files should be used.


RDI Debugger Configuration

The Remote Debug Interface (RDI) is used to connect the Debugger to a target ARM processor.

The target may be an ARM emulator (ARMulator) or a real ARM-based target connected via a

serial or serial/parallel port.


ARMulator Debugger Configuration

The ARMulator can be configured to emulate any available ARM processor.

The clock speed is used in conjunction with the memory map file describing memory

performance which enables the ARMulator to keep track of real time.


Set or Edit Breakpoint

The following dialog box allows you to create a complex breakpoint.

Setting a Breakpoint

The following options allow you to set or edit the breakpoint:

File	Specifies the file. This field is completed for you.

Location	Specifies the location of the breakpoint.

This field is completed for you.

Expression	Allows you to set an expression.

The program halts when this expression is true.

Count	Allows you to set a count. For example, setting a count of 2

halts the program the second time it reaches the given location.


Set or Edit Watchpoint

The following dialog box allows you to create a complex watchpoint.

Setting a Watchpoint

The following options allow you to set or edit the watchpoint:

Item	Specifies the name of the item where you wish to set the watchpoint.

This field is completed for you.

Target Value	Allows you to set a target value. The program halts when the value of

the specified item reaches the target value.

Expression	Allows you to set an expresion.

The program halts when this expression is true.

Count	Allows you to set a count. For example, setting a count of 2

halts the program when the value of the item changes to become

the target value for the second time.


Go To Source Line

This dialog box allows you to move to a specified line of source.

Enter your specified line of source.


Go To Address

This dialog box allows you to move to a specified memory address.

Enter your specified address in the given field in hex, eg. 0x8000 or decimal, eg. 65536.


View Expression

This dialog box allows you to view an expression. Enter your required expression in the field and

click on OK. The expression and its evaluation appear in the expression window.


Memory Address

This dialog box allows you to view memory at a specified address. A Memory window is displayed

centred on the specified address. Enter the address in hex, eg. 0x8000 or decimal, eg. 65536.


Disassembly Address

This dialog box allows you to view a specified address. A Memory window appears centred

on the specified address. The memory is displayed as machine instructions.

Enter the address in hex, eg. 0x8000 or decimal, eg. 65536.

The Thumb and ARM processors have different instruction encoding so it may be necessary

to change the disassembly mode by choosing Disassembly Mode from the Options menu.


RDI Log Level

This dialog box allows you to specify the amount of information displayed

in the RDI Log window. 0 specifies no logging, higher numbers specifiy more detail

depending on the type of RDI connection.


Checking Data

You may wish to move to a particular source line or memory address, or check the RDI Log Level:

GoTo Source Line dialog box

GoTo Address dialog box

RDI Log Level dialog box


Command Line Arguments

This dialog box allows you to change the command-line arguments the program

will use when entering the Debugger.


Display Format

This dialog box allows you to change the format of displayed values.

Specifying %x changes the format to hex. Specifying nothing reverts to the default format.

You can change the format of all values in a window or a single line.


Entering Data

There are several dialog boxes which require input before proceeding.
For help, click on the appriapiate dialog box name.

View Expression dialog box

Goto Address dialog box

Memory Address dialog box

Disassembly Address dialog box

Command Line Arguments dialog box

Display Format dialog box

Modify Item dialog box


Choose Font Dialog
Text Font

This dialog box allows you to change the text font in all of the windows.

Changing the Font

The following options allow you to change the text font:

Font	Selects a font from the list.

Font Style	Selects a font style from the list.

Size	Selects a font size from the list.


File Print command
Print command (File menu)

Use this command to print a document.   This command presents a Print dialog box, where you may specify the range of pages to be printed, the number of copies, the destination printer, and other printer setup options.

Shortcuts

Toolbar:

Keys:	CTRL+P


File 1, 2, 3, 4 command
File menu commands

The File menu offers the following commands:

Command	Action	Toolbar Shortcut
Load Image...	Loads an image. Opens the Open File dialog box.
Reload Current Image	Reloads the current image.
Get File...	Downloads a file directly into memory. Opens the Open File dialog box.
Put File...	Copies a file onto the disk from memory. Opens the Save As dialog box.
Save Console Contents...	Saves the contents of the Console window. Opens the Save As dialog box.
Save RDI Log...	Saves the contents of the RDI log. Opens the Save As dialog box.
Exit	Exits the Debugger.


Clear RDI Log
Edit menu commands

The Edit menu offers the following commands:

Command	Action	Keyboard Shortcut
Copy	Copies data from a source file to the clipboard.	Ctrl+C
Paste	Pastes data from the clipboard into the Console window.	Ctrl+V
Delete	Deletes selected item.	DEL
Clear Console	Clears the Console window.
Clear RDI Log	Clears the RDI Log.


Goto
Search menu commands

The Search menu offers the following commands:

Command	Action	Keyboard Shortcut
Find...	Searches through memory, disassembly or source for specified text. Opens the Regular Expression Search dialog box.	Alt+F3
Find Next	Repeats a Find operation.	F3
Goto...	Moves to a specified line of source or memory address.	F4


View RDI Protocol Log
View menu commands

The View menu offers the following commands:

Command	Action	Toolbar Shortcut	Keyboard Shortcut
Registers	Displays a breakdown of the registers in a specified mode.
Variables	Displays the values of local and global variables, and expressions.
Local	Displays values of local variables.
Global	Displays values of global variables.
Expression	Evaluates a specified expression.
Immediate Evaluation	Displays the value of a selected variable.
Search Paths	Displays search paths for the source files.		Ctrl+P
Source Files	Displays source files which are part of the program.		Ctrl+F
Function Names	Displays a list of functions in the program.		Ctrl+N
Backtrace	Displays information about currently active procedures.		Ctrl+T
Memory	Views memory at a specified address. Opens the Memory Address dialog box.		Ctrl+M
Disassembly	Views memory in ARM-only format or Thumb-only format. Opens the Disassembly Address dialog box.		Ctrl+D
Low Level  Symbols	Displays all symbols in the image, including the ones in the C library.		Ctrl+Z
Breakpoints	Displays a list of breakpoints.		Ctrl+B
Watchpoints	Displays a list of watchpoints.		Ctrl+W
Console	Brings the Console window to the front.
RDI Protocol Log	Brings the RDI Log window to the front.
Debugger  Internals	Displays the internals of the Debugger.
Status Bar	Displays or hides the status bar.
Toolbar	Displays or hides the toolbar.


Set or Edit Watchpoint
Execute menu commands

The Execute menu offers the following commands:

Command	Action	Toolbar Shortcut	Keyboard Shortcut
Go	Starts execution of the program.		F5
Step	Steps through the program line by line.		F10
Step In	Steps through the program following the function calls.		F8
Step Out	Returns from the current location in a called function, to its originating code, immediately after the function call.
Stop	Stops execution of the program.
Show Execution Context	Centres the code in the Execution window on the current execution marker.
Toggle  Breakpoint	Sets or removes a breakpoint at the current execution marker.		F9
Toggle  Watchpoint	Sets or removes a watchpoint. This option is available for Memory windows and Variable windows. A watchpoint halts execution when the variable or memory location changes.		F11
Set or Edit  Breakpoint	Allows creation of a complex breakpoint.
Set or Edit  Watchpoint	Allows creation of a complex watchpoint.


Window menu commands

The Window menu offers the following commands:

Command	Action
Cascade	Arranges windows in an overlapped fashion.
Tile	Arranges windows in a non-overlapped fashion.
Arrange Icons	Arranges icons of minimized windows.
RDI Log Window	Brings the RDI Log window to the front.
Console Window	Brings the Console window to the front.
Execution Window	Brings the Execution window to the front.


Configure BlackICE
Options menu commands

The Options menu offers the following commands:

Command	Action	Toolbar Shortcut	Keyboard Shortcut
Set RDI Level	Specifies the amount of information displayed in the RDI Log window. This allows RDI messages to be monitored for debugging.
Add Search  Path	Adds a specified file to the search path.		Ctrl+A
Set Command  Line Args...	Allows you to change the command-line arguments passed to the program when it is executed.
Change Display  Format...	Allows you to change the number format of the current window, eg. to display hexadecimal values.
Disassembly  Mode	Selects ARM/Thumb, ARM-only or Thumb-only mode.
Toggle  Interleaving	Toggles between interleaving the source and machine instructions and displaying source only.		F7
Change Text  Font...	Changes the text font in all of the windows.
Profiling	Displays profiling information. Toolbar shortcut toggles profiling.
Configure  Debugger...	Displays the Debugger Configuration property sheet.
Configure EmbeddedICE...	Displays the EmbeddedICE Configuration dialog box.


Show Item Type
Item menu commands

The Item menu offers the following commands:

Command	Action
Indirect	Provides additional information about a current item.
Show Item Type	Displays the type of a selected item.
Show Local Variables	Displays the local variables for a particular context from a backtrace window.


Help menu commands

The Help menu offers the following commands:

Command	Action
Index	Displays an index of help topics.
Using Help	Provides general instructions on using help.
About WinDBG...	Displays the version number of this application.


Modify Item

This dialog box allows you to modiy the value of a selected item.


Variables and Debugger Internals

The Local and Global Variables and the Debugger Internals windows displays the variable names and contents or internal statistics for the Debugger. Click on the appropriate window entry below:

Variables window

Debugger Internals window


Variables

The Variables window displays the names and contents of global or local variables.

You can change the number format by choosing Change Display Format... from the Options menu.

Double-clicking on a value allows you to modify the value of a particular variable.

When you double-click on a value, the Modify Item dialog box appears.

Double-clicking on a variable name shows the type of the variable.


Low Level Symbols Window
Low-level Symbols

This window displays all of the low-level symbols in the image.

Double-clicking on a low-level symbol displays the disassembly at that location.


Breakpoint Window
Breakpoints

This window displays a list of all the breakpoints.

Double-clicking on the breakpoint location allows you to set or

edit a complex breakpoint. The Set or Edit Breakpoint dialog box is displayed.


Registers Window
Registers

This window displays a list of registers and their addresses.

The list may be for any of the following modes:

- User

- Fiq

- IRQ

- Svc

- Abort

- Undef

- FP

Double-clicking on a register value allows you to modify the contents of the register.


Watchpoint Window
Watchpoints

This window displays a list of watchpoints.

To set a complex watchpoint, choose  Set or Edit Watchpoint from the View menu.

The Set or Edit Watchpoint dialog box is displayed.


Source Files

This window displays a list of source files in your current project.

Double-click on the name of the file to read it.


Search Paths

This window displays any search paths. A search path is used by the Debugger to

find source files for source level debugging.

If you have built your program using command-line tools, you may need to add

search paths. If you have used the Project Manager, this is done for you.


Function Names

This window displays a list of functions in the image.

Double-click on the function to move to its location in the source code.


Backtrace

The Backtrace window displays information about all currently active procedures,

starting with the most recent. Double-click on the entry to display the source or disassembly.


Memory

This window displays a list of memory addresses and the contents at each address.

Double-click on the contents to modfiy the value. The Modify Item dialog box appears.


Source Window

This window displays source code.

Double-click on the code to set or edit a breakpoint.

The Set or Edit Breakpoint dialog box is displayed.


Disassembly Window

This window displays disassembly.

Double-click on the code to set or edita breakpoint.

The Set or Edit Breakpoint dialog box is displayed.


Debugger Internals

This window displays internal variables of the Debugger.

Double-click on a value to change the item's contents.

The Modify Item dialog box appears.

statistics	Displays cycle counts for the current program.

vector_catch	Indicates whether or not execution should be caught when various conditions arise.

%RUsPDAifE is the default value. Capitals indicate the condition is to be intercepted.

R	reset

U	undefined instruction

s	SWI

P	prefetch abort

D	data abort

A	address exception

i	IRQ

f	FIQ

E	error

cmdline	Displays the argument string for the debuggee.

rdi_log	Denotes that RDI logging is enabled if rdi-log is non-zero and serial line

logging is enabled if bit 1 is set (initially set to zero).

clock	Indicates for how many microseconds the current program has been executing.

memstats	Indicates how many reads or writes have happened to memory.

statistics_inc	Is similar to statistics but displays the difference between the current

statistics and those when the statistics variable was last read.

Note:	memstats and clock are only available when a memory map file is used.


File New command
New command (File menu)

Use this command to create a new document in The The ARM Project Manager.  Select the type of new file you want to create in the File New dialog box.  << Remove previous sentence if your application supports only one document type. >>

You can open an existing document with the Open command.

Shortcuts

Toolbar:

Keys:	CTRL+N


File New dialog box

<< Delete this help topic if your application supports only one document type. >>

Specify the type of document you wish to create:

<< List your application's document types here >>


 Open command (File menu)

Use this command to open an existing document in a new window.  You can open multiple documents at once.  Use the Window menu to switch among the multiple open documents.  See Window 1, 2, ... command.

You can create new documents with the New command.

Shortcuts

Toolbar:

Keys:	CTRL+O


Getting Files and Adding Search Paths

You can get a file or add aearch path using the Open dialog box.

The follwing options are avaialble:

File Name	Type or select the filename you want to open.

This box lists files with the extension you select in the List Files of Type box.

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

Drives	Select the drive in which the ARM Project Manager

stores the file that you want to open.

Directories	Select the directory in which the ARM Project Manager

stores the file that you want to open.

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


File Open dialog box


File Close command
Close command (File menu)

Use this command to close all windows containing the active document.  The The ARM Project Manager suggests that you save changes to your document before you close it.  If you close a document without saving, you lose all changes made since the last time you saved it.  Before closing an untitled document, The The ARM Project Manager displays the Save As dialog box and suggests that you name and save the document.

You can also close a document by using the Close icon on the document's window, as shown below:


File Save command
Save command (File menu)

Use this command to save the active document to its current name and directory.  When you save a document for the first time, The The ARM Project Manager displays the Save As dialog box so you can name your document.  If you want to change the name and directory of an existing document before you save it, choose the Save As command.

Shortcuts

Toolbar:

Keys:	CTRL+S


File Save As command
Save As command (File menu)

Use this command to save and name the active document.  The The ARM Project Manager displays the Save As dialog box so you can name your document.

To save a document with its existing name and directory, use the Save command.


File Save As dialog box

The following options allow you to specify the name and location of the file you're about to save:

File Name

Type a new filename to save a document with a different name.  A filename can contain up to eight characters and an extension of up to three characters.  The ARM Project Manager adds the extension you specify in the Save File As Type box.

Drives

Select the drive in which you want to store the document.

Directories

Select the directory in which you want to store the document.

Network...

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

<< Add other File Save As dialog box options depending on which ones your application chooses via the OFN_ flags of the OPENFILENAME structure used by the CFileDialog. >>


Undo/Can't Undo command (Edit menu)

<< Your application's user interface for Undo may differ from the one described below.  Modify this help text accordingly. >>

Use this command to reverse the last editing action, if possible.   The name of the command changes, depending on what the last action was.  The Undo command changes to Can't Undo on the menu if you cannot reverse your last action.

Shortcuts

Toolbar:

Keys:	CTRL+Z or

ALT-BACKSPACE


Redo command (Edit menu)

<< Write application-specific help here. >>


Cut command (Edit menu)

Use this command to remove the currently selected data from the document and put it on the clipboard.  This command is unavailable if there is no data currently selected.

Cutting data to the clipboard replaces the contents previously stored there.

Shortcuts

Toolbar:

Keys:	CTRL+X


Copy command (Edit menu)

Use this command to copy selected data onto the clipboard.  This command is unavailable if there is no data currently selected.

Copying data to the clipboard replaces the contents previously stored there.

Shortcuts

Toolbar:

Keys:	CTRL+C


Paste command (Edit menu)

Use this command to insert a copy of the clipboard contents at the insertion point.  This command is unavailable if the clipboard is empty.

Shortcuts

Toolbar:

Keys:	CTRL+V


Toolbar

The toolbar is displayed across the top of the application window, below the menu bar.  The toolbar provides quick mouse access to many tools used in The ARM Project Manager,

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

<< Add or remove toolbar buttons from the list below according to which ones your application offers. >>

Click	To

Open a new document.

Open an existing document.  The ARM Project Manager displays the Open dialog box, in which you can locate and open the desired file.

Save the active document or template with its current name.  If you have not named the document, The ARM Project Manager displays the Save As dialog box.

Print the active document.

Remove selected data from the document and stores it on the clipboard.

Copy the selection to the clipboard.

Insert the contents of the clipboard at the insertion point.

Reverse the last editing.  Note:  You cannot undo some actions.

Go to the first record in the current selection.

Go to the previous record in the current selection.

Go to the next record in the current selection.

Go to the last record in the current selection.


Status Bar command (View menu)

Use this command to display and hide the Status Bar, which describes the action to be executed by the selected menu item or depressed toolbar button, and keyboard latch state. A check mark appears next to the menu item when the Status Bar is displayed.

See Status Bar for help on using the status bar.


Status Bar

The status bar is displayed at the bottom of the The ARM Project Manager window.  To display or hide the status bar, use the Status Bar command in the View menu.

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 depress them, before releasing them.  If after viewing the description of the toolbar button command you wish not to execute the command, then release the mouse button while the pointer is off the toolbar button.

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 box

<< Write application-specific help here. >>


Choose Color Dialog
Choose Color dialog box

<< Write application-specific help here. >>


Edit Find Command
Find command (Edit menu)

<< Write application-specific help here. >>


Find Dialog
Find dialog box

<< Write application-specific help here. >>


Edit Replace Command
Replace command (Edit menu)

<< Write application-specific help here. >>


Replace Dialog
Replace dialog box

<< Write application-specific help here. >>


Edit Repeat Command
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


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. >>