CA1189628A - On-line documentation facility - Google Patents

On-line documentation facility

Info

Publication number
CA1189628A
CA1189628A CA000427897A CA427897A CA1189628A CA 1189628 A CA1189628 A CA 1189628A CA 000427897 A CA000427897 A CA 000427897A CA 427897 A CA427897 A CA 427897A CA 1189628 A CA1189628 A CA 1189628A
Authority
CA
Canada
Prior art keywords
documentation
user
command
text
storing
Prior art date
Legal status (The legal status is an assumption and is not a legal conclusion. Google has not performed a legal analysis and makes no representation as to the accuracy of the status listed.)
Expired
Application number
CA000427897A
Other languages
French (fr)
Inventor
John M. Ackroff
Michael J. Heffler
John C. Mitchell
Current Assignee (The listed assignees may be inaccurate. Google has not performed a legal analysis and makes no representation or warranty as to the accuracy of the list.)
AT&T Corp
Original Assignee
Western Electric Co Inc
Priority date (The priority date is an assumption and is not a legal conclusion. Google has not performed a legal analysis and makes no representation as to the accuracy of the date listed.)
Filing date
Publication date
Application filed by Western Electric Co Inc filed Critical Western Electric Co Inc
Application granted granted Critical
Publication of CA1189628A publication Critical patent/CA1189628A/en
Expired legal-status Critical Current

Links

Classifications

    • GPHYSICS
    • G06COMPUTING; CALCULATING OR COUNTING
    • G06FELECTRIC DIGITAL DATA PROCESSING
    • G06F3/00Input arrangements for transferring data to be processed into a form capable of being handled by the computer; Output arrangements for transferring data from processing unit to output unit, e.g. interface arrangements
    • G06F3/01Input arrangements or combined input and output arrangements for interaction between user and computer
    • G06F3/048Interaction techniques based on graphical user interfaces [GUI]
    • G06F3/0487Interaction techniques based on graphical user interfaces [GUI] using specific features provided by the input device, e.g. functions controlled by the rotation of a mouse with dual sensing arrangements, or of the nature of the input device, e.g. tap gestures based on pressure sensed by a digitiser
    • G06F3/0489Interaction techniques based on graphical user interfaces [GUI] using specific features provided by the input device, e.g. functions controlled by the rotation of a mouse with dual sensing arrangements, or of the nature of the input device, e.g. tap gestures based on pressure sensed by a digitiser using dedicated keyboard keys or combinations thereof
    • G06F3/04895Guidance during keyboard input operation, e.g. prompting
    • GPHYSICS
    • G06COMPUTING; CALCULATING OR COUNTING
    • G06FELECTRIC DIGITAL DATA PROCESSING
    • G06F9/00Arrangements for program control, e.g. control units
    • G06F9/06Arrangements for program control, e.g. control units using stored programs, i.e. using an internal store of processing equipment to receive or retain programs
    • G06F9/44Arrangements for executing specific programs
    • G06F9/451Execution arrangements for user interfaces
    • G06F9/453Help systems

Landscapes

  • Engineering & Computer Science (AREA)
  • Theoretical Computer Science (AREA)
  • General Engineering & Computer Science (AREA)
  • Software Systems (AREA)
  • Human Computer Interaction (AREA)
  • Physics & Mathematics (AREA)
  • General Physics & Mathematics (AREA)
  • Information Retrieval, Db Structures And Fs Structures Therefor (AREA)
  • Input From Keyboards Or The Like (AREA)

Abstract

ON-LINE DOCUMENTATION FACILITY

Abstract Users of an on-line documentation facility in a computer system are provided with the capability of specifying modifications to be made to the documentation that would otherwise be provided by the system.

Description

$2~

-- 1 ~

ON--L I N E DOC UMENTAT I ON FAC I L I TY

Background of the Invention Computer systems often include an on-line documentation facility whereby various kinds of system information is made available to users in response to the issuance of documentation, or "help," commands. For example, a user might issue a documentation command such as HELP TERM=BILLING_IDENTIFIE~ in response to which the system will provide documentation to the user at his or her terminal as to the meaning of the term "billing identifier"
as it is used in the system. Or the user might issue a documentation command such as HELP COMMAND=CALL in response to which the system will provide documentation as to how the "call" command is to be used. Another possibility is a documentation command such as HELP ERROR=E_NOT_ FOUND in response to which the system will provide documentation about the error whose mnemonic is ~_NOT_FOUND.
Summary of the Invention In the past, documentation of this type has been defined wholly from within the system, i.e., by the system designers. In accordance with the invention, however, us~rs of a computer system offering on-line documentation are provided with the capability of defining "user-specific" documentation for a particular documelltation command by specifying modifications to be made to the "system documentation" for that command, i.e., the documentation that would otherwise be provided by the system. (The term "user," as employed herein, includes not only a single individual, but also a community of individuals, such as the individuals who access the system under a particular account number.) It is, of course, necessary that the system documentation remain intact so that it can be ~ade available to o~her users ei~her in its original form or as modified by such other users. In preferred embodiments,
2~

this is achieved by maintaining one or more system documentation files and, in addition, one or more user documentation files for each user who desires to take advantage of the user-specific documentation capability.
In particular, the system files contain the system documentation. The user files contain documentation texts provided by the user, accompanied by instructions as to how those texts are to be used to modify the system documentation. Stated another way, ~he user files contain in~orma~ion indicating how the user-specific documentation and system documentation associated with one or more documentation commands diff er, When a particular document-ation command is issued by the user, the system accesses the system documentation files and user documentation files, as needed, and. provides the appropriate user-specific documentation.
In accordance with an aspect of the invent.ion there is provided an on-line documentation method for use in a computer system, said method comprising the steps of providing to individual users of said system, in response to issuance by said users of a particular documentation command~ system documentation associated with that parti-cular documentation command, and providing to at least one other user of said system, in response to .issuance by said other user of said particular documentation command, user-specific documentation previously defined by said other user.
Brief Description o the Drawing In the accompanying drawing~
FIG. 1 is a block diagram of a data processing/communications system in which the invention is used;
FIG. 2 is a block diagram of a multi-computer node within the system of FIG. l;

~.

- 2a -FIG. 3 shows a program package which is executed within the node of FIG. 2 and which includes an on-line documerltation facility embodying the principles of the invention;
FIG. 4 shows portions of system and user database storage areas maintained within the node of FIG. 2;
FIG. 5 shows the format of system documentation records maintained within the system storage area, FIG. 6 shows the format of user documentation records maintained within the user storage area;
FIGS. 7-~ are flowcharts oE the on-line documentation facility; and FIG~ 10 shows sytem, user and output record lists created by the on-line documentation facility during i2 its execution.
Detailed Description Table I below shows the system documentation returned to a user of the computer system of FIG. 1 in response to the documentation command HELP COMMAND=CALL.
Table I
** CALL **
* USAGE *
PACKAGE SPHP
call (nsa =) /nsa/
(mode = /mode/) * EXPLANATION *
The call command causes ~he named program to be executed * ARGUMENTS *
NSA:
The program installed at the given NSA is executedO
MODE:
The terminal mode is changed to the indicated value before the program is run. The mode may be one of common, transparent, or class_specific.
In accordance with the invention, users of the system are provided with the capability of defining user-specific documentation for a documentation command by specifying modifications to be made to the system documentation, i.el, the documentation that would otherwise be provided by the system in response to ~he documentation command in question. For example, Table II shows a version o the system documentation presented in Table I as modified by a user to provide "user-specific" documentation for the 'Icall" command.
Table II
** CALL **
* USAGE *
call <Network Standard Address> (rnode = <common or class_specific>) * EXPLANATION *
Programs are "named" by a 10 digit Network Standard Address (NSA).
The call command causes the named program to be executed. * ARGUMENTS *
NSA~ The program installed at the given NSA is e~ecuted. MODE: The terminal mode is changed to the indicated val~e before the program is run. The mode may be one of common, transparent, or class_spec;fic. The mode "transparent" is not currently supported and should not be used.
* EXAMPLE *
call 0451271234 mode = class_specific This command would invoke the Standard Customer Control Program and place your terminal in "class_specific" mode.
Note that the "usage" section has been replaced, a sentence has been added to the beginnlng of the "explanation"
section, a sentence has been added to the end of the "arguments" section and a new, "example," section has been added.
FIG. 1 depicts a system in which the present invention ;s used. The system provides an integrated data processing/communications service to a plurality of customers, and includes a number of nodes 10 which are located on the premises of the vendor of the service. At the heart of each node are one or more digital computers as described below. A plurality of data terminals 10a and host computers, or hosts, 10b are connected to nodes 10 via suitable data lines. Most of the terminals and hosts belong to the customers and are located on their premises~
Some, however, belong to the vendor and are used, ~or example, for system management. Nodes 10 communicate with each other via a packet switched transport network 15. The nodes are connected to the network via respective links 11 which carry data at 56 kb/s using a protocol which conforms to CCITT standard X.25. Various ones of the nodes may be dedicated to specific functions, such as billing, service provisioning, maintenance, etc.

( - 5 -The communicatîons service provides the customers with a number of capabilities. These include time shared execution of customer- and vendor-provided application programs stored within the nodes; storage of customer data in databases maintained within the nodes; cUpport of customer-program-callable softwar~ "building blocks" that provide such services as editing, co~mand interpreting, forms facilities and the like; a distributed processing capability wherein processes executing at various nodes can communicate on a time-critical basis with processes executing at other nodes; and store-and-forward message service.
FIG. 2 is a block diagram of an individual one of nodes 10~ The node illustratively includes two node processors 20 and a database processor 26. Each of these processors is illustratively a Digital Equipment Corporation (DEC) VAX*11/780 computer running under the DEC-supplied VMS operating system~ The node further includes a spare VAX*11/780 processor 28 which can take the place of either the database processor or one of the node processors. Other ones of nodes 10 (FIG. 1~ may have fewer or more than two node processors, depending on the anticipated processing demandO Communication among the processors is carried out via bus 25, which illustratively is a DEC~supplied PCL (parallel communication link) bus.
Mass storage, e.g., disk, units 21 are associated with each node processor and mass storage units 27 are associated with database processor 26. Mass storage units 27 are dual ported with, and thus can be accessed by, spare processor 28. Associated with each of the four processors are general purpose input/output ~I/O), e.g., CRT, terminal devices 29.
Also associated with each node processor is at least one front-end processor 22 which provides an interface between the node processor, on the one hand, and associated ones of terminals 10a and hosts l0b, on the other hand. Front~end processors 22 are, illustratively~
* trade mark IBM Series/l computers running under the IBM-supplied RPS
operating system. Each front-end processor communicates with its respective node processor using an X.25 protocol.
DEC-supplied firmware con~rolling a DEC~supplied microprocessor 23 performs the DTE role in Level 2 (the '~link" level) of the protocol. Another microprocessor 24 associated with each node processor serves a similar function with respec~ to X.25 communications over link 11.
The function of node processors 20 is to execute programs on behalf of the customers and the vendor. To this end, the mass storage units 21 associated with each processor are used primarily, if not exclusively, to support the processing currently going on in that processor. Virtually all da~a, programs and other files~
both those belonging to the customer and those belonging to the vendor, are stored in a database contained within mass storage devices 27. The function of the latter is to manage the database and to provide the node processors with access to it.
The structure of a typical vendor-supplied application program package, referred to as the Message Application Package (MAP3, is shown in FIGo 3. This program package provides the user with such services as text editing, the ability to create and send messagesl and various database services.
MAP is comprised of a main program 31 which is linked with a number of utilities, which are called from the main program as subroutines~ These utilities ;nclude editor 32, which provides the text editing capability;
set/get station parameter utility 33, which allows the user to get and set various parameters assoclated with his or her terminal; command parser 34, which accepts a command line from the user, identifies the command verb (e.g., "call" or "help"), conver~s it to internal form, and packages the arguments in a form that is appropriate for the utility to which the command is to be passed; menu facility 35, which presents various menus of choices to the 2~

user and, dependin~3 on the user's selection(s), presents further menus or invokes some action on the user's behalf;
and on-line documentation facility 36 which embodies the principles of the invention.
Other vendor-supplied program packages illustratively provided to users (but not shown in the drawing) include a Standard Customer Control Package (SCCP), which provides the user with a mechanism for performing such functions as enabling and disabling programs and stations; and a Standard Parameter Handling Package (SPHP), which provides a function similar to that of get/set station parameter utility 33. Each of these program packages is linked with a respective set oE
utilities including, in each case, an instance of on-line documentation facility 36.
Storage area within the database is of two types _ system storage area and user storage area. As shown in FIG. 4, system storage area 40 illustratively includes a number of system documenta~ion ~iles 400. Five files are shown explicitly. These are command documentation files 401, 402 and 403, a glossary file 404 and an error documentation file 405. Files 401, 402 and 403 are comprised of records each of which contains system documentation relating to a particular command recogni~ed by MAP, SCCP and SPHP, respectively. Glossary file 404 is comprised of records each of which contains the deEinition of a particular term used in the system. And error file 405 is comprised of records each of which contains information about a particular error or warning condition detected by the system and reported back to the user during execution o~ any of the program packages.
A different storage area is established within the database for each user, and FIG. 4 depicts user storage area 45 associated with one particular user. In accordance with the invention; user storage area 45 includes user documentation files 450, whose records contain user-supplied documentation texts accompanied by instructions as 6~

to how those texts are to ~e used to modify the system documentation for one or more documentation commands.
Stated another way, the user documentation files contain information indicating how the user-specific documentation and system documentation associated with one or more documentation commands differ. Their files within the user storage area, illustratively, were created using editor 32.
In this example, the user has chosen to supply documentation information for a) commands used in MAP and b) errors. To this end, two user files _ MAP command documentation file 451 and error documentation file 452_ have been established in the user storage area~
Illustratively, the names of these files are identical to the corresponding system documentation files, i.e., 15 files 401 and 405O Thus, once documentation facility 36 has obtained the name of the appropriate system documentation file to be opened, as discussed helow, it also possesses the name of the appropriate user documentation file to be opened (if one exists).
Each of the program packages includes a respective data structure referred to as an "environment." The environment for each package contains the file names for the system documentation files associated with that particular program package. In particular, environment 310 associated with M~P (shown in FIG. 3) may contain error, glossary and command file names such as Error.doc, Term.doc and MAP.doc, which are the names o~ files 405, 404 and 401, respectively. When documentation facility 36 needs to retrieve, for example, command documentation associated with M~P, it consults environment 310 to ascertain the name of the system documentation file to be accessed. The environments associated with SCCP and SPHP each contains the same error and glossary file names as the MAP environment inasmuch as uniform sets of error mnemonics and uniform terminology are used throughout the system. Commands used in each program package vary, however. Thus the SCCP and SP~P environments 6~

~ g contain respective command documentation files names- illustratively SCCP.doc and SP~P.doc_ which are the names of files 402 and 403, respectively.
Each record within the system and user documentation files is indexed by a "key" whose value is the command, term or error mnemonic to which the record pertains. ~hus, a record within either a system or user file which contains the documentation for a particular command, for example, is retrieved by specifying that command as the index key in the database read operation.
The format for a system documentation record, i.e., a record in one of system documentation files 400, is depicted in ~IG. 5. The record begins with a field delimiter _ illustratively the characters ~ followed by an optional main record flag and associated trailing delimiter, at least a first section heading and, for each section heading, a section text, all of which are separated by ## delimiters.
The value of the main record flag may be the character "C," which stands for "continuation" and indicates that the documentation associated with the index key in question is too long to be contained within one record and is therefore continued in one or more additional records. (Any such additional records are indexed under a key which is formed by adding a numeral to the key under which the first record is indexed, e~g., calll, call2, etc.) Alternatively, the main record flag may be the character "M," which stands for "menu." This flag indicates that the record in question does not contain actual documentation but, rather, the name of a menu and that when such a record is encountered by documentation facility 36, the latter is to call menu facility 35 and is to specify that menu as the one to be displayed to the user. This type of record is used, for example, where the system provides documentation for a family of command verbs such as "list_file", I'list commandsl', "list directories",_ etc., and it is anticipated that users may enter the incomplete documentation command HELP LIS~'. In this case, the command documentation file will include a record, indexed under the key "list," which contains an "M" as its main record 1ag and which contains the name of a menu which will query the user as to which type of 'llist"
command he or she wishes documentation aboutO
The section headings in the system documentation record shown in FIG. 5 are character strings such as the headings USAGE and EXPLANATION in Table I. The section texts are character strings comprising the texts which follow each section heading.
(Another kind of record used in the system documentation files, which does not follow the ormat of FIG. 5, is simply comprised of an index key with no initial delimiter. Documentation facility 36 responds when it encounters such a record by immediately accessing the record which is indexed under that key. This mechanism allows the system to automatically correct for certain anticipated user errors. For example, a record comprised of the entry "run_program" could be indexed under the key "run", which is not a valid command. Thus if the user, wanting documentation for the "run_program" command, erroneously issues the documentation command HELP COMMAND=RUNt the documentation facility will first retrieve the record indexed under the key "run". llpon finding that that record simply contains the entry "run program", it will immediately proceed to retrieve the record indexed under "run_program", thereby automatically correcting for the user's error.) The format for a user documentation record, i.eO, a record in one of user documentation files 450, is depicted in FIG. 6. It is comprised of an initial delimiter, an optional one or two main record flags, at least a first section heading and, following each section heading, an optional section flag and a section text, all of which are separated by delimiters7 The main record flag field may include "C" which, as beEore, indicates "continuation." It may also include either an "R" or an "N." The "R'l stands for "replace" and the "N" s~ands for "new." These flag values can be used interchangeably, each of them being an instruction indicating that the entirety of this user documentation record is to be used in place of the entirety of the corresponding system documentation record.
The section headin~s and section texts in the user documentation records are analogous to those in the system documentation records and need not be discussed ~urther.
The section flag can have one of four values- "A," "B," "R," or "N". "A" and "B" stand for "after" and "before" and are respective instructions indicatin~ that the section text in the user record is to be added either a~ter or before the section text of the correspondingly headed section of the corresponding system documentation record. "R" and "N" are, again, interchangeable instructions that stand for "replace" and "new." Each of them indicates that the section text in question is to replace the section text of the correspondingly headed section o~ the corresponding system documentation record. If the section flag is omitted, the section is treated as though the section flag value was "A." And if the section heading of the user documentation record is not the same as the section heading in any system documentation record, the section flag value becomes irrelevant, as will be seen.
Before proceedin~ to the flowchart of FI~S. 7~9, it is ap~ropriate at this point to discuss the format of the documentation commands in further detail. As already noted, the user can issue commands such as HELP COMMAND=CALL, HELP TERM=BILLING_IDENTIFIER and HELP ERROR=E_NOT_FOUND, in response to which the sys~em will provide the full documentation available for the command, term or error in question, as modified (if at all) by the user. As an option, the user can eliminate "COMMAND=" in a request for command documentation, e.g., HELP CALL~ Another option is that the user can specify that only a certain section or sections of the documentation are to be displayed, e.g., HELP
CALL SECTION=USAGE SECTION=EXAMPLE. Yet another option allows the user to get documentation from the command documentation file associated with a program package other than the one he or she is curren~ly using, provided that the user knows the name of that file. For example9 a user of MAP could issue the command HELP CALL FILE=SCCP.doc SECTION=ARGUMENTS and thereby get documentation about the arguments for the "call" command as it is used in SCCPO
FIGS. 7-9 comprise a flowchart of on-line documentation facility 36 which, as previously noted, is called as a subroutine, and which is also referred to below as "the routine."
FIG. 7, in particular, depicts the record retrieval portion of the routine. It begins at step 701 by examining the argumen~s passed to it by command parser 34 to determine just what documentation is being requested.
If, as determined at step 703, the user has issued an improper documentation command, e.g., HELP ERROR, the documentation facili~y calls menu faci]ity 35 at step 704.
The menu facility, by eliciting responses from the user, will attempt to determine what documentation the user wanted. once this has been determined, the menu acility formats a documentation request on behalf of the user and passes it back to the documentation facility.
It will be assumed, for purposes of illustration, that the user is executing MAP and has issued a documentation command requesting documentation or the "call" commandO As indicated at 706, it is now determined whether the last documentation requested by this user was for the same command that documentation is now being requested, iOe., "call~ That documentation is still 2~

available in outpu~ record list 1050 (discussed below)O) If it is, control passes directly to the marking/printing portion of the routine (FIGo 9)o Otherwise~ the documentation facility now determines at step 709 the name of the relevant system, and thus user, command documentation files_ in this example~
MAP.doc. As indicated at 711, the routine then consults a table that it maintains of the names of open documentation files to determine whether a file or files named MAP.doc is already open. If not, an attempt is made to open a file of that name in both ~he system and user storage areas, as indicated at 714.
At this point, it can be assumed that a system file under the name in question is open since a system file always exists~ A user file for the kind of documentation requested may not exist, ho~ever. Thus, it is determined at step 717 whether in fact there is an open user file named MAP.doc. If there is not, the routine proceeds directly to step 732 where the record or (in the case of continuations) records containing the documentation for the command in question is retrieved.
If, on the other hand, a user file named MAP.doc is open, an attempt is made at step 721 to retrieve therefrom user record(s) which document the command "call." If, as determined at step 724, there is no such record, meaning that the user has supplied no documentation for the "call" command, the routine again simply proceeds to step 732. If a user record does exist, however, its main record flag field (FIG. 6) is checked for the presence of an "R" or "N~" This would indicate that the user documentation for the "call" command is to replace the system documentation in toto, in which case step 732 is skipped since the system record containing the documentation for the "call" command will not be needed.
If, on the other hand, the user record is not such a replacement record, the system record must also be retrieved and, as before, step 732 is executed.

~ 14 ~

At this point, control passes to the record processing portion of the documentation facility, as indîcated at 734. This portion of the routine, shown in FIG. 8, begins with step 801t wherein the previously retrieved system documentation record, if anyJ is examined and decomposed~ This involves the making of entries in a so-called system record list 1010 depicted in FIG. 10. The system record list is a predefined array of data structures__system blocks 1020 _ each of which includes storage locations for holding the fol1Owing information from, or about, a respective section of the system record:
the section heading, which is store~ at location 1021; a pointer to ~he location of the section text, which is stored at location 1022; and a count of the number of characters in the text, which is stored at location 1023.
Referring back to FIG. 8, the routine now proceeds to step 803 at which the previously retrieved user documentation record, if any, is similarly examined and decomposed into a user record list 1030, also shown in FIG. 10. The user record list is comprised of user blocks 1040. Each user block, in addition to having storage locations for a section heading, a text pointer and a character count, which are stored at locations 1041, 1042 and 1043, respectively, has a storage location 1045 for the section flag value (A, BJ R or N) described above.
The system and user record lists are used to create a so-called output record list 1050 as will be described shortly. This list is comprised of an array of output blocks 1060, each of which has a storage location for the following information: a section heading, a pointer to a first text, a character count for the first text J a pointer to a second text, a character count for the second text and a print flag, which are indicated at 1061 through 1066, respectively.
In particular, the routine fills in output record list 1050 by executing a loop, as indicated in FIG. 8 at 808~ In each pass through the loop, it examines a successive one of system blocks 1020 and determines9 at step 811, whether there is a matching section heading in any one of user blocks 1040. ~f there is not, the routine proceeds to step 814 at which the section heading is copied from location 1021 in the system block into location 1061 in the next available one of output blocks 1060. In addition, the text pointer and character count are copied from locations 1022 and 10~3 of the system block into locations 1062 and 1063 of the output block as the first text pointer and first character count, respectively. The second text pointer in the output block, stored at location 1064, is cleared to a null string. The routine then loops around to process the next system block.
If, on the other hand, there is a section heading in one of user blocks 1040 which matches the section heading in the system block currently under consideration, the routine copies that heading into location 1061 of the next available output bloc~ at step 816 and then, at step ~19, sets the text pointers (and corresponding character counts) in the output block in accordance with the value of the section flag stored in the user block at location 1045. If, in particular, the section flag value is "A" (for "after")~ the first and second text pointers stored in the output block at locations 1062 and 1064 are given the values of the text pointers stored at locations 1022 and 10~12 of the system and user blocks, respectively, and similarly for the character counts. If the section flag is "B" (for "before"), the output block text pointers and character counts are assigned those same values but in the opposite order. If the section flag is "R" (for "replace") or "N" (for "new'), the system documentation for the particular section is to be wholly replaced by the user documentation. In this case, the first text pointer and character count in the output block are given the values of the user block text pointer and character count and the second output block text pointer is made a null string. As indicated at step 821, the user block in question is now marked as having been '~used" _ illustratively by making its section heading a null string.
Once all of system blocks 1020 have been processed in this way, the loop is exited and the routine passes to step 824. ~ere it scans user record list 1030 for any unmarked user blocks, i.e~, any blocks whose section headings are not null strings. The information from any such user block is copied into a respective one of the output blocks in the same way that the information in a system block which has no matching user block is copied into an output blocki as described above in connection with step 814. It will be appreciated from the foregoing that tha section flag value is irrelevant in this case.
As indicated at 826, the routine now proceeds to its section marking/printing portion, which is shown in FIG. 9. If the documentation command specified that only certain sections are to be displayed, as is determined a~
step 901, the print flag in the appropriate output block is set, as indicated at step 903c Otherwise, the print flags in all the output blocks are set, as indicated at step 904.
The documentation is now ready to be "printedr"
i.e., displayed to the user. First, the record key that was used for record retrieval is capi-talized and printed with double asterisks as the main heading at step 908 (e.g., **CALL** in Tables I and II). Then each block of output list 1050 is considered in turn via a loop which begins at 911. Within the loop, each output bloclc is first checked at step 913 to see if it has been marked for printing. If not, consideration passes to the next block.
If the block has been marked for printing, however~ -~he routine passes through steps 915, 916 and 919, at which, respectively, the section heading is capitalized and printed~ the first text specified in the output block is printed and the second text, if any, is printed.
Once all the output blocks have been considered, the routine returns to its caller.

:

Although a specific embodiment of the invention is shown and described herein, this is merely illustrative of the principles of the inventionO Those skilled in the art will be able to devise numerous arrangements which, althou~h not explicitly described herein, nonetheless embody those principles and thus are encompassed by the spirit and scope of the invention.

Claims (11)

Claims
1. An on-line documentation method for use in a computer system, said method comprising the steps of providing to individual users of said system, in response to issuance by said users of a particular documentation command, system documentation associated with that particular documentation command, and providing to at least one other user of said system, in response to issuance by said other user of said particular documentation command, user-specific documentation previously defined by said other user.
2. The invention of claim 1 wherein said computer system includes means for storing the system documentation associated with said particular documentation command and for storing system documentation associated with other documentation commands that can be issued by the users of said system, wherein said computer system further includes means for storing one or more user documentation texts associated with at least said particular documentation command and for storing an instruction associated with each user documentation text which indicates how that user documentation text is to be used to modify the stored system documentation associated with said particular command, and wherein the second of said providing steps includes the step of creating said user-specific documentation in accordance with each said instruction.
3. The invention of claim 2 wherein the system documentation associated with each documentation command includes one or more sections of system documentation text and wherein in said creating step each user documentation text associated with said particular documentation command is either added to a corresponding system documentation text, used to replace a corresponding system documentation text or used as a separate section in said user-specific documentation, as determined by the instruction associated with that user documentation text.
4. A method for use in a computer system in which documentation is displayed in response to associated documentation commands, said method comprising the step of displaying for each of a plurality of users of said system, in response to a particular documentation command issued by each of them, user specific documentation previously defined by said each user.
5. The invention of claim 4 comprising the further step of displaying for each other user of said system, in response to the issuance of said particular documentation command by said each other user, predefined system documentation associated with said particular documentation command.
6. The invention of claim 5 wherein said computer system includes means for storing for each of said plurality of users information indicating how the user-specific documentation to be displayed for that user differs from said system documentation and wherein the first of said displaying steps includes the step of creating said user-specific documentation in response to said system documentation and said information.
7. The invention of claim 6 wherein said information includes one or more user documentation texts and instructions indicating how each user documentation text is to be combined with said system documentation to create said user-specific documentation.
8. An on-line documentation facility for use in a computer system comprising first means for providing to individual users of said system, in response to issuance by said users of a particular documentation command, system documentation associated with that particular documentation command, and second means for providing to at least one other user of said system, in response to issuance by said other user of said particular documentation command, user-specific documentation previously defined by said other user.
9. The invention of claim 8 wherein said first and second means include means common thereto for storing the system documentation associated with said particular documentation command and for storing system documentation associated with other documentation commands that can be issued by the users of said system, and wherein said second means further includes means for storing one or more user documentation texts associated with at least said particular documentation command and for storing an instruction associated with each user documentation text which indicates how that user documentation text is to be used to modify the stored system documentation associated with said particular command, and means for creating said user-specific documentation in accordance with each said instruction.
10. The invention of claim 8 wherein said first and second means include means common thereto for storing the system documentation associated with said particular documentation command and for storing system documentation associated with other documentation commands that can be issued by the users of said system, wherein the system documentation associated with each documentation command is comprised of one or more sections of system documentation text, wherein said second means further includes means for storing one or more user documentation texts associated with at least said particular documentation command and for storing an instruction associated with each user documentation text which indicates whether that user documentation text is to be added to a corresponding system documentation text, used to replace a corresponding system documentation text or used as a separate section in said user-specific documentation, and wherein said second means further includes means for creating said user-specific documentation in accordance with each said instruction.
11. An on-line documentation facility for use in a computer system comprising documentation means normally operative for displaying system documentation in response to associated documentation commands issued by users of said system, and means for adapting the operation of said documentation means such that said documentation means displays in response to at least one documentation command issued by a particular user of said system a version of the associated system documentation modified in accordance with information previously specified by that user.
CA000427897A 1982-06-01 1983-05-11 On-line documentation facility Expired CA1189628A (en)

Applications Claiming Priority (2)

Application Number Priority Date Filing Date Title
US38357882A 1982-06-01 1982-06-01
US383,578 1995-02-03

Publications (1)

Publication Number Publication Date
CA1189628A true CA1189628A (en) 1985-06-25

Family

ID=23513767

Family Applications (1)

Application Number Title Priority Date Filing Date
CA000427897A Expired CA1189628A (en) 1982-06-01 1983-05-11 On-line documentation facility

Country Status (7)

Country Link
JP (1) JPS5941074A (en)
BE (1) BE896897A (en)
CA (1) CA1189628A (en)
DE (1) DE3319211A1 (en)
FR (1) FR2527808B1 (en)
GB (1) GB2121570B (en)
NL (1) NL191342C (en)

Families Citing this family (3)

* Cited by examiner, † Cited by third party
Publication number Priority date Publication date Assignee Title
JPS62232038A (en) * 1986-04-01 1987-10-12 Nec Corp Answering and explaining system in knowledge based system
JPH01161421A (en) * 1987-12-18 1989-06-26 Agency Of Ind Science & Technol Device for guiding operation method
US5712994A (en) * 1992-08-10 1998-01-27 International Business Machines Corporation Method and system for apparent direct editing of transient graphic elements within a data processing system

Family Cites Families (4)

* Cited by examiner, † Cited by third party
Publication number Priority date Publication date Assignee Title
GB561069A (en) * 1942-11-20 1944-05-03 Foster Wheeler Ltd Improvements in water tube boilers
US3839630A (en) * 1971-12-27 1974-10-01 Hewlett Packard Co Programmable calculator employing algebraic language
US4291198A (en) * 1979-06-28 1981-09-22 Bell Telephone Laboratories, Incorporated General-purpose electronic telephone station set
US4365315A (en) * 1980-09-08 1982-12-21 Kearney & Trecker Corporation System for multilingual communication of computer-specified aural or visual control messages in an operator-designated language

Also Published As

Publication number Publication date
GB2121570B (en) 1985-10-02
GB8314945D0 (en) 1983-07-06
NL191342B (en) 1995-01-02
FR2527808B1 (en) 1988-05-13
FR2527808A1 (en) 1983-12-02
JPS5941074A (en) 1984-03-07
NL8301935A (en) 1984-01-02
BE896897A (en) 1983-09-16
DE3319211A1 (en) 1983-12-01
JPH037986B2 (en) 1991-02-04
GB2121570A (en) 1983-12-21
NL191342C (en) 1995-06-01

Similar Documents

Publication Publication Date Title
US4800485A (en) On-line documentation facility
EP0752652B1 (en) System and method for implementing a hierarchical policy for computer system administration
EP0635794B1 (en) Document processing apparatus and method
US4891785A (en) Method for transferring data files between computers in a network response to generalized application program instructions
US5799308A (en) Method and apparatus for data storage and retrieval
US4205371A (en) Data base conversion system
US5144555A (en) Method and apparatus for supporting of making formatted document
EP0600979B1 (en) Code server
US5792659A (en) Terminal emulator enhancer with local configurability
US5748899A (en) Method and system for collecting and processing bar code data
US5884301A (en) Hypermedia system
US5758334A (en) File system remount operation with selectable access modes that saves knowledge of the volume path and does not interrupt an executing process upon changing modes
JPS6114528B2 (en)
JPH0664547B2 (en) Electronic Document Management Method for Interactive Information Handling System
EP0150273B1 (en) Multi-lingual system across nodes
CA1189628A (en) On-line documentation facility
JPH0727487B2 (en) How to introduce a control table for building search terms
EP0444669A2 (en) System for managing cooperative preparation of a document by a plurality of partakers
US5546573A (en) Specification of cultural bias in database manager
Codasyl Systems Committee Introduction to “feature analysis of generalized data base management systems”
Peat Practical guide to DBMS selection
US6032176A (en) Data-independent type computer system: processing machine, data machine and man-machine interface therein
EP0697666A1 (en) System and method for producing documents
EP4224335A1 (en) Database management methods and associated apparatus
KR100228548B1 (en) Database management apparatus for geographical information system

Legal Events

Date Code Title Description
MKEC Expiry (correction)
MKEX Expiry