\"  fhelp.roff from ObjectProDSP 0.2
\"  Copyright (C) 1994 1995, Mountain Math Software. All rights reserved.
\"  
\"  This file is part of ObjectProDSP, a tool for Digital Signal
\"  Processing design, development and implementation. It is free
\"  software provided you use and distribute it under the terms of
\"  version 2 of the GNU General Public License as published
\"  by the Free Software Foundation. You may NOT distribute it or
\"  works derived from it or code that it generates under ANY
\"  OTHER terms.  In particular NONE of the ObjectProDSP system is
\"  licensed for use under the GNU General Public LIBRARY License.
\"  Mountain Math Software plans to offer a commercial version of
\"  ObjectProDSP for a fee. That version will allow redistribution
\"  of generated code under standard commercial terms.
\"  
\"  This program is distributed in the hope that it will be useful,
\"  but WITHOUT ANY WARRANTY; without even the implied warranty of
\"  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
\"  GNU General Public License for more details.
\"  
\"  You should have received a copy of version 2 of the GNU General
\"  Public License along with this program. See file COPYING. If not
\"  or if you wish information on commercial versions and licensing
\"  write Mountain Math Software, P. O. Box 2124, Saratoga, CA 95070,
\"  USA, or send us e-mail at: support@mtnmath.com.
\"  
\"  You may also obtain the GNU General Public License by writing the
\"  Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
\"  USA.  However if you received a copy of this program without the
\"  file COPYING or without a copyright notice attached to all text
\"  files, libraries and executables please inform Mountain Math Software.
\"  
\"  ObjectProDSP is a trademark of Mountain Math Software.
\"  
.H 1 "Help Structure"
\".LINE \label{Sec:HelpStruc}


The help facility consists of the following:

.fi
.AL
.LI
Pull down menus at the top of most windows document the
main commands in the window. These commands can be accessed using
the pull down menus and with shortcut keys and mouse commands
listed in the pull down menus.
.LI
A subtree in the menu data base serves as an online
reference manual.
.LI
Confirmation and other messages are displayed in response to user
commands. You can control how much of this information is displayed
by changing the help level.
.LI
Help windows are available for many data base menu selections by
pressing the right mouse button.
.LI
All user defined objects are added to the menu data base.
You can list the objects you defined and their parameters.
.LI
Example DSP++ programs and ObjectProDSP sessions are provided.
.LE
.nf

.P
The multiple methods for providing information is intended
to make it quick and
convenient to obtain the information you need.

.H 2 "Pull down menus"

Most windows have pull down menus at the top.
To access a pull down menu click on it.
The first menu in each window is labeled `Help' and provides documentation
of the window. The others contain the main commands in the window.
These commands are accessible through the pull down menus and
though short cut keys and mouse buttons. Each menu item gives the short
cut keys for itself. The coding for key and mouse short cuts
is described in the
`pull down menu codes' selection from the `help' pull down menu
in the main window.

.H 2 "Help menu database tree"

.P
All selections in the menu data base have one line of help information
displayed when the cursor is over the help button. Many display a
short paragraph of information when the left mouse button is pressed.
Some display a help window when the right mouse button is released.

Selecting help in the top level of the menu data base provides access
to an online reference manual organized by topics.

.H 2 "Message levels"

.P
Selecting `help' and then `help levels' gives the menu of three available
help levels. The default, `help all', provides hints and confirmation
messages that may be helpful to the new user. `help confirm' confirms
most commands. `help none' only displays error messages.

Some messages are displayed redundantly in both the information window
and scrolled in the main window. This allows related messages such as
all those associated with a single statement to be collected. All
messages are preserved in a history file that can be viewed by selecting
`create DSP++ history window' from the `Data base' pull down menu.

.H 2 "State description"

.P
In building a DSP network you are defining objects in a global name space.
This space starts with some predefined objects.
These are primarily DSP processing nodes and facilities for generating
and displaying data. The real number
\".LINE $\pi$ is defined in the variable `Pi'.
pi is defined in the variable `Pi'.


.P
These objects are organized in a hierarchical tree structure.

.P
These description are accessible in the menu data base from
the
\".LINE \DppNm{objects} button.
`objects' button.


