Configurable runtime graphical user interface widget management

Abstract

A method facilitating modification of an application's graphical user interface (GUI), particularly by application end-users. In particular, the method permits modification of the application GUI, without having to specify widgets required for the modified GUI, and without having to modify or add callback routines. Thus, users can tailor the application GUI to suit their needs without having experience in GUI development (and, in particular, with the cumbersome and error-prone tasks of widget-specification and callback programming). Elimination of the need to modify/expand the set of callback routines permits end-users to realize application GUI changes without having to form a new application executable. Thus, user-driven application GUI changes can be achieved without user access to the application source code and without the application developer's involvement.

Claims

What is claimed is:

1. A computer-implemented method for specifying a graphical user interface of an application, the method comprising:

creating a first entity definition defining a structure of a first entity;

storing the first entity definition in an input file for the application, the application including a set of callback routines;

editing the input file in order to add or modify the first entity definition; and

during execution of the application, creating a first graphical user interface that permits a user to create or modify instances of the first entity definition independent of modification to the set of callback routines, wherein said step of creating a first graphical user interface comprises the steps of:

accessing the input file and parsing the first entity definition to produce a corresponding internal format;

accessing the internal format, to determine the set of graphical elements of the first graphical user interface; and

creating the set of graphical elements of the first graphical user interface.

2. The method of claim 1, wherein the first entity is a shell command of the UNIX operating system and the first entity definition describes arguments or options for the shell command.

3. The method of claim 1, further comprising the steps of:

receiving input from the user, the input providing values for one or more of the graphical elements;

saving the values for the one or more of the graphical elements into the internal format; and

creating an instance of the first entity, the instance corresponding to the internal format.

4. The method of claim 1, further comprising the steps of:

copying data from an instance of the first entity into the internal format; and

copying the data from the internal format into one or more of the graphical elements.

5. The method of claim 4, wherein the instance of the first entity is retrieved from a storage device.

6. The method of claim 1, wherein the step of parsing can be triggered by user input during execution of the application.

7. The method of claim 1, wherein the step of parsing is performed when the application begins to execute.

8. The method of claim 1, further comprising the steps of:

creating a second entity definition defining a structure of a second entity;

adding the second entity definition to the input file; and

during execution of the application, creating a second graphical user interface that permits the user to create or modify instances of the second entity independent of modification to the set of callback routines.

9. The method of claim 8, wherein:

each of the callback routines being executed upon the occurrence of a respective interaction between the user and a graphical element; and

performing the step of creating a second graphical user interface.

10. The method of claim 1, further comprising the steps of:

changing the first entity definition of the input file, the changed entity definition defining a structure of a second entity; and

during execution of the application, creating a second graphical user interface that permits the user to create or modify instances of the second entity.

11. The method of claim 10, wherein:

each of the callback routines being executed upon the occurrence of a respective interaction between the user and a graphical element; and

performing the step of creating a second graphical user interface.

12. The method of claim 1, wherein the first entity definition includes an attribute that affects the first graphical user interface.

13. The method of claim 1, wherein the first entity definition includes an attribute that affects the instances of the first entity created by the user via the first graphical user interface.

14. A computer-implemented method for specifying a graphical user interface of an application, the method comprising:

creating a first command definition defining a structure of a first command;

storing the first command definition in an input file for the application, the application including a set of callback routines;

editing the input file in order to add or modify the first command definition; and

during execution of the application, creating a first graphical user interface that permits a user to create or modify instances of the first command independent of modification to the set of callback routines, wherein said step of creating a first graphical user interface comprises the steps of:

accessing the input file and parsing the first entity definition to produce a corresponding internal format;

accessing the internal format, to determine the set of graphical elements of the first graphical user interface; and

creating the set of graphical elements of the first graphical user interface.

15. The method of claim 14, wherein the first command is a shell command of the UNIX operating system and the first command definition describes arguments or options for the shell command.

16. The method of claim 14, further comprising the steps of:

receiving input from the user, the input providing values for one or more of the graphical elements;

saving the values for the one or more of the graphical elements into the internal format; and

creating an instance of the first command, the instance corresponding to the internal format.

17. The method of claim 14, further comprising the steps of:

copying data from an instance of the first command into the internal format; and

copying the data from the internal format into one or more of the graphical elements.

18. The method of claim 14, further comprising the steps of:

creating a second command definition defining a structure of a second command;

adding the second command definition to the input file; and

during execution of the application, creating a second graphical user interface that permits the user to create or modify instances of the second command.

19. The method of claim 18, wherein:

each of the callback routines being executed upon the occurrence of a respective interaction between the user and a graphical element; and

performing the step of creating a second graphical user interface.

20. The method of claim 14, further comprising the steps of:

changing the first command definition of the input file, the changed command definition defining a structure of a second command; and

during execution of the application, creating a second graphical user interface that permits the user to create or modify instances of the second command.

21. The method of claim 20, wherein:

each of the callback routines being executed upon the occurrence of a respective interaction between the user and a graphical element; and

performing the step of creating a second graphical user interface.

22. The method of claim 14, wherein the first command definition includes an attribute that affects the execution of the instances of the first command created by the user via the first graphical user interface.

23. A computer program product for specifying a graphical user interface of an application, the product comprising;

code for creating a first entity definition defining a structure of a first entity;

code for storing the first entity definition in an input file for the application;

code for editing the input file in order to add or modify the first entity definition;

code for creating, during execution of the application, a first graphical user interface that permits a user to create or modify instances of the first entity independent of modification to the set of callback routines, wherein said code for creating a first graphical user interface comprises code for accessing the input file, code for parsing the first entity definition to produce a corresponding internal format, code for accessing the internal format, to determine the set of graphical elements of the first graphical user interface, and code for creating the set of graphical elements of the first graphical user interface; and

a computer-readable storage medium that stores the code.

24. The product of claim 23, wherein the first entity is a shell command of the UNIX operating system and the first entity definition describes arguments or options for the shell command.

25. The product of claim 23, further comprising:

code for receiving input from the user, the input providing values for one or more of the graphical elements;

code for saving the values for the one or more of the graphical elements into the internal format; and

code for creating an instance of the first entity, the instance corresponding to the internal format.

26. The product of claim 23, further comprising:

code for copying data from an instance of the first entity into the internal format; and

code for copying the data from the internal format into one or more of the graphical elements.

27. The product of claim 23, further comprising:

code for creating a second entity definition defining a structure of a second entity;

code for adding the second entity definition to the input file; and

code for creating, during execution of the application, a second graphical user interface that permits the user to create or modify instances of the second entity.

28. The product of claim 27, wherein:

each of the callback routines being executed upon the occurrence of a respective interaction between the user and a graphical element; and

creation of a second graphical user interface.

29. The product of claim 23, further comprising:

code for changing the first entity definition of the input file, the changed entity definition defining a structure of a second entity; and

code for creating, during execution of the application, a second graphical user interface that permits the user to create or modify instances of the second entity.

30. The product of claim 29, wherein:

each of the callback routines being executed upon the occurrence of a respective interaction between the user and a graphical element; and

creation of a second graphical user interface.

31. A computer program product for specifying a graphical user interface of an application, the product comprising:

code for creating a first command definition defining a structure of a first command;

code for storing the first command definition in an input file for the application, the application including an operations code;

code for editing the input file in order to add or modify the first command definition;

code for creating, during execution of the application, a first graphical user interface that permits a user to create or modify instances of the first command definition independent of modification to the operations code, wherein said code for creating a first graphical user interface comprises code for accessing the input file, code for parsing the first entity definition to produce a corresponding internal format, code for accessing the terminal format, to determine the set of graphical elements of the first graphical user interface, and code for creating the set of graphical elements of the first graphical user interface; and

a computer-readable storage medium that stores the code.

32. The product of claim 31, wherein the first command is a shell command of the UNIX operating system and the first command definition describes arguments or options for the shell command.

33. The product of claim 31, further comprising:

code for receiving input from the user, the input providing values for one or more of the graphical elements;

code for saving the values for the one or more of the graphical elements into the internal format; and

code for creating an instance of the first command, the instance corresponding to the internal format.

34. The product of claim 31, further comprising:

code for copying data from an instance of the first command into the internal format; and

code for copying the data from the internal format into one or more of the graphical elements.

35. The product of claim 31, further comprising:

code for adding a second command definition to the input file, the second command definition defining a structure of a second command; and

code for creating, during execution of the application, a second graphical user interface that permits the user to create or modify instances of the second command.

36. The product of claim 35, wherein:

each of the callback routines being executed upon the occurrence of a respective interaction between the user and a graphical element; and

creation of a second graphical user interface.

37. The product of claim 31, further comprising:

code for changing the first command definition of the input file, the changed command definition defining a structure of a second command; and

code for creating, during execution of the application, a second graphical user interface that permits the user to create or modify instances of the second command.

38. The product of claim 37, wherein:

each of the callback routines being executed upon the occurrence of a respective interaction between the user and a graphical element; and

creation of a second graphical user interface.

39. A computer system for specifying a graphical user interface of an application, the system comprising:

a first storage medium storing an input file for the application, the application including a set of callback routines, the input file containing a first entity definition, the first entity definition defining a structure of a first entity, wherein the input file can be edited in order to add or modify entity definitions; and

a processor configured to create, during execution of the application, a first graphical user interface that permits a user to create or modify instances of the first entity independent of modification to the set of callback routines, wherein said processor is configure to access the input file, parse the first entity definition to produce a corresponding internal format, access the internal format, to determine the set of graphical elements of the first graphical user interface, and create the set of graphical elements of the first graphical user interface.

40. A computer system for specifying a graphical user interface of an application, the system comprising:

a first storage medium storing an input file for the application, the application including a set of callback routines, the input file containing a first command definition, the first command definition defining a structure of a first command, wherein the input file can be edited in order to add or modify command definitions; and

a processor configured to create, during execution of the application, a first graphical user interface that permits a user to create or modify instances of the first command independent of modification to the set of callback routines, wherein said processor is configured to access the input file, parse the first entity definition to produce a corresponding internal format, access the internal format, to determine the set of graphical elements of the first graphical user interface, and create the set of graphical elements of the first graphical user interface.

Description

BACKGROUND OF THE INVENTION

The present invention relates to computer systems, and more particularly to graphical user interfaces.

As a result of the growing popularity of graphical user interfaces (GUIs) for computer programs, various tools have been created to facilitate the process of developing a GUI for an application. Typically, the process of using such a tool includes the following steps:

1) creating a user-editable text file (e.g. a user interface language (UIL) file) specifying the graphical elements (also known as "widgets", e.g. a text field, button, menu, list, or scroll bar) required for the desired GUI, either directly or through graphical means using a GUI-builder;

2) compiling the text file into an internal format such as a user interface database (UID) file. This internal format is accessed during execution of the application;

3) programming various routines of the application that access the internal format of 2) and are responsible for widget creation and management. These routines typically call a set of high-level routines for widget creation and management (e.g. the Motif library, which in turn calls low-level routines, e.g. the Xlib routines provided by the X Windows System). Some of these routines, known as "callback routines", are executed upon the occurrence of various user interactions with the widgets created in (1). For example, there could be a callback routine that is executed whenever the user enters a value into a particular text field.

4) creating an executable module ("binary") for the application that includes the compiled callback routines and calls to high-level routines.

Sometimes, users require modification to the application GUI at some time(s) after shipment of the application to the user. In the case where an application GUI allows creation and/or modification of instances of various types of entities (e.g. UNIX shell commands), a modification to the GUI might be required because of external changes to the entities. For example, a GUI for an application that allows the construction by the user of a valid operating system command might need to be modified in order to reflect a newly expanded command set (or option set for existing commands) supported by the operating system in which the user intends to run the constructed commands. Changes to the GUI typically require 1) changes to the user-editable file (e.g. UIL file) which specifies the widgets required for the GUI and 2) new or altered callback routines.

Most modifications to an application's GUI will require changes/additions to the application source code (i.e. the callback routines). However, the application source code, for various commercial reasons, is rarely provided to users. Thus, user-driven modifications to the application GUI typically can only be obtained through a request to the application developer for a new executable (object module) incorporating the callback routine additions/changes required to implement the desired modification to the GUI. In addition, even if the application source code is available to the user, realization of a desired GUI modification can be problematic given that most users have no experience in GUI development. Particular sources of difficulty arise in 1) specifying a type, name, location, callback routine name, parent widget etc. for each required widget either by text entry or through a GUI-builder, and 2) writing callback routines which task requires knowledge of a particular library of widget creation/management routines such as Motif or XWindows. Indeed, specifying widgets and programming callback routines are cumbersome tasks even for application developers. For this reason, frequently an application is released with a GUI that reflects only a subset of the underlying functionality of the application.

What is needed is a technique to realize changes to an application GUI that does not require programming of callback routines or specification of the widgets required for the desired GUI. In particular, a GUI-modifying technique that can be easily performed by application users, who do not have access to the source code and who do not have experience in GUI development, would be desirable.

SUMMARY OF THE INVENTION

A method facilitating specification of an application's graphical user interface (GUI), particularly by application end-users, is disclosed. The method permits modification of the application GUI, without specifying widgets required for the modified GUI, and without modifying or adding callback routines. Thus, users can tailor the application GUI to suit their needs without having experience in GUI development. In particular, the method does not require user knowledge of the cumbersome and error-prone tasks of widget-specification and callback programming. Elimination of the need to modify/expand the set of callback routines permits end-users to realize application GUI changes without having to form a new application executable. Thus, user-driven application GUI changes can be achieved without user access to the application source code and without the application developer's involvement.

A technique is disclosed for specifying the GUI of an application that allows users to create or modify instances of one or more entities (UNIX shell commands in one embodiment). In particular, the desired GUI is specified by providing definitions for the entities rather than a widget-based description. The technique for specifying the application's GUI includes the steps of:

1) storing, in an input file, a first entity definition which defines the structure of a first entity (the input file can be edited to add or modify entity definitions);

2) creating a first graphical user interface corresponding to the first entity definition, wherein a user can create or modify instances of the first entity through the first graphical user interface.

BRIEF DESCRIPTION OF THE DRAWINGS

FIG. 1A depicts a block diagram of a computer system suitable for implementing the present invention;

FIG. 1B depicts an overview of an embodiment of the invention;

FIG. 2 depicts a GUI corresponding to a definition of a command with one argument and no options;

FIG. 3 depicts a GUI corresponding to a command definition formed by adding an option with two nested optional option arguments to the command definition corresponding to the GUI of FIG. 2;

FIG. 4 depicts the structure of the application's internal format (stored in IDS 13) for the command definition corresponding to the GUI of FIG. 3;

FIG. 5 illustrates the three formats used by the invention to store command information;

FIG. 6 depicts a "Command Options" window which displays the structure of a command's arguments and options; and

FIG. 7 depicts the window of FIG. 6 covered by a menulist of available commands whose arguments and options can be displayed at the request of the user;

FIGS. 8A-8B depict an overview flowchart for the callback routine executed when the user selects a command from a menu list of commands.

DESCRIPTION OF THE PREFERRED EMBODIMENT

In one embodiment of the invention, an application provides a graphical user interface (GUI) which permits the user to construct valid shell commands for the UNIX operating system (e.g. compile and link commands). In particular, the application permits the user to enter input into windows that display the structure, i.e. arguments and options, associated with particular UNIX shell commands. Such an application is available as part of the AdaVision product 3.0, hereinafter "AdaVision", which is available from SUN Microsystems Inc. of Mountain View, Calif.

FIG. 1A depicts a block diagram of a host computer system 10 suitable for implementing the present invention. Host computer system 10 includes a bus 12 which interconnects major subsystems such as a central processor 14, a system memory 16 (typically RAM), an input/output (I/O) adapter 18, an external device such as a display screen 24 via display adapter 26, a keyboard 32 and mouse 34 via I/O adapter 18, a SCSI host adapter 36, and a floppy disk drive 38 operative to receive a floppy disk 40. SCSI host adapter 36 may act as a storage interface to a fixed disk drive 42 or a CD-ROM player 44 operative to receive a CD-ROM 46. Fixed disk 44 may be a part of host computer system 10 or may be separate and accessed through other interface systems. A network interface 48 may provide a direct connection to a remote server via a telephone link or to the Internet via a POP (point of presence). Many other devices or subsystems (not shown) may be connected in a similar manner.

Also, it is not necessary for all of the devices shown in FIG. 1A to be present to practice the present invention, as discussed below. The devices and subsystems may be interconnected in different ways from that shown in FIG. 1A. The operation of a computer system such as that shown in FIG. 1A is readily known in the art and is not discussed in detail in this application. Code to implement the present invention may be operably disposed or stored in computer-readable storage media such as system memory 16, fixed disk 42, CD-ROM 46, or floppy disk 40.

FIG. 1B displays an overview of the functioning of an application of the type disclosed herein. A user-editable text file 10 (hereinafter the "input file") contains definitions of various UNIX shell commands (specifying command arguments, options, etc.). In AdaVision, the format of the command definitions is specified by a syntax described in Appendix 1. An application 11, contains a parser 12 which parses input file 10 to produce a corresponding internal format 13 (or internal data structure (IDS) 13) when application 11 starts to execute. Application 11, also contains operation code 14 that accesses IDS 13 and displays a GUI 16, corresponding to input file 10, on a computer screen 15.

The following is an example of the contents of an input file 10 that contains the definition (adhering to the command definition syntax of Appendix 1) of one command "a.example":

COMMAND a.example { <cmd.sub.-- arg1>}

The command a.example contains one mandatory argument "cmdarg1" and no options. The space before the identifier "<cmd.sub.-- arg1>" indicates that a space is to precede the argument in any command string constructed according to the definition. FIG. 2 depicts the GUI that application 11 would display given the above sample input file 10.

Suppose that the user intends to construct a UNIX shell command for a version of UNIX that supports a "-P" option for the command a.example with two nested optional option arguments. In order to cause application 11 to display a GUI that corresponds to this version of the command, the user could edit input file 10 to modify the definition of the "a.example" command to the following: ##EQU1## Now, in addition to the mandatory command argument "cmd.sub.-- arg1", the command contains an option "-P" that has an optional argument "opt.sub.-- arg1" and, if argument "opt.sub.-- arg1" is supplied, another optional argument "opt.sub.-- arg2". The blanks before each of the three identifiers indicates that the corresponding command or option arguments is to be preceded by a space in a command string constructed according to the definition.

FIG. 3 depicts the GUI that application 11 displays when started after the above modification to input file 10. Operations code 14 automatically creates the required widgets (i.e. text labels and text fields for command and option arguments, and associated checkboxes, with nesting, for the optional option arguments). Furthermore, the GUI's callback routines (which are part of application 11 and call functions contained in operations code 14 where the bulk of the actual callback processing is performed) do not need to be modified after a change to input file 10. For example, if the checkbox next to the text label "a.sub.-- example.opt.sub.-- P.opt.sub.-- arg1" in the GUI of FIG. 2 is checked on, then the text field next to this text label and the checkbox next to the text label "a.sub.-- example.opt.sub.-- P.opt.sub.-- arg2" will be activated by operations code 14. In AdaVision, operations code 14 does not directly create or manage widgets, but makes calls through an "Options.sub.-- Callouts" interface for all required Motif/X functionality. The isolation of code directly interfacing with Motif and X Windows facilitates portability to widget creation/management systems other than X Windows or to X Windows toolkits other than Motif. The Options.sub.-- Callout routines indirectly call Motif or X Windows via functions in the View.h++ library provided by Rogue Wave corporation.

Appropriate widget specification and callback processing can be performed by operations code 14 after a modification to input file 10 without modifying operations code 14. For this reason, creation of a new application executable can be avoided. This is possible because the callback routines of application 11 and the functions of operations code 14 have been designed in an entity-centered, as opposed to widget-centered, manner. In other words, these routines have been designed with knowledge of the format that is used to define the entities of interest to the user (in this embodiment, UNIX shell commands).

In particular, the internal format of the disclosed embodiment of the invention has been adapted to store the various features of command definitions (i.e. optionality, e.g. ›arg1!, nesting, e.g. ›<arg1>›<arg2>!!, repetition, e.g. ›arg1!*, etc.). Each time the application executes, it first parses the input file into an equivalent internal format. The application's widget-specifying and callback processing routines have been designed to step through the internal format. In so doing, the routines access the command definition features stored in the internal format, in order to determine the appropriate widgets to be displayed and the appropriate callback processing to be performed. In this way, the application's widget-specifying and callback processing routines remain invariant regardless of changes to the command definitions stored in the input file.

On the other hand, prior art methods for GUI development (discussed in the background section) typically would require the user (or probably the application developer) to specify various characteristics (i.e. type, name, location, callback routine name, parent widget etc.) of each of the newly required widgets (e.g. text labels, text fields, nested checkboxes for the option "-P" and its arguments). This specification would either be achieved through text entry (e.g. into a UIL file) or graphically using a GUI-builder in order to achieve the desired modification to the GUI. In addition, changes to the widget-specifying input (e.g. UIL) file would typically require new or altered callback routines. For example, it might be necessary to write a callback routine that executes whenever the user checks the checkbox next to the text label "a.sub.-- example.opt.sub.-- P.opt.sub.-- arg1", to activate the text field next to this text label and the checkbox next to the text label "a.sub.-- example.opt.sub.-- P.opt.sub.-- arg2". Furthermore, if the application source code is not available to the user (as is typical), it would be necessary for the application developer to write the required callback routine.

The structure of IDS 13

In AdaVision, the internal format (i.e. IDS 13) corresponding to user input file 10 has been implemented in the C++ programming language as a hierarchy of five different types of objects (hereinafter sometimes referred to as nodes): command (CMD), sub-expression (SUB), identifier (ID), literal (LIT), and option (OPT). IDS 13 is used to store actual commands and options, and can also be used to create GUI widgets that display and permit modification of these commands and options. The objects forming IDS 13 must remember the attributes and the argument syntax for the commands (and their options) as described in input file 10. In addition, these objects store handles to their corresponding widgets and ID objects store the actual values of identifiers (command and option arguments entered by the user).

IDS 13 contains a command table which is an array of CMD objects, each CMD object corresponding to a respective command definition in input file 10. Each CMD object contains information about the command, including its name (e.g. a.example) and attributes (e.g. LAST, COMMON) and a pointer to a SUB node. In turn, this SUB node contains a pointer to a list of OPT nodes. This list contains one OPT node for each command option and a special type of an OPT node, i.e. an OPT-ARG node, for the command arguments.

Each SUB node is essentially a container for a list of other nodes and, thus, has a list of pointers to other nodes. As indicated above, there is a SUB node pointed to by each CMD node. In addition, there is a SUB node associated with and pointed to by each OPT node (including OPT.sub.-- ARG nodes). Finally, there is a SUB node corresponding to each occurrence of "›!" in the command definition (which signifies optionality). Each SUB node contains a "loopdef" field, that specifies the number of times the list of nodes associated with the SUB node may be processed. The values for loopdef in SUB nodes corresponding to an occurrence in the command definition of "›!*", "›!+" and "›!" (not followed by either a "*" or a "+"), respectively, are ZERO.sub.-- OR.sub.-- MORE, ONE.sub.-- OR.sub.-- MORE, and ZERO.sub.-- OR.sub.-- ONE, respectively. The value of loopdef in SUB nodes pointed to by CMD or OPT nodes is TOP.sub.-- ONE, indicating that the SUB node is a container for processing its list of associated nodes exactly once.

Each ID node stores a single identifier, e.g. a command argument or option argument. Each LIT node contains a literal character string required by the UNIX shell command (e.g. some commands require a double quote around an argument).

Each OPT node contains information about a single option, including its attributes and, as mentioned above, a pointer to a SUB node. A special kind of OPT node corresponds to the command arguments (OPT-arg). Each OPT node is in the list of nodes associated with the SUB node pointed to by the CMD node.

Parsing user-editable input file 10

As mentioned above, when application 11 starts to execute, parser 12 parses input file 10 (which contains the command definitions) to produce a corresponding internal format, IDS 13. IDS 13 consists of a hierarchy of objects of the types described above and representing the command argument, command attribute, option and option attribute information contained in the command definition(s). (In some embodiments, user input could trigger parser 12 to parse input file at an arbitrary time during execution of application 11.) FIG. 4 presents a hierarchy 400 of nodes that parser 12 would produce as part of IDS 13 upon parsing the expanded definition of the a.example command presented above. Pseudocode for carrying out the function of parser 12 is provided immediately below:

    __________________________________________________________________________
    Init.sub.-- Commands()
    Command cmd = NULL;
    Node node = NULL;
    1   open external file;
    2   while ( not end-of-file ) do
    3     get next token;  // token cannot be a
    4                      "blank" character
    5     if (token is "COMMAND") then
    6         if (node is not NULL and cmd is not NULL) then
    7           if (cmd.SUB is NULL) then
    8               cmd.SUB = new SUB node;
    9           endif;
    10          insert node into cmd.SUB's list;
    11        endif;
    12        node = NULL;
    13        get next token;
                           // the command's name
    14        cmd = new Command;
    15        cmd.name = token;
    16        process.sub.-- attributes();
                         // do the ones before {}
    17                   // (advances the token)
    18        if (token is `{`) then
    19          node = process.sub.-- arg.sub.-- syntax();
    20          if (node is not NULL) then
    21              create an OPT-arg node;
    22              OPT-arg.SUB = node;
    23              node = OPT-arg;
    24          endif;
    25          endif;
    26          process.sub.-- attributes();
                           // do the ones after {}
    27                     // (advances the token)
    28          add command to command table;
    29    else if (token is not NULL) then
    30          create an OPT node; OPT.name = token;
    31          if (cmd.SUB is NULL) then
    32            cmd.SUB = new SUB node;
    33          endif;
    34          insert OPT into cmd.SUB's list;
    35          process.sub.-- option.sub.-- attributes();
                             // do the ones before {}
    36                       // (advances the token)
    37          if (token is `{`) then
    38            OPT.SUB = process.sub.-- arg.sub.-- syntax ();
    39          endif;
    40          process.sub.-- option.sub.-- atrributes ();
                             // do the ones after {}
    41                       // (advances the token)
    42    endif;
    43  endloop;
    44  close external file;
    45  if (node is not NULL and cmd is not NULL) then
    46    if (cmd.SUB is NULL) then
    47        cmd.SUB = new SUB node;
    48    endif;
    49    insert node into cmd.SUB's list
    50  endif;
    end Init.sub.-- Commands;
    process.sub.-- attributes ()
    read command attribute tokens (if any) and set
    corresponding flags in the CMD object's data until a `{`
    or an end-of-line is read.
    end process.sub.-- option.sub.-- attributes;
    process.sub.-- option.sub.-- attributes()
    read option attribute tokens (if any) and set
    corresponding flags in the OPT object's data until a `{`
    or an end-of-line is read.
    end process.sub.-- option.sub.-- attributes;
    Node process.sub.-- arg.sub.-- syntax ()
        Node  node;
        boolean whitespace = FALSE;
    1   create a SUB node;
    2   get next token;      // token can be a "blank"
    3                        // character
    4   while (token is not NULL) do
    5     if (token is `}`) then
                             // return at end of {. . .}
    6         return SUB node;
    7     else if (toekn is `›`) then
    8         // We must process an optional (or nested) part of
    9         // the syntax, delimited by › !
    10        node = process.sub.-- arg.sub.-- syntax();
                                 // recursive call
    11                           // creates a SUB nide
    12        node.whitespace = whitespace;
    13        whitespace = FALSE;
    14        get next token;
    15        if (token is `*`) then
    16          node.loopdef = ZERO.sub.-- OR.sub.-- MORE;
    17          get next token;
    18        else if (token is `+`) then
    19          node.loopdef = ONE.sub.-- OR.sub.-- ONE;
    20          get next token;
    21        else
    22          node.loopdef = ZERO.sub.-- OR.sub.-- ONE;
    23        endif;
    24        insert node into SUB's list
    25    else if (token is `!`) then
                         // return at end of ›. . .!
    26        return SUB node;
    27    else if (token is `<`)then
    28        // We must process an identifier definition,
    29        // delimited by <>
    30        create an ID node;
    31        ID.whitespace = whitespace;
    32        whitespace = FALSE;
    33        get LABEL:TYPE:VALUE:DEFAULT> fields (if necessary);
    34        get next token;
    35        insert ID into SUB's list
    36    else if (token is a space character-blank, tab, etc.) then
    37        // whitespace is significant in the argument syntax.
    38        // It indicates that similar whitespace must exist
    39        // in that location in the UNIX command string. We
    40        // attach it as an "attribute" to the next node that
    41        // is created.
    42        whitespace = TRUE;
    43        while (token is a space character) do
    44          get next token;
    45        endloop;
    46    else
    47        // Any characters other than }› !<> or whitespace is
    48        // assumed to be a literal in the command. It
    49        // indicates that a similiar literal must exist in
    50        // that location in the UNIX command string.
    51        create a LIT node;
    52        LIT.whitespace = whitespace;
    53        whitespace = FALSE;
    54        get next token;
    55        insert LIT into SUB's list
    56    endif;
    57  endloop;
      end process.sub.-- arg.sub.-- syntax;
    __________________________________________________________________________

                                      TABLE 1
    __________________________________________________________________________
    Token read
            Location       Action Taken
    __________________________________________________________________________
    COMMAND Init.sub.-- Commands (IC) Line 3
    a.example
            IC, line 13
            IC, line 14    Create CMD node 402
            IC, line 15    CMD.name .rarw. a.example.
            IC, line 16    Call process.sub.-- attributes to
                           process any attributes on
                           command line after CMD name
                           & before { }
    {       last token obtained
            in process.sub.-- attributes
            IC, line 19    call process.sub.-- arg.sub.-- syntax
                           (PAS) - call #1
            PAS, line 1    create SUB node 411
    blank   PAS, line 2
            PAS, line 42   whitespace .rarw. TRUE
    <       PAS, line 44
            PAS, line 30   create ID node 412
            PAS, line 31   whitespace field of ID node
                           412 set to TRUE
                           (indicates that a blank to
                           precede corresponding arg in
                           UNIX command string)
    cmd.sub.-- arg1
            PAS, line 33
    >       PAS, line 33
            PAS, line 33   Set name field of ID node 412
    to cmd.sub.-- arg1
    }       PAS, line 34
            PAS, line 35   insert ID node 412 into node
                           list of SUB node 411
            PAS, line 6    return SUB node 411 to IC line
                           19 (return from call #1)
            IC, line 21    create OPT-ARG node 410
            IC, line 22    set SUB pointer of OPT-ARG
                           node 410 to point to SUB
                           node 411
            IC, line 23    node .rarw. OPT-arg node 410
            IC, line 26    call process.sub.-- attributes to
                           process any attributes on
                           command line after { }
    NULL    last token obtained
            in process.sub.-- attributes
            IC, line 28    add CMD node 402 to
                           command table 401
    -P      IC, line 3
            IC, line 30    create OPT node 404
                           for OPTION"-P" and store
                           "-P" in name field of node 404
            IC, line 32    create SUB node 403
                           make SUB ptr of CMD node
                           402 point to SUB node 403
            IC, line 34    insert OPT node 404 into node
                           list of SUB node 403
            IC, line 35    call process.sub.-- option.sub.-- attributes to
                           process any attributes on option
                           line after option name &
                           before { }
    {       last token obtained
            in process.sub.-- option.sub.--
            attributes
            IC, line 38    call process.sub.-- arg.sub.-- syntax
                           (PAS) - call #2
            PAS, line 1    create SUB node 405
    ›       PAS, line 2
            PAS, line 10   call PAS - call #3
            PAS, line 1    create SUB node 406
    blank   PAS, line 2
            PAS, line 42   whitespace .rarw. TRUE
    <       PAS, line 44
            PAS, line 30   create ID node 407
            PAS, line 31   set whitespace field of
                           ID node 407 to TRUE
    opt.sub.-- arg1
            PAS, line 33
    >       PAS, line 33
            PAS, line 33   set name field of ID node
                           407 to opt.sub.-- arg 1
    ›       PAS, line 34
            PAS, line 35   insert ID node 407 into
                           node list of SUB node 406
            PAS, line 10   call PAS-call #4
            PAS, line 1    create SUB node 408
    blank   PAS, line 2
            PAS, line 42   whitespace .rarw. TRUE
    <       PAS, line 44
            PAS, line 30   create ID node 409
            PAS, line 31   set whitespace field of
                           ID node 409 to TRUE
    opt.sub.-- arg 2
            PAS, line 33
    >       PAS, line 33
            PAS, line 33   set name field of ID node
                           409 to opt.sub.-- arg2
    !       PAS, line 34
            PAS, line 35   insert ID node 409 into
                           node list of SUB node 408
            PAS, line 26   return SUB node 408 to PAS
                           line 10 (return from call #4)
    !       PAS, line 14
            PAS, line 22   set loopdef field of SUB node
                           408 to ZERO.sub.-- OR.sub.-- ONE
            PAS, line 24   insert SUB node 408 into node
                           list of SUB node 406
            PAS, line 26   return SUB node 406 to PAS,
                           line 10 (return from call #3)
    }       PAS, line 14
            PAS, line 22   set loopdef field of SUB node
                           406 to ZERO.sub.-- OR.sub.-- ONE
            PAS, line 24   insert SUB node 406 into node
                           list of SUB node 405
            PAS, line 6    return SUB node 405 to IC line
                           38 (return from call #2)
            IC, line 38    set SUB pointer field of OPT
                           node 404 to point to SUB node
                           405
    NULL    IC, line 40    call process.sub.-- option.sub.-- attributes to
                           process any attributes on option
                           line after { }
            IC, line 49    insert OPT-ARG node 410 into
                           node Iist of SUB node 403
    __________________________________________________________________________

    ______________________________________
    Function name
                 Action
    ______________________________________
    Construct.sub.-- Props()
                 create widgets required to represent the
                 arguments and options of a command stored
                 in IDS 13. usually called once for each
                 command.
    Destroy.sub.-- Props()
                 destroy widgets previousiy created (via
                 Construct.sub.-- Props) to represent a particular
                 command
    Display.sub.-- Props()
                 copy data from a representation for a
                 command stored in IDS 13 to widgets that
                 were previousiy created for that command
                 (via Construct.sub.-- Props). called just before
                 the widgets are managed (i.e. displayed on
                 the screen).
    Apply.sub.-- Props()
                 copy data entered by the user into widgets
                 of the GUI representing a particular
                 command (created via Construct.sub.-- Props) to
                 the representation for the command in IDS
                 13. called when the Ok or Apply button is
                 pressed.
    Activate()   cause a widget hierarchy to become active.
                 called when a user turns a checkbox "on".
    Inactivate() cause a widget hierarchy to become
                 inactive. called when a user turns a
                 checkbox "off".
    Parse.sub.-- Command()
                 parse a command string stored on disk and
                 copy data from the command string into the
                 representation for the command in IDS 13.
                 called only if commands are available in
                 UNIX command string form.
    Construct.sub.-- Command()
                 translate the representation for a
                 particular command stored in IDS 13 into a
                 command string for use as a UNIX comman
                 ready to execute and/or for storage on
                 (and future retrieval from) disk.
    ______________________________________

    ______________________________________
    CheckBox.sub.-- Callback (Widget checkbox)
    Widget cmdoptions.sub.-- window;
    cmdoptions.sub.-- window = Parent (Parent (checkbox));
    cmdoptions.sub.-- window->changed = TRUE;
    if (checkbox is set) then
    current.sub.-- command->Activate (checkbox);
    else
    current.sub.-- command->Inactivate (checkbox);
    endif;
    end CheckBox.sub.-- Callback;
    Textfield.sub.-- Callback (Widget textfield)
    Widget cmdoptions.sub.-- window;
    cmdoptions.sub.-- window = Parent(Parent(textfield));
    cmdoptions.sub.-- window->changed = TRUE;
    end Textfield.sub.-- Callback;
    FileTextfield.sub.-- Callback(Widget filetextfield)
    Widget cmdoptions.sub.-- window;
    cmdoptions.sub.-- window =Parent (Parent (Parent (filetextfield)));
    cmdoptions.sub.-- window->changed = TRUE;
    end FileTextfield.sub.-- Callback;
    ExclusiveChoice.sub.-- Callback (Widget exclusivechoice)
    Widget cmdoptions.sub.-- window;
    cmdoptions.sub.-- window =
    Parent(Parent(Parent(exclusivechoice)));
    cmdoptions.sub.-- window->changed = TRUE;
    end ExclusiveChoice.sub.-- Callback;
    ScrollingList.sub.-- Callback(Widget scrollinglist)
    Widget cmdoptions.sub.-- window;
    cmdoptions.sub.-- window = Parent(Parent(scrollinglist));
    cmdoptions.sub.-- window->changed = TRUE;
    end ScrollingList.sub.-- callback;
    MenuButton.sub.-- Callback (int commandindex)
    //      Don't do a new command unless the old one is clean:
    if (changed) then
    ask the user if she wants to save changes
    if (yes) then
            current.sub.-- command->Apply.sub.-- Props();
    endif;
    endif;
    //      Take down old command options before displaying new
    //      ones.
    if      (options.sub.-- frame›current.sub.-- commandindex! is not NULL)
            then
            // Stop displaying the window
            Unmanage (options.sub.-- frame›current.sub.-- commandindex!);
    endif;
    current.sub.-- commandindex = commandindex;
    current.sub.-- command = command.sub.-- table›current.sub.-- commandindex!
    if (options.sub.-- frame›current.sub.-- commandindex! is NULL) then
    options.sub.-- frame›current.sub.-- commandindex! = new options
    frame;
    current.sub.-- command->Construct.sub.-- Props();
    }
    current.sub.-- command->Display.sub.-- Props();
    changed = FALSE;
    // Start displaying the window
    Manage(options.sub.-- frame›current.sub.-- commandindex!);
    end MenuButton.sub.-- Callback;
    OkButton.sub.-- Callback ()
    if (changed) then
    // Let Apply.sub.-- Props() do all the work
    current.sub.-- command->Apply.sub.-- Props();
    changed = FALSE;
    endif;
    // Take the window down
    Unmanage(options.sub.-- frame›current.sub.-- commandindex!);
    end OkButton.sub.-- Callback;
    ApplyButton.sub.-- Callback ()
    if (changed) then
    //  Let Apply.sub.-- Props() do all the work
    current.sub.-- command->Apply.sub.-- Props();
    changed = FALSE;
    endif;
    end ApplyButton.sub.-- Callback;
    CancelButton.sub.-- Callback()
    changed = FALSE;
    //  Take the window down; do not Destroy.sub.-- Props()||
    Unmanage (options.sub.-- frame›current.sub.-- commandindex!);
    end CancelButton.sub.-- Callback;
    HelpButton.sub.-- Callback ()
    if (current.sub.-- command->help.sub.-- tag is not NULL) then
    ShowHelp(current.sub.-- command->help.sub.-- tag);
    endif;
    end HelpButton.sub.-- Callback;
    The following callback demonstrates the use of
    Construct.sub.-- Command() when the user clicks in the Command
    (Actions) menu to execute a command.
    CommandMenu.sub.-- Callback (int commandindex)
    command.sub.-- table›commandindex!->Construct.sub.-- Command ()
    Execute.sub.-- Command(command buffer);
    end CommandMenu.sub.-- Callback;
    ______________________________________

                  TABLE 2
    ______________________________________
    Function call   Actions performed within function call
    ______________________________________
    CMD401.Construct.sub.-- Props
                    SUB403.Construct.sub.-- Props
    SUB403.Construct.sub.-- Props
                    OPT404.Construct.sub.-- Props
                    OPT-ARG 410.Construct.sub.-- Props
    OPT404.Construct.sub.-- Props
                    create checkbox 301 and text label 311
                    OPT404.my.sub.-- ui.sub.-- handle .rarw. UI handle
                    of checkbox 301
                    create label 311
                    SUB405.Construc.sub.-- Props
    SUB405.Construct.sub.-- Props
                    SUB406.Construct.sub.-- Props
    SUB406.Construct.sub.-- Props
                    create checkbox 302
                    SUB406.my.sub.-- ui.sub.-- handle .rarw. UI handle
                    of checkbox 302
                    ID407.Construct.sub.-- Props
                    SUB408.Construct.sub.-- Props
    ID407.Construct.sub.-- Props
                    create label 303
                    create text field 304
    SUB408.Construct.sub.-- Props
                    create a checkbox 305
                    SUB408.my.sub.-- ui.sub.-- handle .rarw. UI handle
                    of checkbox 305
                    ID409.Construct.sub.-- Props
    ID409.Construct.sub.-- Props
                    create label 306
                    create text field 307
    OPT-ARG410.Construct.sub.-- Props
                    create separator line 308
                    SUB411.Construct.sub.-- Props
    SUB411.Construct.sub.-- Props
                    ID412.Construct.sub.-- Props
    ID412.Construct.sub.-- Props
                    create label 309
                    create text field 310
    ______________________________________

                                      TABLE 3
    __________________________________________________________________________
    Function call
                 Actions performed within function
    __________________________________________________________________________
    CMD402.Display.sub.-- Props
                 retrieve stored command string (i.e. "a.example val1 -P
                 val2
                 val3 ")from disk and insert into command buffer;
                 CMD402.Parse.sub.-- Command (See Table 4)
                 SUB403.Display.sub.-- Props(0)
    SUB403.Display.sub.-- Props(0)
                 OPT404.Display.sub.-- Props(0)
    OPT404.Display.sub.-- Props(0)
                 make checkbox 301 checked (since OPT404.Active =
                 TRUE); SUB405.Display.sub.-- Props(0)
    SUB405.Display.sub.-- Props(0)
                 SUB406.Display.sub.-- Props(0)
    SUB406.Display.sub.-- Props(0)
                 make checkbox 302 checked (since SUB406.loopcount =
                 1 >0); ID407.Display.sub.-- Props(0)
    ID407.Display.sub.-- Props(0)
                 value of text widget 304 .rarw. ID407.value›0! = val2;
                 return
                 to SUB406.Display.sub.-- Props
    SUB406.Display.sub.-- Props
                 ID407.Activate (NULL); (since SUB406.loopcount = 1>0)
    ID407.Activate (NULL)
                 activate local widgets of ID407 (i.e. text label 303 & text
                 0
                 field 304); return to SUB406.Display.sub.-- Props
    SUB406.Display.sub.-- Props
                 SUB408.Display.sub.-- Props(0)
    SUB408.Display.sub.-- Props
                 make checkbox 305 checked (since SUB408.loopcount =
                 1>0); ID409.Display.sub.-- Props(0)
    ID409.Display.sub.-- Props
                 value of text widget 307 .rarw. ID409.value›0! = val3;
                 return to SUB408.Display.sub.-- Props
    SUB408.Display.sub.-- Props
                 ID409.Activate (NULL)
    ID409.Activate (NULL)
                 activate local widgets of ID409 (i.e. text label 306 & text
                 .
                 field 307); return to SUB408.Display.sub.-- Props
    SUB408.Display.sub.-- Props
                 return to SUB406.Display.sub.-- Props
    SUB406.Display.sub.-- Props
                 SUB408.Activate (NULL)
    SUB408.Activate (NULL)
                 activate local widgets of SUB408 (i.e. checkbox 305);
                 ID409.Activate (NULL) - see above
                 return to SUB406.Display.sub.-- Props
    SUB406.Display.sub.-- Props
                 return to SUB405.Display.sub.-- Props
    SUB405.Display.sub.-- Props
                 SUB406.Activate (NULL)
    SUB406.Activate (NULL)
                 activate local widgets of SUB406 (i.e. checkbox 302);
                 ID407.Activate; - see above
                 Sub 408.Activate; - see above
                 return to SUB405.Display.sub.-- Props
    SUB405.Display.sub.-- Props
                 return to OPT404.Display.sub.-- Props
    OPT404.Display.sub.-- Props
                 SUB405.Activate; . . . return to OPT404.Display.sub.--
                 Props
    OPT404.Display.sub.-- Props
                 return to SUB403.Display.sub.-- Props
    SUB403.Display.sub.-- Props
                 OPT404.Activate (NULL)
    OPT404.Activate (NULL)
                 activate local widget of OPT404 (i.e. checkbox 301 &
                 text label 311
                 . . .; return to SUB403.Display.sub.-- Props
    SUB403.Display.sub.-- Props
                 OPT-ARG410.Display.sub.-- Props
    OPT-ARG410.  SUB411.Display.sub.-- Props(0)
    Display.sub.-- Props
    SUB411.Display.sub.-- Props(0)
                 ID412.Display.sub.-- Props(0)
    ID412.Display.sub.-- Props
                 value of text widget 310 .rarw. ID412.value›0! = val1;
                 return
                 to SUB411.Display.sub.-- Props
    SUB411.Display.sub.-- Props
                 ID412.Activate (NULL)
    ID412.Activate (NULL)
                 activate local widgets of ID412 (i.e. text label 309 & text
                 7
                 field 310); return to SUB411.Display.sub.-- Props
    SUB411.Display.sub.-- Props
                 return to OPT-ARG.410.Display.sub.-- Props
    OPT-ARG410.  . . .; return to SUB403.Display.sub.-- Props
    Display.sub.-- Prop
    SUB403.Display.sub.-- Props
                 . . .; return to CMD402.Display.sub.-- Props
    CMD402.Display.sub.-- Props
    __________________________________________________________________________

                                      TABLE 4
    __________________________________________________________________________
    Function       Actions performed within function
    __________________________________________________________________________
    CMD402.Parse.sub.-- Command
                   remove CMD402.name, i.e. "a.example" from
                   command buffer; SUB403.Parse.sub.-- Command
    SUB403.Parse.sub.-- Command
                   result .rarw. FALSE; done .rarw. FALSE;
                   SUB403.loopcount .rarw. 0;
                   parse.sub.-- failed .rarw. OPT404.Parse.sub.-- Command
    OPT404.Parse.sub.-- Command
                   reset pointer to start of command buffer; search
                   command buffer for OPT404.name (i.e. "-P")
                   (search is successful); remove "-P" from command
                   buffer; OPT404.Active .rarw. TRUE;
                   temp .rarw. SUB405.Parse.sub.-- Command
    SUB405.Parse.sub.-- Command
                   result .rarw. FALSE; done.rarw. FALSE;
                   SUB405.loopcount .rarw. 0;
                   parse.sub.-- failed .rarw. SUB406.Parse.sub.-- Command
    SUB406.Parse.sub.-- Command
                   result .rarw. FALSE; done .rarw. FALSE;
                   SUB406.loopcount .rarw. 0,
                   parse.sub.-- failed .rarw. ID407.Parse.sub.-- Command
    ID407.Parse.sub.-- Command
                   remove a space character and val2 from command
                   buffer; ID407.Value›0! .rarw. val2;
                   return FALSE to SUB406.Parse.sub.-- Command
    SUB406.Parse.sub.-- Command
                   parse.sub.-- failed FALSE;
                   parse.sub.-- failed .rarw. SUB408.Parse.sub.-- Command
    SUB408.Parse.sub.-- Command
                   result .rarw. FALSE; done .rarw. FALSE;
                   SUB408.loopcount .rarw. 0;
                   parse.sub.-- failed .rarw. ID409.Parse.sub.-- Command
    ID409.Parse.sub.-- Command
                   remove a space character and val3 from command
                   buffer; ID409.value›0! .rarw. val3; return FALSE to
                   SUB408.Parse.sub.-- Command
    SUB408.Parse.sub.-- Command
                   SUB408 done .rarw. TRUE.loopcount .rarw.
                   SUB408.loopcount + 1 = 1; (since SUB408.loopdef
                   is ZERO.sub.-- OR.sub.-- ONE);
                   return result (=FALSE) to
                   SUB406.Parse.sub.-- Command
    SUB406.Parse.sub.-- Command
                   parse.sub.-- failed .rarw. FALSE;
                   SUB406.loopcount .rarw. SUB406.loopcount +
                   1 = 1; done .rarw. TRUE (since SUB406.loopdef is
                   ZERO.sub.-- OR.sub.-- ONE); return result (=FALSE) to
                   SUB405.Parse.sub.-- Command
    SUB405.Parse.sub.-- Command
                   parse.sub.-- failed FALSE;
                   SUB405.loopcount .rarw. SUB405.loopcount +
                   1 = 1;
                   done .rarw. TRUE (since SUB405.loopdef is
                   TOP.sub.-- ONE);
                   return result (=FALSE) to
                   OPT404.Parse.sub.-- Command
    OPT404.Parse.sub.-- Command
                   return FALSE to SUB403.Parse.sub.-- Command
    SUB403.Parse.sub.-- Command
                   parse.sub.-- failed .rarw. FALSE
                   parse.sub.-- failed .rarw. OPT.sub.-- ARG410.Parse.sub.--
                   Command
    OPT-ARG410.Parse.sub.-- Command
                   reset pointer to start of command buffer; temp .rarw.
                   SUB411.Parse.sub.-- Command
    SUB411.Parse.sub.-- Command
                   result .rarw. FALSE; done .rarw. FALSE;
                   SUB411.loopcount .rarw. 0; parse.sub.-- failed .rarw.
                   ID412.Parse.sub.-- Command
    ID412.Parse.sub.-- Command
                   remove a space character and val1 from command
                   buffer; ID412.value›0! .rarw. val1; return FALSE to
                   SUB411.Parse.sub.-- Command
    SUB411.Parse.sub.-- Command
                   SUB411.loopcount .rarw. SUB411.loopcount +
                   1 = 1;
                   done .rarw. TRUE; (since SUB411.loopdef is
                   TOP.sub.-- ONE); return result (=FALSE) to
                   OPT.sub.-- ARG410.Parse.sub.-- Command
    OPT-ARG410.Parse.sub.-- Command
                   OPT-ARG410.active .rarw. TRUE; return FALSE to
                   SUB403.Parse.sub.-- Command
    SUB403.Parse.sub.-- Command
                   parse.sub.-- failed .rarw. FALSE
                   SUB403.loopcount .rarw. SUB403.loopcount +
                   1 = 1;
                   done .rarw. TRUE; (since SUB403.loopdef =
                   TOP.sub.-- ONE); return FALSE to
                   CMD402.Parse.sub.-- Command
    CMD402.Parse.sub.-- Command
                   return FALSE
    __________________________________________________________________________

                                      TABLE 5
    __________________________________________________________________________
    Function    Actions performed within function
    __________________________________________________________________________
    CMD402.Apply.sub.-- Props
                temp .rarw. SUB403.Apply.sub.-- Props(0)
    SUB403.Apply.sub.-- Props(0)
                result .rarw. FALSE; apply.sub.-- failed .rarw. OPT404.Apply.s
                ub.-- Props(0)
    OPT404.Apply.sub.-- Props(0)
                OPT404.active .rarw. options.sub.-- callouts.Get.sub.--
                checkbox() = TRUE;
                status .rarw. SUB405.Apply.sub.-- Props(0)
    SUB405.Apply.sub.-- Props(0)
                result .rarw. FALSE; apply.sub.-- failed .rarw. SUB406.Apply.s
                ub.-- Props(0)
    SUB406.Apply.sub.-- Props(0)
                result .rarw. FALSE; apply.sub.-- failed .rarw. ID407.Apply.su
                b.-- Props(0)
    ID407.Apply.sub.-- Props(0)
                value›0! field of ID node 407 .rarw. value entered by user
                into text field widget 304 (i.e. val1)
                (a field specifying widget 304 was stored in ID node 407
                when widget 304 was created in ID407.Construc.sub.-- Props);
                return FALSE to SUB406.Apply.sub.-- Props
    SUB406.Apply.sub.-- Props(0)
                apply.sub.-- failed .rarw. FALSE;
                apply.sub.-- failed .rarw. SUB408.Apply.sub.-- Props(0)
    SUB408.Apply.sub.-- Props(0)
                result .rarw. FALSE; return result to SUB406.Apply.sub.--
                Props
                (i.e. Options.sub.-- Callouts.Get.sub.-- Checkbox() returns
                FALSE
                because user did not check checkbox 305)
    SUB406.Apply.sub.-- Props(0)
                apply.sub.-- failed .rarw. FALSE;
                done .rarw. TRUE (because SUB406.loopdef is
                ZERO.sub.-- OR.sub.-- ONE);
                return result (=FALSE) to SUB405.Apply.sub.-- Props
    SUB405.Apply.sub.-- Props(0)
                apply.sub.-- falied .rarw. FALSE;
                done .rarw. TRUE (because SUB405.loopdef is TOP.sub.-- ONE);
                return result (=FALSE) to OPT404.Apply.sub.-- Props
    OPT404.Apply.sub.-- Props(0)
                status .rarw. FALSE; return status to SUB403.Apply.sub.--
                Props
    SUB403.Apply.sub.-- Props(0)
                apply.sub.-- failed .rarw. FALSE;
                apply.sub.-- failed .rarw. OPT-ARG410.Apply.sub.-- Props(0)
    OPT-ARG410. status .rarw. SUB411.Apply.sub.-- Props(0)
    Apply.sub.-- Props(0)
    SUB411.Apply.sub.-- Props(0)
                result .rarw. FALSE;
                apply.sub.-- failed .rarw. ID412.Apply.sub.-- Props(0)
    ID412.Apply.sub.-- Props(0)
                value›0! field of ID node 412 .rarw. value entered by user
                into text field widget 310 (i.e. val2)
                return FALSE to SUB411.Apply.sub.-- Props
    SUB411.Apply.sub.-- Props(0)
                apply-failed .rarw. FALSE;
                done .rarw. TRUE (because SUB411.loopdef is TOP.sub.-- ONE);
                return result (=FALSE) to OPT-ARG410.Apply.sub.-- Props
    OPT-ARG410. status .rarw. FALSE; return status to SUB403.Apply.sub.--
                Props
    Apply.sub.-- Props(0)
    SUB403.Apply.sub.-- Props
                apply.sub.-- failed .rarw. FALSE;
                done .rarw. TRUE (i.e. SUB403.loopdef is TOP.sub.-- ONE);
                return result (=FALSE) to CMD402.Apply.sub.-- Props
    CMD402.Apply.sub.-- Props
    __________________________________________________________________________

                                      TABLE 6
    __________________________________________________________________________
    Function       Actions performed within the function
    __________________________________________________________________________
    CMD402.Construct.sub.-- Command
                   clear command buffers;
                   SUB403.Construct.sub.-- Cornmand
    SUB403.Construct.sub.-- Comrnand
                   OPT404.Construct.sub.-- Command
    OPT404.Construct.sub.-- Command
                   choose before.sub.-- args buffer;
                   (before.sub.-- args is the default)
                   append option string "-P" to before.sub.-- args buffer
                   (-P stored in OPT404.name during creation of IDS
                   13);
                   SUB405.Construct.sub.-- Command (before.sub.-- args)
    SUB405.Construct.sub.-- Command
                   SUB406.Construct.sub.-- Command (before.sub.-- args)
    (before.sub.-- args)
    SUB406.Construct.sub.-- Command
                   ID407.Construct.sub.-- Command (before.sub.-- args)
    (before.sub.-- args)
    ID407.Construct.sub.-- Command
                   append a space and ID407.value›0! (i.e. val1) to
    (before.sub.-- args)
                   before.sub.-- args. buffer;
                   return to SUB406.Construct.sub.-- Command
    SUB406.Construct.sub.-- Command
                   SUB408.Construct.sub.-- Command (before.sub.-- args).
    (before.sub.-- args)
    SUB408.Construct.sub.-- Command
                   return to SUB406.Construct.sub.-- Command
    (before.sub.-- args)
                   (because SUB408.loopcount = 0)
    SUB406.Construct.sub.-- Command
                   return to SUB405.Construct.sub.-- Command
    SUB405.Construct.sub.-- Command
                   return to OPT404.Construct.sub.-- Command
    OPT404.Construct.sub.-- Command
                   return to SUB403.Construct.sub.-- Command
    SUB403.Construct.sub.-- Command
                   OPT-ARG410.Construct.sub.-- Command
    OPT-ARG410.    choose the.sub.-- args buffer;
    Construct.sub.-- Command
                   SUB411.Construct.sub.-- Command (the.sub.-- args)
    SUB411.Construct.sub.-- Command
                   ID412.Construct.sub.-- Command (the.sub.-- args)
    (the.sub.-- args)
    ID412.Construct.sub.-- Command
                   append a space character and ID412.value›0! (i.e.
    (the.sub.-- args)
                   val2) to the.sub.-- args buffer;
                   return to SUB411.Construct.sub.-- Command
    SUB411.Construct.sub.-- Command
                   return to OPT.sub.-- ARG410.Construct.sub.-- Command
    OPT-ARG410.    return to SUB403.Construct.sub.-- Command
    Construct.sub.-- Command
    SUB403.Construct.sub.-- Command
                   return to CMD402.Construct.sub.-- Command
    CMD402.Construct.sub.-- Command
                   merge CMD402.name (i.e. "a.example")
                   with before.sub.-- args buffer (i.e. "-P val1") and
                   the.sub.-- args
                   buffer (i.e. "val 2") and to obtain final UNIX
                   command string "a.example -P val1 val2" (in this
                   example internal.sub.-- args, after.sub.-- args &
                   last.sub.-- arg buffers
                   are empty)
    __________________________________________________________________________

                                      TABLE 7
    __________________________________________________________________________
    Function        Actions performed
    __________________________________________________________________________
    CMD402.Activate (checkbox 302)
                    SUB403.Activate (checkbox 302)
    SUB403.Activate (checkbox 302)
                    UI .rarw. checkbox 302;
                    OPT 404.Activate (checkbox 302)
    OPT404.Activate (checkbox 302)
                    UI .rarw. checkbox 302;
                    SUB405.Activate (checkbox 302)
    SUB405.Activate (checkbox 302)
                    UI .rarw. checkbox 302;
                    SUB406.Activate (checkbox 302)
    SUB406.Activate (checkbox 302)
                    UI .rarw. checkbox 302;
                    UI .rarw. NULL (because
                    SUB406.my.sub.-- ui.sub.-- handle = checkbox 302, as set
                    in
                    SUB406.Construct.sub.-- Props); ID407. Activate
                    (NULL)
    ID407.Activate (NULL)
                    activate local widgets of ID407 (i.e. text label 303
                    and text field 304); return to SUB406.Activate
    SUB406. Activate
                    SUB408.Activate (NULL)
    SUB408.Activate (NULL)
                    UI .rarw. NULL;
                    activate local widget of SUB405 (i.e. checkbox
                    305); return to SUB406.Activate (i.e.
                    SUB408.loopdef is ZERO.sub.-- OR.sub.-- ONE and checkbox
                    305 was not checked)
    SUB406.Activate return to SUB405.Activate
    SUB405.Activate return to OPT404.Activate (because UI in
                    SUB405.Activate = checkbox 302 =
                    SUB406.Activate .fwdarw. my.sub.-- ui.sub.-- handle)
    OPT404.Activate return to SUB403.Activate
    SUB403.Activate OPT-ARG410.Activate (checkbox 302)
    OPT-ARG410.Activate
                    UI .rarw. checkbox 302
    (checkbox 302)  SUB411.Activate (checkbox 302)
    SUB411.Activate (checkbox 302)
                    UI .rarw. checkbox 302;
                    ID412.Activate (checkbox 302)
    ID412.Activate (checkbox 302)
                    return to SUB411.Activate (since checkbox 302 .noteq.
                    NULL)
    SUB411.Activate return to OPT-ARG410.Activate
    OPT-ARG401.Activate
                    return to SUB403.Activate
    SUB403.Activate return to CMD402.Activate
    __________________________________________________________________________

• Inventors
  Ford, David M.;
• Assignee
  Sun Microsystems, Inc. (Palo Alto, CA)
• Published
  Jul-28-1998
• Current US Classes:
  345/744
  345/762
  717/109
• Application #
  656587
• International Classes
  G06F 003/00
• Field of Search
  395/333 395/334 395/701 345/333 345/342 345/334 345/339 345/967
• Examiner
  Katbab; A.
• Agent
  Townsend and Townsend and Crew LLP
• US Patent References:
  5301270
  5495567
  5600780
  5603034
  5652884