⟦2a20d06c0⟧

TextFile

#Version
Release 0_8_0 Mon Aug 24 14:50:00 1992 by bwb

#File Menu
New			Create a new object. See "File New Menu" topic.
Browse			Open an object in read-only mode.
Open			Open an object for editing.  Dialog box for name
			unless an object is selected.
Close			Close an object.
Save			Save changes to an object.
Revert			Revert an object to the last saved version.
Print			Print an object or window on a printer.
Properties		Display and edit the properties of an object.
Copy File		Copy an object (or objects).
Move File		Copy an object (or objects), then delete the source.
Delete File		Delete an object (or objects).
Insert File		Insert contents of a file at the Environment cursor
			location. 
Run			Run a command (using a command window is often easier).
Exit			Logoff and terminate.

#File New Menu
Text File		Create a new text file and bring up an environment
			window in which to edit it.  Dialog box allows entry
			of file name.
Ada			Create a new Ada unit.  Cursor must be in a library.
World			Create a new world.  Dialog box allows entry of name.
Directory		Create a new directory.
Subsystem		Create a new subsystem.
Working View		Create a new Working subsystem view which will be a
			copy of an existing view.
Spec View		Create a new subsystem view containing only specs.
Release View		Create a release of a subsystem view.
Code View		Create a release of only the code of a subsystem view.
Switch File		Create a new compiler switch file.
Activity		Create a new activity file (maps subsystems to views).
Mailbox			Create a new mailbox.
Venture			Create a new venture (part of CMVC work orders).
Work Order		Create a new work order.
Work Order List		Create a new list of work orders.
System			Create a new System (a special kind of subsystem).

#Edit Menu
Cut			Delete environment selected text into the cut buffer.
Copy			Make a copy of selected text in the cut buffer.
Paste			Paste the contents of the cut buffer at the environment
			cursor.
Capitalize		Capitalize the selected region of text.
Uppercase		Make the selected region of text all uppercase.
Lowercase		Make the selected region of text all lowercase.
Make Into Comment	Make the selected region of text into an Ada comment.
Uncomment		Make the selected region of text (which should 
			be an Ada comment) not a comment.
Justify			Right justify the selected region of text.
Fill			Fill the selected region of text to the fill colunm.
Search/Replace
Typing Modes
Spelling		See "Edit Spelling Menu" topic.
Deselect		Clear any Environment selections and/or underlines.
Add Entry
Edit Entry
Delete Entry

#Edit Spelling Menu
Check Word
Check Image
Replace Word
Add Word To Dict
Learn Replacement
Next Spelling Error

#Navigate Menu
Next Underline		Advance the environment cursor to the next underline
			error or reference indicator.
Previons Underline	Move to the previous underline indicator.
Next Item		Move to either the next underline or prompt, whichever
			comes first.
Previous Item		Move to the previous underline or prompt.
Definition		Show the definition or contents of the object under
			the environment cursor.
Enclosing		Show the enclosing directory or object of the object
			under the environment cursor.
Other Part		If in an Ada spec, move to the body and vice-versa.
Top of Region 		Move the environment cursor to the beginning of the
			environment selected region.
Bottom of Region 	Move the environment cursor to the end of the selected
			region.
Home Library		Move to your home library (in !Users).
Resolve Name		Allow entry of a naming expression and display the
			object to which it resolves.

#Program Menu
Format			Format an Ada program unit. (pretty-print and make
			syntactically complete).
Complete		Complete a command (in a command window) or a selected
			statement in an Ada program unit.  Semantic completion
			of subprogram calls and parameters.
Semanticize		Check semantics of a command or Ada program unit.
Promote
Promote to Coded
Promote to Installed
Promote to Source
Denote
Demote to Installed
Demote to Source
Demote to Archived
Incremental		Incremental operations on Ada Objects,
			See "Program Incremental Menu" topic (next).
Show Usage		Given a selected Ada declaration, show all usages of
			that declaration.
Show Unused		Given an Ada program unit, show all declarations in it
			that are not used.
Build			See "Program Build Menu" topic.
Compiler Switches	Edit the switches for a world or subsystem view.
			Brings up a new window in which to edit the switches.

#Program Build Menu
Load 			Display a dialog box providing parameters to create
			a loaded procedure or function containing the code
			for an entire program.
Parse Source Files	Display a dialog box providing parameters for creating
			Ada program units from text files.
Build Private Part	With the environment cursor in a package spec, 
			construct the private part with prototype type 
			completions for private types.
Build Body		Construct a complete body skeleton or add declarations
			to an existing body given a package spec or a selected
			declaration within it.
Make Separate		Change a subprogram, package, or task body into a
			separate subunit.
Make Inline		Change a separate subunit into a simple body contained
			at the point where its "is separate" stub appears.
Withdraw

#Program Incremental Menu
Incremental Insert	Add a new declaration or statement into an installed
			or coded Ada program unit.  If the unit is coded,
			only comments may be added.
Incremental Edit	Edit a declaration or statement in an install (compiled)
			Ada program unit.  Some restrictions apply!
Incremental Promote	Given an incremental insertion or edited declaration,
			re-install the edited object.
Incremental Delete	Delete a declaration or statement from an installed
			Ada program unit.

#CMVC Menu
Check Out
Check In
Abandon
Accept Changes
Join
Sever
Imports/Model
CMVC Editor
Control/Uncontrol
Revert to Generation
CMVC Report		See "CMVC Report Menu" topic.
Activity
Add Activity Entry

#CMVC Report Menu
List Controlled
List Uncontrolled
List Out-of-Date
List Checked-out
List View Imports
List View Referencers
List View Exports
List View Model
Object History Information

#Debug Menu
Start Debugging of Command
Debugger Commands Palette
Debugger Window
Finish Debugging Job and Kill
Finish Debugging Job and Detach

#Session Menu
Profile
Search List
Session Switches
Jobs			See "Session Jobs Menu" topic.
End of Input
Screen			See "Session Screen Menu" topic.

#Tools Menu
Mail			See "Tools Mail Menu" topic
Analysis		not implemented
Design			not implemented
Target			not implemented
Test			not implemented
Macro 			See "Tools Macro Menu" topic
Operator		See "Tools Operator Menu" topic.
Files			See "Tools File Menu" topic.
System			Se  "Tools System Menu" topic.

#Tools Files Menu
Name/Version
Show Locks

#Tools System Menu
Users
Disk 
Configuration
System Load

#Tools Mail Menu
Read Mail
New Mail Message
Check Mail Message
Send Mail Message
Reply
Reply To All
Forward
Remail
Delete Mail Message
Undelete Mail Message
Expunge Mailbox
Sort Mailbox

#Tools Macro Menu
Begin Macro Def
End Macro Def
Execute Macro
Bind Macro to Key

#Tools Operator Menu
Backup
Verify Backup
Backup History
Create/Edit User
Create/Edit Group
Force Logoff
Report Generation
Shutdown System
Cancel Shutdown

#Help Menu
Explain Underline
On Command
On Key
On Mouse
On Keybindings
On Help
On Version
On Function Keys
On Getting Started
On Menu ...          (if you got here, you must know what these do!)
On Window Panel

#New Working View
A subsystem is a set of views each of which represents a version of
the subsystem.  Views can either be frozen release views or working
views in which development can occur.  This operation builds a new
working view.

A working view is created by copying some other view.  When the new
working view is created, its imports or model can be changed.  Otherwise,
they are inherited from the view being copied.

Name:		Simple name of the new view.  Must end in "_Working"
Join:		Specifies that object under CMVC control will be
		joined and share history and reservations (check-in/
		out).
Kind:		Views can be either spec-load or combined.  The kind
		is set by this option.

Copy Of:	A new working view is created by copying an existing
		view in the same subsystem.  Its simple name appears
		here.

Same Imports:	Keep the imports the same in the new view.
New Imports:    Change the imports to the specified list of views.
Comments:       Record the comments here in the CMVC database.
Model:		A number of view characteristics are determined by
		the model, including that target compiler to be
		used and a base set of units that will be visible
		in the view (but that are not contained in the view).

Hints
-----
	Pick names for views that somehow represent the work going on
	there, the version level, or who is working on the view.
	For example: Rev2_3_Working, Acme_Customization_Working,
	Rev2_Bob_Working.

#File New Textfile
Create a new text file with the name given.  If the default name is
not what you desire, edit it so that the name is correct.  Then click
OK to cause the file to be created. or click CANCEL to do nothing.


#File New World
A World is an Environment directory that represents an Ada library.
Worlds have links that point to other Ada units to be imported.  The
Model for a world specifies an initial set of imported units and
specify the Target Key, which says what compilation system should be
used for compilation is performed in a world.

#File New Directory
Create a new directory with the name given.  If the default name is
not what you desire, edit it so that it is correct.

There are two kinds of directory-like objects in the Environment: Worlds
and Directories.  Worlds represent Ada program libraries and have
access control information associated with them.  Directories are
simple divisions in the file space and do not represent differnt
program libraries or access control domains.

#New Spec View
Subsystems  consist of views that represent version of the subsystem.
Views can contain all of the Ada object or only the specification parts
of the Ada units (or even a subset of the Ada units).

New Spec View creates one of these views that contains only specs.
It is built by copying another spec view or a full view (working or
release).

Join:		Specifies that objects under CMVC control will be
		joined and share history and reservations (check-in/
		out).  
Copy Of:	A new spec view is created by copying an existing
		view in the same subsystem.  It's simple name appears
		here.

Same Imports:	Keep the imports the same in the new view.
New Imports:    Change the imports to the specified list of views.
Comments:       Record the comments here in the CMVC database.
Model:		A number of spec view characteristics are determined by
		the model, including that target compiler to be
		used and a base set of units that will be visible
		in the view (but that are not contained in the view).

#File New Subsystem
A Subsystem is a partitioning of a larger project.  It usually corresponds
to some layer, abstraction, object, or deliverable.  Each subsystem
has multiple versions called views.

When a new subsystem is created, an initial view is also created.

Name: 		The  path name of the subsystem.
Initial View Name:
		The simple name of the view to be created.
Model:		A number of view characteristics are determined by
		the model, including that target compiler to be
		used and a base set of units that will be visible
		in the view (but that are not contained in the view).
Kind:		Views can be either spec-load or combined.  The kind
		is set by this option.  With combined views, working
		views of different subsystems directly import and
		reference each other.  With Spec-Load subsystems,
		working and release views import spec views and provide
		recompilation fire-walls and andditional structure
		and control over major system interfaces.

Comments:       Record the comments here in the CMVC database.


#New Code View
A code-only view (or simple code view) contains a copy of  any non-Ada
objects in a working view but has only the code for Ada units in the view.
A code view is an object that is independent of its Ada source code and
can be copied to other machines.

Accessing a code view requires a spec view for the subsystem that is
compatible with the code view.  Clients compile against the spec view
and execute with the activity entry for the subsystem referencing
the spec view and code view.

Name:		Simple name of the code view.  Edit if the default is not
		what is desired.
Copy of:	The view from which the code will be produced.  Non-ada
		objects from this view are copied.
Comments:	Any comments which will be saved in the database.

#New Mailbox
A mailbox  is used to record mail messages from the Rational Network Mail
product.  A main mailbox (named Main) receives incomming mail from others.
Other mailboxes can be created to manage messages.  Messages must be
explicitly copied into these other mailboxes.

Name:		The simple name of the mailbox.  It will be created in the
		Mailbox  directory off of the user's home directory.
#New Venture
A venture is part of the work-order system.  See the PM book of the
Rational Environment Reference Manual for more details.

#New Work Order
Work Orders can be used to track and manage changes made to objects by
particular users.  See the PM book of the Rational Environment Reference
Manual for more details.

#New Work Order List
A work order list is a set of work orders.  See the PM book of the Rational
Environment Reference Manual for more details. 

#New System
A System is a set of subsystems used to comprise a larger  building block
or an entire system.  It is used primarly with the Design Facility product
(RDF).

#File Browse
The Browse operation is used to view an object "read-only" in an Environment
Window.

Name:		Enter the name of the desired object.  It will be displayed
		read-only.

#File Open, Demote?
You have asked to open (for editing) an Ada object.  The object is already
compiled to an Installed or Coded state and must be demoted in order to
be edited.  If there are other Ada units that "with" the unit to be edited,
they, too, must be demoted.  The number of units, subsystems, and lines
to be affected by editing this unit are displayed.

Click OK to proceed and demote the required units.
Click CANCEL not to.

#Check In
Objects under CMVC control must be checked-out in order to be modified.
After modification is complete, they should be checked-in so that
further changes cannot be made and so that the changes made
are available to other views and recorded in the CMVC database.

Check-in will check object(s) into the containing CMVC view.

#Print
Print one or more objects on the printer of your choice (provided
that your choice is working and connected to the R1000 spooling
system!).

Name:		Enter or alter the name of the object(s) to be printed.
		These can be files, Ada units, Mail message windows,
		I/O windows, etc.  If not an Environment directory object,
		then the Environment cursor must be in the window of the
		object to be printed  when OK is clicked.
Selected Printer:
		Select a printer from the valid list.

Chose the appropriate options and page numbers.

Press OK when ready to print, or CANCEL to abort the print request.

Hints:
	Your default printer appears in the Selected Printer box initially.
	Contact your system manager if you would like your default
	printer changed.

	Not all options are available for line printers.  They do apply
	for laser printers.

	If the printer you wish to use does not appear in the list, 
	then it has not been configured into the R1000 spooling
	system.  Contact your system manager.

	In a network environment, spooling may require contacting
	another R1000 or workstation.  If any of these machines are
	not  up at the time of printing, the print request may fail.

	The status of print requests can be checked by using the
	Queue.Display command with the machine name  of the R1000
	that has the spooler for the particular printer.

	Print requests can be cancelled with the Cancel_Print_Request
	command.

#File Properties
Objects have various properties.  File-Properties displays property
values for a selected object and allows some properties to be
updated.

Name:		The name of the object initially, and the name of the
		object(s) to update if changes are made and OK clicked.
Frozen:		The object is frozen.  Frozen objects cannot be modified.
Under CMVC Control:
		Objects within subsystem views can be controlled.  If
		so, they can only be modified when checked out and
		CMVC keeps track of modification history information.
Checked Out:	If under CMVC control, the object is currently checked
		out.
Access List:	The access list for the object.  Specifies which groups
		have what kind of access (Read or Write) to the object.

You can change Frozen, CMVC information, and the access list.  Click OK
to apply these changes.

#Run Program
Use this to execute commands on remote machines, or on your current 
machine.  The full, syntactically correct Ada command to be executed
must be entered.

To run a local command  with debugging, check the Debug box.  Commands
cannot be run under the debugger on an alternate machine.

Press OK to execute, CANCEL to abort this request.

Hints:
	Use command windows for running local commands.  It is much 
	easier.  Syntax and semantic assistance is available in
	command windows.  Press F6  to create a command window, and
	control+Return to execute it normally, and Meta+Return
	to execute it under the debugger.

#New Release View
Create a new subsystem view that is a release of a specified view.
The new release will be frozen.  It is possible to save only
database information about a release and not create a full copy
(see below).

Name:		The simple view name of the release.
Kind:		The kind of view to create: either spec-load or
		combined.
Join:		Controls whether controlled objects in new view 
		share history with the source view.
Same Imports:	Imports in the new release view are the same as in
		the view being released.
New Imports:	Imports in the new view are specified.
Comments:	Recorded in the CMVC database.
Model:		Controls target compilation and base units visible.

Build Full View Copy:
		Create a full subsystem view with a copy of each object.
Save Source in Database Only:
		Do not create a full view.  Record information in the CMVC
		database about the current version of all controlled
		objects.  This can be used later to create a full view
		provided that all needed objects are under CMVC control.

Hints
-----
	The name of the view should contain some indication of the version
	or date or purpose.  

#New Switch File
Create a new library switch file.  A library switch file controls
various compilation and other options.  It is associated with the 
world that contains it.

This should not be used in a subsystem view.  The view already has
a switch file.  Use the Compilation-Options  menu to edit switches.

#New Activity
Create a new activity object.  Activities specify, for a set of
subsystems, spec and load views that can be used for execution.
When a program is executed, each of the spec views referenced in the
program is determined.  Then the activity is used to determine,
for each spec view, which load view will actually be used.

Name:		The name of the activity to be created.
Copy Of:	The initial contents of the activity is based
		on this.  Can be null.
Exact Copy Preserving References:
		If the "Copy Of" activity had references, preserve them
		in the new activity.
Exact Copy Replacing references with values:
		If the "Copy Of" activity had references, de-reference
		them and use the current value in the new activity.
Differential:	The new activity is build  with all entries being
		indirect references to the "Copy Of" activity.  If this
		activity is changed, the new  activity tracks the changed
		value.

#File Open
Open a file or object for editing.  Subsequent dialog boxes
will appear if the object is under CMVC control and needs
to be checked out, or if the object is an Ada  object and
needs to be demoted.

#File Open, Check Out?
You have asked to open a particular object for editing.  The object is
under CMVC control and is not currently checked out.  Click OK to go
ahead and check the object out.  Click CANCEL to abort and not edit the
object.

You can scroll the text by draging a selection left or right across it.

#File Copy
Make a copy of the source object or objects.  Edit the destination to be
wherever is desired.  The destination can be another object name (existing
or not) or a library name.  If the destination is a library, then the
source objects are copied into the library under their original names.

#File Move
A File Move is a copy followed by a delete of the source objects.
Be careful as the deleted objects are not recoverable.

#Delete
Delete the specified object(s).

Related Environment Commands:
-----------------------------
Library.Expunge
Library.Destroy
Library.Delete
Compilation.Destroy
Destroy_Library
Cmvc.Destroy_View
Cmvc.Destroy_Subsystem

#Delete Confirm
You have requested that a certain object or objects be deleted.  The number
and kind of objects that will be deleted are summarized in this message
and you must click OK to confirm and perform the deletion.

The deleted objects are not recoverable.

#Resolve Filename
Given a name (possibly) containing wildcard characters, produce a 
list of the objects to which the name will resolve.

Related Environment Commands:
-----------------------------
Library.Resolve
Directory_Tools
Directory.Naming.Resolve

#Promote
Promote the specified Ada unit(s) to a higher compilation state.  Units can be 
in states:

	Archived:	source text only is stored
	Source:		the unit is not compiled and can be edited.
	Installed:	the unit is syntactically and semantically
			consistent, and installed within and known to
			the system.
	Coded:		In addition to being installed, code has been
			generated for the unit and it can be executed
			if all other units it needs are also coded.

When compiling, what will be compiled  will be based on the alternatives:

	This unit only:	Compile only this unit
	This and prerequisite units in the same world or view:
			All specs within the same world or view are
			also compiled to the specified state.
	This and prerequisites anywhere:
			All specs needed for the with-closure are
			also compiled.
	This unit, prerequisites anywhere, and bodies:
			All units known to be required to execute the
			unit are compiled.

#Demote
Ada units that are compiled are said to be in the installed or coded state.
To be edited, they must be in the source state (except for incremental
editing).  To demote a unit to source, the Demote operation is used.

Demotion is transitive to referencers.  You can control whether
demotion will occur based on buttons in the dialog box.  If demotion
of the specified unit(s) would require demotion of other dependent 
units not allowed by the condition selected (unit only, only units 
in the same world or view, any unit anywhere), the operation will fail.

#Load Main Program
Ada programs are usually integrated  with the source and intermediate
representation.  It is possible to build an object that contains only
the code for a program.  These objects are called "load_procs" or
"load_funcs".  

Load Main Program constructs one of these objects from an existing
main procedure or function.  (A main procedure or function contains
a "pragma main" following its spec or body.)

Debugging of load_procs is still possible as long as the source from
which it  was built is present and unchanged.  After that, debugging
is very limited.

#Parse Source Files
In the Environment, Ada programs are stored as specially formatted
objects and are, in particular, not text files.  If you have one or
more text files containing Ada source and wish  to construct Ada
objects within the Environment for them, use this operation.

Source File(s):	A naming expression identifying the files containing
		the source text.
Destination Directory:
		The R1000 library that will contain the new Ada objects.

#Check Out
Check-out objects that are under CMVC control.  This allows them to be
edited.  In order to check an object out, it must be up-to-date.
Prior to completion, Check Out will update the object as needed.

Name:		The name(s) of the object(s) that are to be checked out.
Comments:	Information that will be associated with this generation
		of the objects in the CMVC database.
Automatic Demotion If Needed:
		The object(s) may need to be updated to the latest generation
		to be checked out. Setting this button allows the Accept Changes
		operation to do any demotion required to complete this update.
		If not set and demotion is needed, the Check Out will fail.
Automatic Accept Latest Generation:
		The object(s) may need to be updated to the latest generation
		to be checked out. Setting this button allows the Accept Changes
		to do this.  If not set and the update is needed, the Check Out
		will fail.

#Accept Changes
Update some or all objects in a view that are under CMVC control.

You can specify that all object be updated, or that specific objects
be updated.  To add new objects that are not present in the view,
you must check that all units be updated.

The source of the update can be either the "latest" generation, or the
generation present in a specific view or configuration.  You can select
the view or enter its name.

Note: if a configuration is named, objects will be updated to the
generation specified in that configuration even if it is older than
the current generation of that object.  If a view is named, objects
will not be updated if their current generation is later than that
in the view to update from.

#Join Controlled CMVC Objects
Join the version group of a controlled object (or objects) to another
view.  

Note that if the object is currently joined, it will first be
severed.  Thus, joining object A in view V1 to V2 is not necessarily
the same as joining object A in view V2 to V1.

#Sever Controlled CMVC Objects
Disconnect specified objects from a common group that shares history.

#View Imports
Update the imports or model of a view.  The current imports are displayed.
Individual items can be selected and copied into the Add/Change box or the
Remove box by clicking the arrow button.  Once in the Add/Change box or 
Remove box, the entries can be edited as text.

All units must first be demoted to source if the model is to be updated.

Check Refresh Imports if the imports are to be refreshed from the current
values when no other changes are made.

Related Environment Commands:
-----------------------------
Cmvc.Import
Cmvc.Remove_Import
Cmvc.Replace_Model

#Activate Breakpoint
Breakpoints can be active or inactive.  If inactive, the breakpoint information
is saved by the debugger, but the breakpoint is not installed in the
program.

Activate Breakpoint will install the breakpoint in the program being
debugged.

#Remove Breakpoint
Remove a breakpoint, making it either inactive or deleting it entirely.
Breakpoints can be inactive in which case the debugger saves the information
about the breakpoint but it is not installed in the program being debugged.

#Set Breakpoint
Set a breakpoint in a specific location in the program being debugged.  It
can apply to a specific task or all tasks.  It can be in a specific generic
instance or apply to all instances, and it can be set to trigger  on the
nth execution of the statement at which it is placed.

#Debugger Control Context
The debugger maintains a context that identifies a task to which debugging 
actions will apply.  The context can also be set to null in which case
debugging actions apply to the last task to stop, or to all tasks,
whichever is appropriate for the specific debugger action.

#Modify Variable
The named variable is modified to have the specified new value.  The name
that appears in Name may not be valid in which case the string "<Selection>"
should be substituted.

Not all variables can be modified.  Only scalars can be modified.  Array
elements and record components can be if they are themselves scalars.

Consult the DEB book of the Environment Reference Manual for more details.

#Terminate Debugging
Terminate a debugging session.  The job being debugged can either be killed
or allowed to continue execution without the debugger.  The debugger itself
can also be killed.  This is normally not done unless the debugger is
malfunctioning or no further use of it is planned.

#Job Enable/Disable/Kill
Enable, Disable, or Kill a job.  

Killing a job terminates it immediately.
Disabling a job stops its execution.
Enabling it re-enables its execution if it has been disabled.

#Backup
Take a backup of the system.  Requires operator capability.

Starting Time:		The time that the backup is to begin
Full:			A complete backup of the entire system is
			to be taken.
Incremental:		An incremental backup relative to the last
			full backup is taken.  It is generally much
			smaller than a full backup.

#Verify Backup
Read a backup tape and perform some validity checks.

#Create/Edit Group
Create or alter the characteristics of a group.  A new group can be created,
an existing group modified, or an existing group deleted.

Group:		The name of the group to create/modified/delete.
Add Users:	Users that will be added to the group.
Remove Users:	Users that will be removed from the group.

#Force Logoff
Log off a session other than your own.  Operator capability is required to
logoff a session belonging to another user, but you can log off a session
that belongs to you.

You need to know the physical line to which the session is logged in.  Run the
Session - Users menu item to get this information.

Physical Line:	The line to which the user is logged in.
Commit Buffer:	Whether to attempt to write out any file the session has
		open currently, before it is logged off.

#Rational Shutdown
Shutdown the R1000.  Logs off all users and performs an orderly shutdown.
Required operator capability.

The reason and explanation information are entered into the system error
log file.

#Getting_Started
Things to know:
1. You can run commands from a command window.  Press F6 to create one.
   Type the command in (it is an Ada statement, typically a procedure call).
   Press commit (Ctrl+Return) or Promote (F11) to execute it.

2. To detach a running  command  so you can do other commands, press Ctrl+G.

3. To abort the running command, type Meta+G.

4. The Environment uses a selection model disjoint from that of Motif.
   Environment commands do not work on Motif selections and vice-versa.


#HelpOnVersion
This shows the current version of Rational Access

#Control/Uncontrol
Place an object or objects under CMVC control, or remove them from CMVC
control.

View:		Full name of the view in which objects are to be controlled
		or uncontrolled.
All:		Check this button to control all objects  in the units
		directory of the view.
All Ada Units:	Check this button to control all Ada program units in the
		units directory of the view.
box:		Check this button and fill in the name of the objects to
		be controlled.  This name is relative to the view and must
		include the "units" directory name if that is where the
		object(s) are.  Wildard and set notation can be used in the
		name.

Control:	Check this box to control the objects
Uncontrol:	Check this box to make the object(s) uncontrolled.

Once uncontrolled, all history information may be lost.

#Revert
CMVC Revert.  Revert a controlled CMVC object to some specific generation.
Enter -1 for the generation number to revert to the immediately preceeding
generation.

Create new latest generation:
		Check this button to make a copy of the reverted generation
		at the end of the current history, effectively making
		a new latest generation that is a copy of an old generation.

#New System

#Log Profile
Each session has a default profile and each job run under a session
inherits the session profile as a default.  The profile contains 
information mostly about what kind of log messages commands and
programs should generate.  There is also information about what
action commands should take in case errors are detected, what
activity should be used for finding load views that correspond to
spec views when programs are loaded, and what accounts, passwords,
and sessions should be used when workstations are accessed from the
R1000.

Each log message has up to 3 prefixes.  These are generally the
date, time, and symbols indicating what kind of message  a log
message is.   There is a filter that allows or eliminates certain
kinds of messages.

Prefix:		The three prefixes that appear in front of each log 
		message
Reaction:	What the command should do in case of error.
Log File:	Where log messages should be sent.
Width:		The line width (used for wrapping lines).
Filters:	Which kinds of messages are kept.
Activity:	The activity used for execution of programs
		involving multiple subsystems.
Remote Passwords File:
		The file containing the account and passwords for 
		workstation access.
Remote Session File:
		The  file containing session information for 
		workstation access.

#Function Bar
This spiffy widget allows you to do all the function-key operations with just 
the mouse. And you don't need to tape a cheat sheet to your keyboard.

#Function Keys
	Unmodified			Shifted
   ---------------------------- --------------------------------
F1	Help			Prompt-for
F2	Open/Edit		Demote
F3	Explain underline	Underlines off
F4	Check Out		Check In
F5	Definition		Definition, in place
F6	Command Window		Complete Command or statement
F7	Enclosing		Enclosing, in place
F8	Promote			Code
F9	Format			Semanticize
F10	Menu Bar		Home Library
F11	Create Text file	Create Ada Unit
F12	Next item		Previous item

Item/Operation keys
Ctrl+F1 (Object) !		Expand
		 >		Elide
		 ?		Explain
		 a		First Child 
		 c		Copy
		 d,k		Delete
		 e		Last Child
		 g		Abandon
		 h		Parent
		 i		Insert
		 j		Child
		 m		Move
		 n		Next
		 r, v		Redo
		 s		Sort
		 u		Undo
		 x		Release
		 Tab		Tab - to - Comment
		 Return		Commit
		 Up		Previous
		 Down		Next
		 Left		Parent
		 Right		Child

Ctrl + F2 (Region)
		^		Capitalize
		[		Start
		]		Finish
		=		Uncomment
		<		Lowercase
		-		Comment
		>		Uppercase
		a		Beginning of
		c		Copy
		d, k		Delete
		e		End of
		f		Fill
		h		Hold-stack previous
		j		Hold-stack Next
		m		move
		n		Hold-stack Push
		p		Hold-stack copy top
		q		Justify
		r		Hold-stack rotate
		t		Hold-stack swap
		u		Hold-stack top
		x		Region offf
		Delete		Hold-stack delete top
		Up		Hold-stack Top
		Down		Hold-stack Push
		Left		Hold-stack Previous
		Right		Hold-stack Next
Ctrl + F3 (Window)
		!		Expand
		.		Contract
		?		Directory
		a		Beginning of
		c		Copy
		d, k, w, x	Delete
		e		End of
		f		Focus/Format
		h		Enclosing object
		j		Join
		m, z, Return	Promote
		n, Down		Next
		o, Delete	Join with prev
		t		Transpose
		u, Up		Previous
		v, Right	Child
		Y		Demote
		Left		Parent
Ctrl + F4 (Image)
		a, b		Beginning of
		e		End of
		f		Fill mode on
		H, Left		Left Scroll
		i		Insert mode
		j, Right	Right Scroll
		n, Down		Image Scroll Down
		o		Overwrite mode
		u, Up		Scroll Up
		x		Fill mode off
Ctrl + F5 (Line)
		$		Center
		<		Lowercase
		>		Uppercase
		?		What.Line
		a, b		Beginning of
		c		Copy
		d		Delete
		e		end of
		i		insert
		j		join
		k		Line delete forward
		o		open
		t		transpose
		Delete		Delete line bwd
Ctrl + F6 (Word)
		<		Lowercase
		>		Uppercase
		?		Check spelling
		^		Capitalize
		a, b		Beginning of
		d		delete
		e		end of
		i		add word to dictionary
		k		delete forward
		m		Check spelling on image
		n, Down		Explain next spelling error
		r		Learn spelling replacement
		t		Transpose
		w		Go to speller window
		Delete		Delete word back
		Ctrl+0..Ctrl+9  Speller Exchange word (nth word)
		Left		Word Previous
		Right		Word Next

Ctrl + F7 (Mark)
		(, a, b, [, {	Macro start definition
		), e,    ], }	Macro end definition
		f		Macro bind
		h, Left		Mark Previous
		j, Right	Mark Next
		m, x, Return	Macro execute
		n, Down		Mark Push
		p		Mark copy top
		r		Mark rotate
		t		mark swap
		u, Up		Mark Top
		Delete, Backspace
				Delete Top


#Object Operations
This is the help box associated with the "Object Operations" box popped up in
response to the "Object" button on the Function Bar.
#Region Operations
This the help associated with the "Region Operations" box popped up when the
"Region" button on the Function Bar is pushed
#Window Operations
This is the help associated with the "Window Operations" box popped up when the
"Window" button on the Function Bar is pushed.
#Image Operations
This is the help associated with the "Image Operations" box popped up when the 
"Window" button on the Function Bar is pushed.
#Line Operations
This is the help associated with the "Line Operations" box popped up when the 
"Line" button on the Function Bar is pushed.
#Word Operations
This is the help associated with the "Word Operations" box popped up when the
"Word" button on the Function Bar is pushed.
#Mark Operations
This is the help associated with the "Mark Operations" box popped up when the
"Mark" button on the Function Bar is pushed.
#Button Panel
The area below the row of icons near the top of the display is for user-created
buttons.

The area may be exposed by pulling down on the sash jsut below the rightmost
icon. Usually the system automatically makes all defined buttons visible.

Buttons are created by holding down the <CTRL> key while making a selection 
from a menu.  Pushing the button is equivalent to making the menu selection.

Buttons are destroyed by holding down the<CTRL> key while pushing the button.

Changes to the Button Panel may be preserved across sessions by choosing 
Session:Screen:Save_Button_Panel from the menu.

#Session Jobs Menu
Jobs
All Jobs
Connect to Job
Disconnect Current Job
Disable Job
Enable Job
Kill Job

#Session Screen Menu
Screen Push
Screen Pop
Window Frames
Save Button Panel
FullReset
Rational Mode
Inverse Video
Visual Bell
#Insert File
Help for the dialog box popped up by choosing Insert File from the Edit Menu.
#Cmvc History
CMVC:CMVC Reports:Object History Information dialog box
#Debugger Evaluation Context
Debug:Context:Set Evaluation Context
#Set Window Frames
I'm not sure what this is supposed to do. As of 0_5_0 it doesn't do what I
guessed it should do, so it either needs a help entry or fixing.
#Sort Mail
Discussion of the various ways the contents of a mail box may be sorted.
#Create/Edit User
Create a new user, modify characteristics of an existing user, or delete a
user.  Other than modifying your own password, these operations require
operator capability.

The diamond-shaped radio buttons at the bottom control whether a new user
will be created, an existing user modified, or an existing user deleted.

Leave entries blank if no change is intended.

User:		The name of the user to be created/modified/deleted.
New Password:	If creating or modifying, specifies the password for the user.
Old Password:   If modifying and you do not have operator capability, the
		old password is required.
Add to Group:	Groups to which the user should should be added.  Separate the
		list item with commas.
Remove from Group:
		Groups from which the user should be removed.  Separate the
		list items with commas.
Create Mailbox: Create a mailbox for the user if one does not exist.


#System Report
Generate a report on system characteristics.  See the System Manager's Guide
for details of report contents and formats.


#Key Bindings
Key Control		Meta		Control+Meta
-- -------------------  --------------- ---------------
A  beginning of line
B  cursor bwd		Debug menu
C  Copy Region		Command Window 	Copy line
D  Delete next char	Delete word	Delete Line
E  End of line		Edit Menu	Window Demote
F  Cursor fwd		File Menu	
G  Interrupt		Kill Job
H  Cursor left		Help Menu	
I			Navigate Menu
J  Cursor right		Word next	
K  Delete to EOL	Delete to EOW	Window  kill
L  Repaint		Clear screen	
M  Push Mark		CMVC Menu	Goto Mark

Key Control		Meta		Control+Meta
-- -------------------  --------------- ---------------
N  Cursor Down		Next Item	Next Window
O  Open new line	Tools menu
P			Program Menu	Window promote
Q  Key name quote	Prompt-for
R  Search Reverse	        	Replace Previous
S  Search Next		Session Menu	Replace Next	
T  Transpose chars	Transpose Word	Transpose line	
U  Cursor up		Previous item	Window Previous
V  Image down		Image Up
W  Region Delete
X  Region Unselect	Macro execute
Y  Region Yank/Paste    Yank next
Z  Image up

Key Control		Meta		Control+Meta
-- -------------------  --------------- ---------------
<  Word lowercase	Image beginning	Prev Cmd/Hist Gen
>  Word Uppercase	Image end-of	Next Cmd/Hist Gen
[  Region Start		Macro Start
]  Region End		Macro End
!			Expand/Change	Window Larger
@  Mark Push		RDF annotation
^  Word Capitalize
)			Elide display	Window Smaller
=			Macro Bind to key
\  Region Unselect
-  argument prefix -
0..9 argument prefix
"  Quote next character
/,?			Explain

Key    Plain	     Shift 	     Control	     Meta	       Ctrl + Meta
-----  ---------     --------------  --------------- --------------    -------------
Return 				     Commit/Execute  Debug
Up     Cursor up     Image up	     Select Prev     Prev item	       Window up
Down   Cursor down   Image down	     Select Next     Next item	       Window down
Left   Cursor left   Image left	     Select	     Prev word	       Enclosing IP
Right  Cursor right  Image right     Select last     Next word	       Definition IP body
Tab    Next tab stop				     Motif next win    What.Tabs
Home   Line Beginning Image begin    Line info	     		       Window Beg of
End    Line End	     Image end	     End-of-Input		       Window End of
Delete Del Prev Char Region Delete   Delete to EOL   Delete Prev Word  Delete Whitespace


#Mouse Bindings
		Left		Middle		     Right
--------------	---------------	-------------------- -----------------------
Click		Position Cursor	Motif Selection Copy 
Shift-Click	Motif End Select 
Click and Drag	Motif Selection

Double Click	Definition			     Enclosing
Sh-Double Click	Definition-IP			     Enclosing-IP

Ctrl-Click	Region Start	Region Copy	     Region End
Ctrl-Dbl Click	Select Parent                        Select Child
                 Object                               Object
Ctrl-Click&Drag	Region Selection

IP = in place (same window)

#Left Arrow Button
Slide the window to the left over the image if the image margin is not already 
visible.

This button is bound to "Editor.Image.Left".

#Right Arrow Button
Slide the window to the right over the image if the image margin is not already 
visible.

This button is bound to "Editor.Image.Right".

#Top of Image Button
Make the first line of the image the top line of the window.

This button is bound to "Editor.Image.Beginning_Of".

#Bottom of Image Button
Display a portion of the image that includes the last line.

This button is bound to "Editor.Image.End_Of".

#Split Window Button
Divide the current window into two.

This button is bound to "Editor.Window.Copy".

#Window Join Down Button
Add the real estate of the window below the current window to the current 
window.

This button is bound to "Editor.Window.Join".

#Window Join Up Button
Add the real estate of the window above the current window to the current 
window.

This button is bound to "Editor.Window.Join(-1)".

#Expand Window Button
Make the current window larger.

This button is bound to "Editor.Window.Expand".

#Shrink Window Button
Make the current window smaller.

This button is bound to "Editor.Window.Expand(-4)".

#Even Windows Button
Make all the windows the same size.

This button is bound to "Editor.Window.Focus".

#Lock Window Button
Make current window resistant to attempts to remove it from view.

This button is bound to "Editor.Window.Promote".

#Unlock Window Button
Make the current window eligible for removal from the screen.

This button is bound to "Editor.Window.Demote".

#Show Image Palette Button
Display the image palette.

#Show Function Bar Button
Display the function key palette.

#Show Debugger Palette Button
Display debugger palette (same as Debug:Debugger Commands Palette...).

#Hide Button
Remove the current image from view.

This button is bound to "Editor.Window.Delete".

#Fill Screen Button
Make the current window the size of the entire Environment area (less the
message window).

This button is bound to "Editor.Window.Join(Repeast=>99)".

#Window Control Button Panel
The buttons in the panel just below the Menu Bar manipulate Environment windows
and call up Rational Access auxiliary windows.

For help on a specific button, position the question arrow over the button and 
press mouse button 1.

To exit from button-help mode, close this box or click mouse button 1 in an 
Environment window.

From left to right, the buttons in the row just beneath the Menu Bar are:

Up Arrow Button
Down Arrow Button
Left Arrow Button
Right Arrow Button
Top of Image Button
Bottom of Image Button
Split Window Button
Window Join Down Button
Window Join Up Button
Expand Window Button
Shrink Window Button
Even Windows Button
Lock Window Button
Unlock Window Button
Show Image Palette Button
Show Function Key Palette Button
Show Debugger Palette Button
Hide Button
Fill Screen Button

Note: Each of the button names is a valid help topic entry. 
      "Help:On Window Panel" provides a means of getting help for a specific 
      button by pointing at it.

#Up Arrow Button
Slide the image in the window down, so a portion closer to the top is
displayed. There will be overlap between what is currently visible and 
what is visible after the operation. The operation never moves the
first line of the image lower than the first line of the window.

Operation is the same as the <Page Up> key.

This button is bound to "Editor.Image.Up".

#Down Arrow Button
Slide the image in the window up, so a portion closer to the bottom is 
displayed. There will be overlap between what is currently visible and what 
is visible after the operation. The operation may move the last line of the 
image through the window.

Operation is the same as the <Page Down> key.

This button is bound to "Editor.Image.Down".

#Rational Environment Help
This is an interface to the Environment's online Help and to Access Help
available locally. Specifically, when "OK" is pushed, the contents of the 
"Selected Topic" box are sent to the Environment (where the string becomes 
the argument for What.Does), or to Rational Access Help.

You may type directly into the "Selected Topic" box or choose a topic from the
"Filtered Topics" list (built when you push the "Filter" button). Topics 
beginning with '#' are sent to the Rational Access Help. Al others are sent
to the Environment.

There are two ways to select a topic from the list. Simplest is positioning the
cursor over the desired topic and clicking the left mouse button. You may also
use the Search box: enter a pattern in the box and push the uparrow button (if
you wish the search to proceed from the current selection toward the beginning
of the list) or the downarrow button (if you wish to search from the current 
selection toward the end of the list). If the search is successful, the topic
becomes the current selection (is highlighted) and is copied to the "Selected
Topic" box. If the search is not successful, the current selection in the list
is not changed, and a message appears in the "Selected Topic" box.

Search patterns may include the following pattern-matching wildcards: 
	?, %	match any character
	{, }	match beginning and end of line, respectively
	[xyz]	means "the character in this position is x or y or z"
	\	means "the following character is not a wildcard, even if it
		looks like one"
	*	means zero or more occurrences of the preceding character
	@	is a synonym for "?*" (zero or more occurrences of anything)
Searching is NOT case sensitive. An empty search pattern matches nothing.

The "Filters" box selects a subset of the more than 2000 available topics for
display in the "Filtered Topics" list. The "Topic" menu allows you to restrict
the displayed topics to a single volume of the Environment Reference Manual.
Locally available help is included in the "#Rational Access" book.
The "Pattern" restricts the displayed topics to those containing a string
matching the pattern entered.  Note that the default is to accept any topic
containing any string from all volumes of the reference manual: every topic.

The dialog box is not popped down until the close button is activated.

#Image Palette
The bottom section of this box is a list of all images in your session. It is 
refreshed when the box is made visible and when the "Refresh" button is pushed.
Double-clicking on an entry in this list makes the image visible in a n
Environment window and moves the cursor to it. The Search Box (just below the
row of buttons) may be used to locate a specific entry in the list: enter a 
pattern in the box and push the uparrow button (if you wish the search to 
proceed from the current selection toward the beginning of the list) or the 
downarrow button (if you wish to search from the current selection toward the 
end of the list). If the search is successful, the topic becomes the current 
selection (is highlighted). 

Search patterns may include the following pattern-matching wildcards:
        ?, %    match any character
        {, }    match beginning and end of line, respectively
        [xyz]   means "the character in this position is x or y or z"
        \       means "the following character is not a wildcard, even if it
                looks like one"
        *       means zero or more occurrences of the preceding character
        @       is a synonym for "?*" (zero or more occurrences of anything)
Searching is NOT case sensitive. An empty search pattern matches nothing.

You may copy image names from the lower section into the favorite-images
section by selecting the name in the lower section then pushing the "Add"
button. Names may be removed from the favorite-images section by selecting
the line then pushing the "Remove" button. Double-clicking on a line in this
section has the same effect as in the lower section.

#Just-Do-It Mode
If the Meta key is down when certain menu selections are made, Access will
suppress the associated dialog box and behave as if the "OK" button had been
pressed with no changes made to the options presented. Just-Do-It mode is
supported for:

	File:Print
	Program:Promote to Coded
	Program:Promote to Installed
	Program:Promote to Source
	Program:Demote to Installed
	Program:Demote to Source
	Program:Demote to Archived
	CMVC:Accept Changes
DataMuseum.dk

Rational R1000/400 Tapes

⟦2a20d06c0⟧ TextFile

Derivation

TextFile
