home *** CD-ROM | disk | FTP | other *** search
/ Programmer's ROM - The Computer Language Library / programmersrom.iso / ada / pdl / gadhelp.hlp < prev    next >
Encoding:
Text File  |  1988-05-03  |  42.5 KB  |  1,182 lines

  1.  
  2. A.  ON-LINE HELP FILE 
  3.  
  4. The HELP file supplied with the GAD software is an ASCII text file
  5. that is capable of modification by the user.  The following text
  6. description is contained in the file and briefly describes how to
  7. change the file if desired.  It should be noted that a re-
  8. compilation of the GAD software is not required when this file is
  9. modified.  The help file is labeled as GADHELP.HLP in the release
  10. library.
  11.  
  12.         --
  13.         -- Instructions for generating/modifying the help file:
  14.         --   1) Page separators must be used to differentiate the
  15.         --      various menu and command help text pages.
  16.         --      For DEC Ada the page separators are <FF>
  17.         --   2) The first line subsequent to the page separator must
  18.         --      contain the menu or command identifier with the string
  19.         --      beginning in the first column
  20.         --   3) The menu or command identifiers must correspond to the
  21.         --      MENU_ID or COMMAND_TYPE enumerated values in package
  22.         --      MMI_PARAMETERS; the 'IMAGE attribute is used
  23.         --      to generate the search string.
  24.         --
  25.  
  26. The following paragraphs are organized numerically according to the
  27. placement of the menu in the organization of the control menu
  28. network.
  29.  
  30. The HELP option is implemented in a toggle switch fashion.
  31. When the HELP option is first selected, control is transferred to
  32. the help processor software and remains there until the HELP option
  33. is again selected.
  34.  
  35. Each description is divided into the initial display when HELP is
  36. initially requested for a particular menu; and into the subsequent
  37. menu option displays when for a particular selection option, while
  38. in the HELP processor, from the menu.
  39.  
  40. A.1  Main Menu Descriptions
  41.  
  42. Upon selecting the HELP option on the MAIN MENU, the following
  43. display will be provided in the Graphics Window area of the terminal
  44. screen.
  45.  
  46. MAIN_MENU
  47.  
  48.                              MAIN MENU
  49.  
  50.         DESCRIPTION   : Invoke the basic functions of the Graphic
  51.                         Ada Designer.
  52.  
  53.         PAN / ZOOM    -> Access the Pan/Zoom Menu to alter the
  54.                          portion of the graph displayed on the
  55.                          terminal.
  56.         DESIGN        -> Access the Design Menu to create, display,
  57.                          and edit object oriented design diagrams
  58.                          ( graphs ).
  59.         DISPLAY ATTRB -> Access the Attributes Menu to alter and
  60.                          display symbol attributes.
  61.         GENERATE PDL  -> Generate the PDL for the current graph.
  62.         PRINT         -> Print the graph.
  63.         READ FILE     -> Read in a graph from the selected file.
  64.         WRITE FILE    -> Write out a graph to the selected file.
  65.         QUIT, NO SAVE -> Quit without saving the current work file.
  66.         EXIT & SAVE   -> Exit and save the current work file.
  67.  
  68. The specific HELP descriptions for individual options on MAIN_MENU
  69. are as follows:
  70.  
  71. PAN_ZOOM_CMD
  72.  
  73.                             PAN ZOOM MENU
  74.                 Access the Pan/Zoom Menu processor to alter the
  75.                 portion of the graph displayed on the terminal.
  76.                 Pans up, down, left, and right.
  77.                 Zooms in and out.
  78.  
  79. DESIGN_CMD
  80.  
  81.                             DESIGN 
  82.                 Access the Design Menu processor to
  83.                 create, display, and edit the Object
  84.                 Oriented Design Diagrams ( graphs ).
  85.  
  86. ATTRIBUTES_CMD
  87.  
  88.                          DISPLAY ATTRIBUTES
  89.               Access the Display Attributes Menu to alter and
  90.               display the symbol attributes associated with the
  91.               current graph.  Altered attributes are preserved
  92.               between sessions.
  93.  
  94. GEN_PDL_CMD
  95.  
  96.                             GENERATE PDL
  97.            Extract the necessary syntactical and semantical
  98.            information from the design diagrams and generate
  99.            compilable PDL text files. The PDL text will be
  100.            placed in a file with the same name as the design
  101.            file, but with the extension ".PDL"
  102.  
  103. PRINT_CMD
  104.  
  105.                                  PRINT
  106.            Enlarge the currently displayed graph to full screen
  107.            size, print the graph to the graphics printer connected
  108.            to the terminal's output port, and restore the displayed
  109.            graph to the normal size.
  110.  
  111. READ_FILE_CMD
  112.  
  113.                             READ FILE
  114.            Read in a previously created GAD design file,
  115.            or create a new graph.  The user will be
  116.            prompted for the name of the file to be read
  117.            or created.  Usage of this command will result
  118.            in the erasure of the current graph.
  119.  
  120. WRITE_FILE_CMD
  121.  
  122.                             WRITE FILE
  123.            Write out the current design diagram to a GAD
  124.            design file.  The user will be prompted for the
  125.            name of the file to write the graph data.
  126.  
  127. QUIT_CMD
  128.  
  129.                            QUIT, NO SAVE
  130.              Terminate GAD operation without saving the
  131.              current graph.
  132.  
  133. FINISHED_CMD
  134.  
  135.                             EXIT & SAVE
  136.           Terminate GAD operation and save the current
  137.           graph.  The operator specified default file
  138.           name will be used to create a new version of
  139.           the file.
  140.  
  141. A.2  Pan/Zoom Menu Help Description
  142.  
  143. Upon selecting the HELP option on the PAN/ZOOM MENU, the following
  144. display will be provided in the Graphics Window area of the terminal
  145. screen.
  146.  
  147. PAN_ZOOM_MENU
  148.  
  149.                             PAN / ZOOM MENU
  150.  
  151.         DESCRIPTION   : Alter the window ( portion of the graph
  152.                         displayed ) show on the terminal.
  153.  
  154.         BACKUP/RESUME ->  Return to the previous menu, and display
  155.                           the selected view on the full design area.
  156.         PAN UP        ->  Move the graphics window upward.
  157.         PAN DOWN      ->  Move the graphics window downward.
  158.         PAN LEFT      ->  Move the graphics window to the left.
  159.         PAN RIGHT     ->  Move the graphics window to the right.
  160.         ZOOM IN       ->  Decrease the graphics window size.
  161.         ZOOM OUT      ->  Increase the graphics window size.
  162.         MAX PAN UP    ->  Move the graphics window fully upward.
  163.         MAX PAN DOWN  ->  Move the graphics window fully downward.
  164.         MAX PAN LEFT  ->  Move the graphics window fully to the left.
  165.         MAX PAN RIGHT ->  Move the graphics window fully to the right.
  166.         MAX ZOOM IN   ->  Fully decrease the graphics window size.
  167.         MAX ZOOM OUT  ->  Fully increase the graphics window size.
  168.  
  169. The specific HELP descriptions for individual options on PAN / ZOOM MENU
  170. are as follows:
  171.  
  172. BACKUP_CMD
  173.  
  174.                           MENU BACKUP
  175.            Return control to the menu from which control
  176.            had been passed; i.e. the previous menu.
  177.  
  178.            If the user is in a subordinate menu during a
  179.            creation that is requesting specific (generic 
  180.            status, parameter status, etc.) information, 
  181.            then the BACKUP acts as an abort for the creation.
  182.  
  183. PAN_UP_CMD
  184.  
  185.                                PAN UP
  186.          Move the window on the graph upward and display the
  187.          redefined window on the terminal.
  188.  
  189. PAN_DOWN_CMD
  190.  
  191.                               PAN DOWN
  192.          Move the window on the graph downward and display the
  193.          redefined window on the terminal.
  194.  
  195. PAN_LEFT_CMD
  196.  
  197.                               PAN LEFT
  198.          Move the window on the graph to the left and display
  199.          the redefined window on the terminal.
  200.  
  201. PAN_RIGHT_CMD
  202.  
  203.                              PAN RIGHT
  204.          Move the window on the graph to the right and display
  205.          the redefined window on the terminal.
  206.  
  207. ZOOM_IN_CMD
  208.  
  209.                               ZOOM IN
  210.          Decrease the size of the window on the graph and
  211.          display the redefined window on the terminal.
  212.  
  213. ZOOM_OUT_CMD
  214.  
  215.                               ZOOM OUT
  216.          Increase the size of the window on the graph and
  217.          display the redefined window on the terminal.
  218.  
  219. MAX_ZOOM_IN_CMD
  220.  
  221.                             MAX ZOOM IN
  222.          Fully decrease the size of the window on the graph
  223.          and display the redefined window on the terminal.
  224.  
  225.  
  226. MAX_ZOOM_OUT_CMD
  227.  
  228.                             MAX ZOOM OUT
  229.          Fully increase the size of the window on the graph
  230.          and display the redefined window on the terminal.
  231.  
  232. MAX_PAN_UP_CMD
  233.  
  234.                              MAX PAN UP
  235.          Move the window on the graph fully upward and
  236.          display the redefined window on the terminal.
  237.  
  238. MAX_PAN_DOWN_CMD
  239.  
  240.                              MAX PAN DOWN
  241.          Move the window on the graph fully downward and
  242.          display the redefined window on the terminal.
  243.  
  244. MAX_PAN_LEFT_CMD
  245.  
  246.                              MAX PAN LEFT
  247.          Move the window on the graph fully to the left
  248.          and display the redefined window on the terminal.
  249.  
  250. MAX_PAN_RIGHT_CMD
  251.  
  252.                              MAX PAN RIGHT
  253.          Move the window on the graph fully to the right
  254.          and display the redefined window on the terminal.
  255.  
  256. A.3  Design Menu Help Description
  257.  
  258. Upon selecting the HELP option on the DESIGN MENU, the following
  259. display will be provided in the Graphics Window area of the terminal
  260. screen.
  261.  
  262. DESIGN_MENU
  263.                             DESIGN MENU
  264.  
  265.         DESCRIPTION      : Create, delete, and edit object
  266.                            oriented design diagrams ( graphs ).
  267.  
  268.         MENU BACKUP      ->  Design completed, return to the
  269.                              last higher menu.
  270.         PAN / ZOOM       ->  Access the Pan/Zoom Menu to alter the
  271.                              view window location on the page.
  272.         VIRTUAL PKG      ->  Create a virtual package symbol
  273.         PACKAGE          ->  Create a package symbol
  274.         PROCEDURE        ->  Create a procedure symbol
  275.         FUNCTION         ->  Create a function symbol
  276.         TASK             ->  Create a task symbol
  277.         ENTRY POINT      ->  Create an entry point to a task
  278.         XECUTING BODY    ->  Create a body symbol
  279.         IMPORT/EXPORT    ->  Create export/import annotations
  280.         CALL CONN        ->  Create a call connection 
  281.         VISIBLE CONN     ->  Create a visibility connection 
  282.         EXPORTS CONN     ->  Create a export relation connection 
  283.         DELETE CONN      ->  Delete a call, visibility, or exports
  284.                              connection
  285.         DELETE ENTITY    ->  Delete a graphical entity
  286.         MOVE / RESIZE    ->  Move and resize a graphical entity
  287.         MODIFY ENTITY    ->  Modify an Ada attribute of a graphical
  288.                              entity
  289.  
  290. The specific HELP descriptions for individual options on DESIGN MENU
  291. are as follows:
  292.  
  293.                           MENU BACKUP
  294.  
  295.                          PAN ZOOM MENU
  296.  
  297. VIRT_PACKAGE_CMD
  298.  
  299.                           VIRTUAL PACKAGE
  300.          Create a virtual package.  The upper left and lower
  301.          right corners of the enclosing rectangle, the name,
  302.          and the prologue will be requested.
  303.  
  304.          The virtual package symbol is a rectangle.
  305.  
  306. PACKAGE_CMD
  307.  
  308.                             PACKAGE
  309.          Create a package.  The declaration mode ( normal,
  310.          generic declaration, or generic instantiation ),
  311.          upper left and lower right corners, the name, and
  312.          the prologue will be requested.  If the package is
  313.          a generic instantiation, the name of the package
  314.          being instantiated will be requested, and then the
  315.          letters "gi" along with the instantiated package
  316.          name will be displayed; if the package is a generic
  317.          declaration, the letters "gd" will be displayed
  318.          within the package symbol.
  319.  
  320.          The package symbol is a rectangle.
  321.  
  322. PROCEDURE_CMD
  323.  
  324.                            PROCEDURE
  325.          Create a procedure.  The parameter status, declaration
  326.          mode ( normal, generic declaration, or generic
  327.          instantiation ), upper left and lower right corners,
  328.          the name, and the prologue will be requested.  If the
  329.          procedure is a generic instantiation, the name of the
  330.          procedure being instantiated will be requested, and then
  331.          the letters "gi" along with the instantiated procedure
  332.          name will be displayed; if the procedure is a generic
  333.          declaration, the letters "gd" will be displayed within
  334.          the procedure symbol.
  335.  
  336.          The procedure symbol is a stacked rectangle.
  337.  
  338. FUNCTION_CMD
  339.  
  340.                            FUNCTION
  341.          Create a function.  The declaration mode ( normal,
  342.          generic declaration, or generic instantiation ),
  343.          upper left and lower right corners, the name, and
  344.          the prologue will be requested.  If the function
  345.          is a generic instantiation, the name of the function
  346.          being instantiated will be requested, and then the
  347.          letters "gi" along with the instantiated function
  348.          name will be displayed; if the function is a generic
  349.          declaration, the letters "gd" will be displayed
  350.          within the function symbol.
  351.  
  352.          The function symbol is a stacked rectangle; the
  353.          function identifier is prefixed with an '=' to
  354.          distinguish it from a procedure.
  355.  
  356. TASK_CMD
  357.  
  358.                              TASK
  359.          Create a task.  The the parameter status, upper
  360.          left and lower right corners, the name, and the
  361.          prologue will be requested.
  362.  
  363.          The task symbol is a parallelogram.
  364.  
  365. ENTRY_PT_CMD
  366.  
  367.                            ENTRY POINT
  368.          Create an entry point to a task.  The guarded status and
  369.          parameter status will be requested.  The enclosing scope,
  370.          within a task, will be requested.  A task must have been
  371.          created prior to executing this command.
  372.  
  373.  
  374. BODY_CMD
  375.  
  376.                         EXECUTING BODY
  377.          Create an executing body.  The upper left and lower right
  378.          corners will be requested.  The body is used to represent
  379.          the executable portion of an Ada unit body, and as such
  380.          is the originating point for call connections.  The body
  381.          may not contain any other entities.
  382.  
  383.          The body symbol is an octagon.
  384.  
  385. ANNOTATION_CMD
  386.  
  387.                            IMPORT / EXPORT
  388.         Access to the Import/Export Menu for
  389.         creation of annotating entities :
  390.  
  391.         o  Exported Type              o  Exported Object
  392.         o  Exported Exception         o  Exported Procedure
  393.         o  Exported Function          o  Exported Task Entry
  394.  
  395.         o  Imported Virtual Package   o  Imported Package
  396.         o  Imported Procedure         o  Imported Function
  397.  
  398. CALL_CONNECT_CMD
  399.  
  400.                          CALL CONNECTION
  401.         Create a caller-callee connection.  The call mode
  402.         ( normal, timed, or conditional ) will be requested.
  403.         The user will specify the starting and ending points,
  404.         and then be allowed to free-form draw the line by
  405.         specifying up to 20 intermediate points, beginning at
  406.         the starting point.  The starting point must be within
  407.         a body.  The ending point must be within a imported
  408.         procedure, imported function, exported procedure,
  409.         exported function, exported entry point, procedure,
  410.         function, or entry point.
  411.  
  412. DATA_CONNECT_CMD
  413.  
  414.                       VISIBILITY CONNECTION
  415.         Create a visibility connection.  The user will specify 
  416.         the starting and ending points, and then be allowed to 
  417.         free-form draw the line by specifying up to 20 
  418.         intermediate points, beginning at the starting point.  
  419.         The starting point must be within a virtual package, 
  420.         package, procedure, or function.  The ending point must 
  421.         be within an imported virtual package, imported package, 
  422.         virtual package, or package.
  423.  
  424. EXPORT_CONNECT_CMD
  425.  
  426.                      EXPORTS CONNECTION
  427.         Create an export relationship connection. The user
  428.         will specify the starting and ending points, and then
  429.         be allowed to free-form draw the line by specifying
  430.         up to 20 intermediate points, beginning at the starting
  431.         point.  The starting point must be within any export
  432.         symbol.  The ending point must be within the corresponding
  433.         procedure, function, entry point, or export symbol.
  434.  
  435. DELETE_CONNECT_CMD
  436.  
  437.                          DELETE CONNECTION
  438.         Delete a call, visibility, or exports connection.  The
  439.         user will specify the starting point.  If the program
  440.         can determine only connection from the starting point,
  441.         then that connection is highlighted for deletion.  If
  442.         multiple connections exist from the start point, then
  443.         the end point is requested to determine the appropriate
  444.         connection to highlight for deletion.  The user will
  445.         then be prompted to confirm or cancel the deletion.
  446.  
  447. DELETE_CMD
  448.  
  449.                         DELETE ENTITY
  450.          Delete a graphical entity, and all associated
  451.          connections, represented on the design diagram.
  452.          The user will be prompted to select the entity
  453.          to be deleted, and will again be prompted to
  454.          confirm or cancel the deletion.
  455.  
  456. MOVE_CMD
  457.  
  458.                        MOVE / RESIZE ENTITY 
  459.          Move and resize a user selected graphical entity and
  460.          all contained entities and annotations. The user will
  461.          be prompted to select the outer scope of the entity(ies)
  462.          to be moved and resized, the destination ( new uppper
  463.          left hand corner) for the entity(ies) of the move, and
  464.          the new size ( new lower right hand corner ) of the
  465.          entity(ies).  The resize will proportionally alter all
  466.          the entity(ies), such that the outer most entity fits
  467.          between its new upper left hand corner and lower right
  468.          hand corner.
  469.  
  470.          If any connections (call, data, export) have one end
  471.          outside of the moved and resized entities and the other
  472.          end inside the moved entities, then the user will be
  473.          prompted to attend to each such connection.  The program
  474.          will make an attempt to redraw the connection which the
  475.          user may confirm, or cancel and redraw the connection
  476.          ( by specifying the intermediate points ).  If any of
  477.          the connection starting and/or ending points are not
  478.          within the View window, then the program with automatically
  479.          go to max zoom out.
  480.  
  481.          The move and resize is validated prior to being executed
  482.          by verifying that the resultant graph will be semantically
  483.          correct.  The move may not create an invalid graph by
  484.          overlaying other entities.  Graphs which have previously
  485.          introduced this kind of semantic error cannot be moved and
  486.          resized until the problem is corrected.
  487.  
  488.  
  489. MODIFY_CMD
  490.  
  491.                          MODIFY ENTITY
  492.          Modify the name and other Ada attributes of the selected
  493.          entity.  The user will be prompted to select the entity 
  494.          to be modified, and for new values of all modifiable
  495.          attributes ( name, prologue, instantiated unit name,
  496.          call status, etc. ).
  497.  
  498. A.4  Generic Menu Commands
  499.  
  500. Upon selecting the HELP option on the GENERIC MENU, the following
  501. display will be provided in the Graphics Window area of the terminal
  502. screen.
  503.  
  504. GENERIC_MENU
  505.  
  506.                             GENERIC MENU
  507.  
  508.         DESCRIPTION     : Define the declaration mode ( normal,
  509.                           generic declaration, or generic
  510.                           instantiation ) of the entity being created.
  511.  
  512.         MENU BACKUP ->    Abort this creation, and return to the
  513.                           previous menu.
  514.         DECLARATION   ->  Set the status of the created entity
  515.                           to non-generic.
  516.         GENERIC DECLA ->  Set the status of the created entity
  517.                           to generic declaration.
  518.         GENERIC INSTA ->  Set the status of the created entity
  519.                           to generic instantiation.
  520.  
  521.         After selection of declaration mode, return and complete
  522.         drawing.
  523.  
  524. The specific HELP descriptions for individual options on GENERIC
  525. MENU are as follows:
  526.  
  527.                             MENU BACKUP
  528.  
  529. NON_GENERIC_CMD
  530.  
  531.                             DECLARATION
  532.            Set the status of the created package, procedure
  533.            or function to non generic.
  534.  
  535.            After selection of the declaration mode return and
  536.            complete drawing.
  537.  
  538. GENERIC_DECL_CMD
  539.  
  540.                         GENERIC DECLARATION
  541.            Set the status of the created package, procedure
  542.            or function to generic declaration.
  543.  
  544.            After selection of the declaration mode return and
  545.            complete drawing.
  546.  
  547. GENERIC_INST_CMD
  548.  
  549.                      GENERIC INSTANTIATION
  550.            Set the status of the created package, procedure
  551.            or function to generic instantiation. GAD will
  552.            subsequently request the name of the unit being
  553.            instantiated.
  554.  
  555.            After selection of the declaration mode return and
  556.            complete drawing.
  557.   
  558.  
  559. A.5  Annotating Menu Help Descriptions
  560.  
  561. Upon selecting the HELP option on the ANNOTATING MENU, the following
  562. display will be provided in the Graphics Window area of the terminal
  563. screen.
  564.  
  565. ANNOTATING_MENU
  566.  
  567.                           IMPORT/EXPORT MENU
  568.  
  569.         DESCRIPTION      : Select the type of entity to be
  570.                            added to the graph.
  571.  
  572.         EXPORT PROC      -> Create a visible procedure in the
  573.                             specification section of the enclosing
  574.                             ( virtual ) package.
  575.         EXPORT FUNC      -> Create a visible function in the
  576.                             specification section of the enclosing
  577.                             ( virtual ) package.
  578.         EXPORT TYPE      -> Create a visible type in the
  579.                             specification section of the enclosing
  580.                             ( virtual ) package.
  581.         EXPORT OBJECT    -> Create a visible object in the
  582.                             specification section of the enclosing
  583.                             ( virtual ) package.
  584.         EXPORT EXCEPT    -> Create a visible exception in the
  585.                             specification section of the enclosing
  586.                             ( virtual ) package.
  587.         EXPORT ENTRY     -> Create a visible entry in the
  588.                             specification section of the enclosing
  589.                             ( virtual ) package.
  590.         IMPORT VT PKG    -> Import a virtual package for use via
  591.                             an Ada "with" statement.
  592.         IMPORT PKG       -> Import a package for use via an Ada
  593.                             "with" statement.
  594.         IMPORT PROC      -> Import a procedure for use via an Ada
  595.                             "with" statement.
  596.         IMPORT FUNC      -> Import a function for use via an Ada
  597.                             "with" statement.
  598.         CALL CONN        -> Create a call connection 
  599.         VISIBLE CONN     -> Create a visibility connection 
  600.         EXPORTS CONN     -> Create a export relation connection 
  601.  
  602.         After selecting the entity enter its position on the
  603.         graph, note that import and export entity  must occur
  604.         within a virtual package or package.  The name for the
  605.         entity will then be requested.
  606.  
  607.         Imports are shown on the right-hand side of an entity.
  608.         The use of imports is shown in the PDL by context clauses
  609.         ( 'with' and 'use' ).
  610.  
  611.         Exports are shown on the left-hand side of an entity.
  612.         Exports are shown as the visible ( specification ) part
  613.         of packages and virtual packages.
  614.  
  615. The specific HELP descriptions for individual options on IMPORT/EXPORT
  616. MENU are as follows:
  617.  
  618.                             MENU BACKUP
  619.  
  620.                             PAN / ZOOM
  621.  
  622.  
  623. RESTART_CMD
  624.  
  625.                          MAIN MENU
  626.         Take the user directly to the main menu.  Eliminates
  627.         multiple menu backup commands when trying to return
  628.         to the main menu.
  629.  
  630. EXPORT_PROC_CMD
  631.  
  632.                        EXPORTED PROCEDURE
  633.         Create an annotation for a virtual package or
  634.         package which indicates the named procedure is in
  635.         the specification and hence exported ( visible ).
  636.         The exported procedure is denoted by '| identifier |'.
  637.  
  638. EXPORT_FUNC_CMD
  639.  
  640.                        EXPORTED FUNCTION
  641.         Create an annotation for a virtual package or
  642.         package which indicates the named function is in
  643.         the specification and hence exported ( visible ).
  644.         The exported function is denoted by '| =identifier |'.
  645.  
  646. EXPORT_TYPE_CMD
  647.  
  648.                         EXPORTED TYPE
  649.         Create an annotation for a virtual package or
  650.         package which indicates the named type is in
  651.         the specification and hence exported ( visible ).
  652.         The exported type is denoted by '( identifier )'.
  653.  
  654. EXPORT_OBJ_CMD
  655.  
  656.                         EXPORTED OBJECT
  657.         Create an annotation for a virtual package or
  658.         package which indicates the named object is in
  659.         the specification and hence exported ( visible ).
  660.         The exported object is denoted by ': identifier :'.
  661.  
  662. EXPORT_EXCEPT_CMD
  663.  
  664.                        EXPORTED EXCEPTION
  665.         Create an annotation for a virtual package or
  666.         package which indicates the named exception is in
  667.         the specification and hence exported ( visible ).
  668.         The exported exception is denoted by '< identifier >'.
  669.  
  670. EXPORT_TASK_ENTRY_CMD
  671.  
  672.                       EXPORTED ENTRY POINT
  673.         Create an annotation for a virtual package or
  674.         package which indicates the named entry point is
  675.         in the specification and hence exported ( visible ).
  676.         The exported entry point is denoted by '/ identifier /'.
  677.  
  678.         An entry point for a task must be within the
  679.         same scope as this export since the user will
  680.         be prompted for a connection to the entry point.
  681.         The end point for the connection should be
  682.         the entry point.
  683.  
  684. IMPORT_VP_CMD
  685.  
  686.                       IMPORTED VIRTUAL PACKAGE
  687.           Create an annotation for a virtual package or
  688.           package which indicates the named virtual package
  689.           has been imported for use via an Ada "with"
  690.           statement.  Imports can only be attached to
  691.           top-level ( outermost ) units.  The imported
  692.           virtual package is denoted by '% identifier %'.
  693.  
  694. IMPORT_PKG_CMD
  695.  
  696.                         IMPORTED PACKAGE
  697.           Create an annotation for a virtual package or
  698.           package which indicates the named package has
  699.           been imported for use via an Ada "with"
  700.           statement.  Imports can only be attached to
  701.           top-level ( outermost ) units.  The imported
  702.           package is denoted by '# identifier #'.
  703.  
  704. IMPORT_PROC_CMD
  705.  
  706.                        IMPORTED PROCEDURE
  707.           Create an annotation for a virtual package or
  708.           package which indicates the named procedure has
  709.           been imported for use via an Ada "with"
  710.           statement.  Imports can only be attached to
  711.           top-level ( outermost ) units.  The imported
  712.           procedure is denoted by '| identifier |'.
  713.  
  714. IMPORT_FUNC_CMD
  715.  
  716.                        IMPORTED FUNCTION
  717.           Create an annotation for a virtual package or
  718.           package which indicates the named function has
  719.           been imported for use via an Ada "with"
  720.           statement.  Imports can only be attached to
  721.           top-level ( outermost ) units.  The imported
  722.           function is denoted by '|= identifier |'.
  723.  
  724. IE_CALL_CONNECT_CMD
  725.  
  726.                          CALL CONNECTION
  727.          Create a caller-callee connection.  The call mode
  728.          ( normal, timed, or conditional ) will be requested.
  729.          Normal and conditional call modes apply to subprograms
  730.          and tasks as callers; the timed call mode applies only
  731.          to tasks as callers.  The user will specify the starting
  732.          and ending points, and then be allowed to free-form draw
  733.          the line by specifying up to 20 intermediate points.  The
  734.          starting point must be within a body.  The ending point
  735.          must be within a imported procedure, imported function,
  736.          exported procedure, exported function, exported entry
  737.          point, procedure, function, or entry point.
  738.  
  739. IE_DATA_CONNECT_CMD
  740.  
  741.                          VISIBILITY CONNECTION
  742.         Create a visibility connection.  The user will specify 
  743.         the starting and ending points, and then be allowed to 
  744.         free-form draw the line by specifying up to 20 
  745.         intermediate points, beginning at the starting point.  
  746.         The starting point must be within a virtual package, 
  747.         package, procedure, or function.  The ending point must 
  748.         be within an imported virtual package, imported package, 
  749.         virtual package, or package.
  750.  
  751. IE_EXPORT_CONNECT_CMD
  752.  
  753.                      EXPORTS CONNECTION
  754.         Create an export relationship connection.  The user
  755.         will specify the starting and ending points, and then
  756.         be allowed to free-form draw the line by specifying up
  757.         to 20 intermediate points.  The starting point must be
  758.         within an export symbol.  The ending point must be
  759.         within the corresponding procedure, function, entry
  760.         point, or export symbol.
  761.  
  762. A.6  Delete Menu Help Descriptions
  763.  
  764. Upon selecting the HELP option on the DELETE MENU, the following
  765. display will be provided in the Graphics Window area of the terminal
  766. screen.
  767.  
  768. DELETE_MENU
  769.  
  770.                            CONFIRM MENU
  771.  
  772.         DESCRIPTION :   Confirm or cancel the requested operation.
  773.                         This menu is utilized when the requested
  774.                         operation will result in the loss of data
  775.                         through either deletion of one or more
  776.                         graphical entities, or the loss ( possibly
  777.                         through overwriting ) of the entire graph
  778.                         structure.
  779.         MENU BACKUP ->  Return to the last higher menu.  This
  780.                         selection is effectively identical to
  781.                         selecting a CANCEL.
  782.         CANCEL      ->  Cancel the requested operation.
  783.         CONFIRM     ->  Confirm the requested operation.
  784.  
  785. The specific HELP descriptions for individual options on DELETE
  786. MENU are as follows:
  787.  
  788.                              MAIN MENU
  789.  
  790.                             MENU BACKUP
  791.  
  792. CONFIRM_CMD
  793.  
  794.                               CONFIRM
  795.             Confirm the requested operation.  The user
  796.             acknowledges the acceptability of the data
  797.             loss implied by the pending operation.  The
  798.             requested operation is performed and control
  799.             is returned to the calling menu, or the GAD
  800.             is exited.
  801.  
  802. CANCEL_CMD
  803.  
  804.                              CANCEL
  805.            Cancel the requested operation.  The graph is
  806.            restored to its original state ( prior to the
  807.            initiation of the current operation ) and
  808.            control is returned to the calling menu.
  809.  
  810. A.7  Attributes Menu Help Descriptions
  811.  
  812. Upon selecting the HELP option on the ATTRIBUTES MENU, the following
  813. display will be provided in the Graphics Window area of the terminal
  814. screen.
  815.  
  816. ATTRIBUTES_MENU
  817.  
  818.                           ATTRIBUTES MENU
  819.  
  820.         DESCRIPTION       : Alter the display color or line type
  821.                             attributes of one or more graphic
  822.                             entity types.
  823.  
  824.         MENU BACKUP       ->  Return to the last higher menu.
  825.         "GRAPHIC ENTITY"  ->  Alter the display attributes of
  826.                               the specified entity.
  827.  
  828.         GAD will generate the graphs according to the set of
  829.         display attributes as set by default or as set by the
  830.         user with the aid of this menu.  Settings are preserved
  831.         between session as part of the display file.
  832.  
  833.         If the user desires to alter the default setting, it is
  834.         recommended that it be altered prior to the start of the
  835.         editing session, since entities cannot be redrawn with
  836.         the new attributes during a session.
  837.  
  838. The specific HELP descriptions for individual options on ATTRIBUTES
  839. MENU are as follows:
  840.  
  841.                             MENU BACKUP
  842.  
  843. A_VIRT_PACKAGE_CMD
  844.  
  845.                      VIRTUAL PACKAGE SYMBOL
  846.            Alter the virtual package color and line type
  847.            attributes.
  848.  
  849. A_PACKAGE_CMD
  850.  
  851.                            PACKAGE SYMBOL
  852.            Alter the package color and line type attributes.
  853.  
  854. A_SUBPROGRAM_CMD
  855.  
  856.                          SUBPROGRAM SYMBOL
  857.            Alter the subprogram color and line type attributes.
  858.  
  859. A_TASK_CMD
  860.  
  861.                             TASK SYMBOL
  862.            Alter the task color and line type attributes.
  863.  
  864. A_CALL_CONNECT_CMD
  865.  
  866.                         CALL CONNECTION LINE
  867.          Alter the call connection line type attribute.
  868.  
  869. A_DATA_CONNECT_CMD
  870.  
  871.                     VISIBLE CONNECTION LINE
  872.          Alter the visibility connection line type attribute.
  873.  
  874. A_EXPORT_CONNECT_CMD
  875.  
  876.                    EXPORTS CONNECTION LINE
  877.          Alter the specification connection line color
  878.          and line type attributes.
  879.  
  880. A.8  Color/Line Menu Help Descriptions
  881.  
  882. Upon selecting the HELP option on the COLOR/LINE MENU, the following
  883. display will be provided in the Graphics Window area of the terminal
  884. screen.
  885.  
  886. COLOR_LINE_MENU
  887.  
  888.                            COLOR / LINE MENU
  889.  
  890.         DESCRIPTION   : Define a new display color or line-type 
  891.                         for the previously selected graphical
  892.                         entity type.
  893.  
  894.         MENU BACKUP   ->  Changes complete, return to the last
  895.                           higher menu.
  896.         "Color"       ->  The new color of the graphical entity.
  897.         SOLID  _____  ->  The new line-font is to be solid.
  898.         DASHED _ _ _  ->  The new line-font is to be dashed.
  899.         DOTTED .....  ->  The new line-font is to be dotted.
  900.  
  901. The specific HELP descriptions for individual options on COLOR/LINE MENU
  902. are as follows:
  903.  
  904.                            MENU BACKUP
  905.  
  906.  
  907. GREEN_CMD
  908.                            GREEN
  909.          Set the color of the previously selected graphical
  910.          entity type to green.
  911.  
  912. BLUE_CMD
  913.                            BLUE
  914.          Set the color of the previously selected graphical
  915.          entity type to blue.
  916.  
  917. VIOLET_CMD
  918.                            VIOLET
  919.          Set the color of the previously selected graphical
  920.          entity type to violet.
  921.  
  922. RED_CMD
  923.                            RED
  924.          Set the color of the previously selected graphical
  925.          entity type to red.
  926.  
  927. ORANGE_CMD
  928.                            ORANGE
  929.          Set the color of the previously selected graphical
  930.          entity type to orange.
  931.  
  932. YELLOW_CMD
  933.                            YELLOW
  934.          Set the color of the previously selected graphical
  935.          entity type to yellow.
  936.  
  937. BLACK_CMD
  938.                            BLACK
  939.          Set the color of the previously selected graphical
  940.          entity type to black.
  941.  
  942. SOLID_CMD
  943.  
  944.                            SOLID  _____
  945.          Set the line-type of the previously selected graphical
  946.          entity type to solid.
  947.  
  948.               ___________________________________________
  949.  
  950. DASHED_CMD
  951.  
  952.                            DASHED _ _ _
  953.          Set the line-type of the previously selected graphical
  954.          entity type to dashed.
  955.  
  956.               _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
  957.  
  958. DOTTED_CMD
  959.  
  960.                            DOTTED .....
  961.          Set the line-type of the previously selected graphical
  962.          entity type to dotted.
  963.  
  964.               ...........................................
  965.  
  966. A.9  Parameter Status Menu Commands
  967.  
  968. Upon selecting the HELP option on the PARAMETER MENU, the following
  969. display will be provided in the Graphics Window area of the terminal
  970. screen.
  971.  
  972. PARAMETER_STATUS_MENU
  973.  
  974.                            PARAMETER STATUS MENU
  975.  
  976.         DESCRIPTION   : Define the parameter status of the entity 
  977.                         ( subprogram or task entry point ) being
  978.                         created.
  979.  
  980.         MENU BACKUP   ->  Abort this creation and return to the
  981.                           last higher menu.
  982.         HAS PARAMS    ->  Assign parameters to the created entity.
  983.         NO PARAMS     ->  Do not assign parameters to the created
  984.                           entity.
  985.  
  986.         After selection of parameter status, return and complete
  987.         drawing.
  988.  
  989. The specific HELP descriptions for individual options on PARAMETER
  990. STATUS MENU are as follows:
  991.  
  992.                            MENU BACKUP
  993.  
  994. HAS_PARAMETERS_CMD
  995.  
  996.                            HAS PARAMS
  997.  
  998.            Assign parameters to the created entity.  Parameters
  999.            are indicated on the graphical display by '[ ]'
  1000.            following the subprogram or entry identifier.
  1001.  
  1002.            After selection of parameter status, return
  1003.            and complete drawing.
  1004.  
  1005. NO_PARAMETERS_CMD
  1006.  
  1007.                            NO PARAMS
  1008.  
  1009.            Do not assign parameters to the created entity.
  1010.  
  1011.            After selection of parameter status, return and
  1012.            complete drawing.
  1013.  
  1014. A.10  Call Menu Commands
  1015.  
  1016. Upon selecting the HELP option on the CALL MENU, the following
  1017. display will be provided in the Graphics Window area of the terminal
  1018. screen.
  1019.  
  1020. CALL_STATUS_MENU
  1021.  
  1022.                            CALL STATUS MENU
  1023.  
  1024.         DESCRIPTION     : Define the call status of the entity
  1025.                           being created.
  1026.  
  1027.         MENU BACKUP   ->  Abort this creation and return to the
  1028.                           last higher menu.
  1029.         UNCONDITIONAL ->  Set the call status to unconditional.
  1030.         CONDITIONAL   ->  Set the call status, to an entry point,
  1031.                           or subprogram to conditional.
  1032.         TIMED         ->  Set the call status, to an entry point,
  1033.                           to timed.
  1034.  
  1035.         After selection of call status, return and complete
  1036.         drawing.
  1037.  
  1038. The specific HELP descriptions for individual options on CALL STATUS
  1039. MENU are as follows:
  1040.  
  1041.                            MENU BACKUP
  1042.  
  1043.  
  1044. UNCONDITIONAL_CMD
  1045.  
  1046.                            UNCONDITIONAL
  1047.         Set the call status to unconditional.
  1048.  
  1049.         After selection of call status, return and complete
  1050.         drawing.
  1051.  
  1052. CONDITIONAL_CMD
  1053.  
  1054.                            CONDITIONAL
  1055.         Set the call status, to an entry point, to conditional.
  1056.         Conditional calls are denoted by a 'C' in the caller.
  1057.         Conditional calls can be made to task entries or
  1058.         subprograms.
  1059.  
  1060.         After selection of call status, return and complete
  1061.         drawing.
  1062.  
  1063. TIMED_CMD
  1064.  
  1065.                            TIMED
  1066.         Set the call status, to an entry point, to timed.
  1067.         Timed calls are denoted by a 'T' in the caller.
  1068.  
  1069.         After selection of call status, return and complete
  1070.         drawing.
  1071.  
  1072. A.11  ENTRY_POINT Status Menu Commands
  1073.  
  1074. Upon selecting the HELP option on the ENTRY_POINT MENU, the following
  1075. display will be provided in the Graphics Window area of the terminal
  1076. screen.
  1077.  
  1078. ENTRY_POINT_STATUS_MENU
  1079.  
  1080.                            ENTRY POINT STATUS MENU
  1081.  
  1082.         DESCRIPTION     : Define the entry point status of the entity
  1083.                           being created.
  1084.  
  1085.         MENU BACKUP   ->  Abort this creation, return to the
  1086.                           last higher menu.
  1087.         UNGUARDED     ->  Assign unguarded status to the created
  1088.                           entry point.
  1089.         GUARDED       ->  Assign guarded status to the created
  1090.                           entry point.
  1091.  
  1092.         After selection of entry point status, return and complete
  1093.         drawing.
  1094.  
  1095. The specific HELP descriptions for individual options on ENTRY POINT
  1096. STATUS MENU are as follows:
  1097.  
  1098.                            MENU BACKUP 
  1099.  
  1100.  
  1101. UNGUARDED_CMD
  1102.  
  1103.                            UNGUARDED
  1104.  
  1105.            Assign unguarded status to the created entry point.
  1106.  
  1107.            After selection of entry point status, return and
  1108.            complete drawing.
  1109.  
  1110. GUARDED_CMD
  1111.  
  1112.                            GUARDED
  1113.  
  1114.            Assign guarded status to the created entry point.
  1115.            Guarded entry points are denoted by a '*' prefixed
  1116.            to the entry identifier.
  1117.  
  1118.            After selection of entry point status, return and
  1119.            complete drawing.
  1120.  
  1121. A.12  PDL Status Menu Commands
  1122.  
  1123. Upon selecting the HELP option on the PDL STATUS MENU, the following
  1124. display will be provided in the Graphics Window area of the terminal
  1125. screen.
  1126.  
  1127. PDL_STATUS_MENU
  1128.  
  1129.                            PDL STATUS MENU
  1130.  
  1131.         DESCRIPTION     : Define if the SUPPORT_PACKAGE should be
  1132.                           included in the PDL to be generated.
  1133.                           The SUPPORT_PACKAGE permits 'TBD' items
  1134.                           in the PDL to be correctly compiled.
  1135.  
  1136.         MENU BACKUP   ->  Abort this PDL generation and return to
  1137.                           the last higher menu.
  1138.         WITH SUPPORT  ->  Include the SUPPORT_PACKAGE in the
  1139.                           generated PDL.
  1140.         NO SUPPORT    ->  Do not include the SUPPORT_PACKAGE
  1141.                           in the generated PDL.
  1142.  
  1143.         package SUPPORT_PACKAGE is
  1144.  
  1145.            type TBD_TYPE is ( TBD )  ; -- used as function return
  1146.                                        -- type
  1147.            TBD_OBJECT     : TBD_TYPE ; -- the function return value
  1148.            TBD_PARAMETERS : TBD_TYPE ; -- the subprogram calling
  1149.                                        -- parameters
  1150.            TBD_TIME       : DURATION ; -- for delay statements
  1151.            TBD_CONDITION  : BOOLEAN  ; -- for conditional statements
  1152.  
  1153.         end SUPPORT_PACKAGE ;
  1154.  
  1155.         After selection of the SUPPORT_PACKAGE status, return and
  1156.         complete the PDL generation.
  1157.  
  1158. The specific HELP descriptions for individual options on
  1159. pdl STATUS MENU are as follows:
  1160.  
  1161.                            MENU BACKUP 
  1162.  
  1163.  
  1164. WITH_SUPPORT_CMD
  1165.  
  1166.                            WITH SUPPORT
  1167.  
  1168.            Include the SUPPORT_PACKAGE in the generated PDL.
  1169.  
  1170.            After selection of the SUPPORT_PACKAGE status, return
  1171.            and complete the PDL generation.
  1172.  
  1173. NO_SUPPORT_CMD
  1174.  
  1175.                            NO SUPPORT
  1176.  
  1177.            Do not include the SUPPORT_PACKAGE in the generated PDL.
  1178.  
  1179.            After selection of the SUPPORT_PACKAGE status, return
  1180.            and complete the PDL generation.
  1181.  
  1182.