HELP information is organised in numbered sections presented as a data "tree". Each section (node) on the tree may branch out into a number of subsections thus section 3 may have subsections 3.1, 3.2 etc. These may have sub-sub-sections 3.1.1, 3.1.2 and so on. A section may run to more than one screenful so a page number may be appended (e.g. 3.1.2/4).
Each file may also have a file "Header" which will be displayed if no section is specified. It represents the "root" of the tree and may be reached at any time by typing the <HOME> cursor or requesting section 0.
You may move up or down the tree by using the cursor keys plus a few other commands (detailed below). You can go directly to a section or page by quoting its section number (displayed at the top right-hand corner of the screen) or by searching the tree for a match to part or all of the frame title (the text above the horizontal line).
Type <carriage-return> for the next page
Parameters:
You may call HELP with one or two optional parameters. The general form is
HELP [<topic>][,<text>] ( [,<,>,] are meta-characters not part of the call)
<topic>
should be one of the topics listed in the top-level directory (see
below). Only the most general topics within HELP are accessible in
this way. You will probably have to enter HELP and search
under one or more general topics in turn.
If <topic> is omitted an index of general topics will be displayed
and you will be invited to select one.
<text>
If this optional parameter is included, HELP will search for <text>
first among the page titles and if that fails it will scan the text
and produce a list of matches.
The commands available to you are:
<Carriage-Return>
or <DOWN cursor>
Move to the next page. This will be the next page in a
section or if you are at the end of a section, the next
section.
-
Move to the previous page. This is the previous page in a
section or if you are at the start of a section, the last
page of the previous section.
<HOME cursor key>
Go to the top of the file. HELP information is orgainsed in
files, with the start of a tree at the start of each file.
You will usually but not necessarily enter the tree at the
top, so HOME may take you back beyond your starting point.
<UP cursor key>
Go up one level. If you are in a subsection, this command
will take you to the start of the parent section. If you are
at the top of the file it will take you into the top level
index (see below).
<m.n>
Go to section <m.n>
<topic>
locate topic. HELP will search the current file for this
topic. HELP will first search the page titles and if this
fails will search the text and produce a concordance. If you
want to force HELP to perform the text search, enclose
<topic> in single quotes.
Q or QUIT
Leave Help
?
Obtain a brief summary of HELP commands.
The HELP information resides in a set of files in directory VIEW:. Each file appears to the user as a tree but there is also a "top-level" index which helps you identify which file you require. This index is displayed if HELP is called with no parameters or if you move UP beyond the top of your current file. There is not room to put all the possible topics of interest in the top-level index so you may have to adopt a two-stage search as follows:
Type HELP with no parameters (or type <HOME> then <UP> from within HELP). If your topic is in the top index, go there. If not, choose a likely topic from the list (HELP DOCUMENTS gives some help here) and use its index or search the file for what you want. Some material is documented on hard copy only (or not at all!). HELP DOCINDEX gives some indication as to where this can be found.
HELP SUMMARY gives you a list of the titles of help pages and is intended as a quick reference to the HELP database. Don't get confused between the sections within SUMMARY and the sections themselves.
Hard copy of HELP information can be obtained only by listing the appropriate file to the printer. It will contain tree directives but will otherwise be perfectly readable. The current filename is usually printed at the top right hand corner of each frame, in square brackets.
!<TOPIC Starts a new section or subsection
!> Terminates it.
These directives should start at the beginning of a line. All text to the right of the !< command will be taken to be the section title. Text to the right of the !> is ignored. I suggest authors place their initials and a date here. Sections may be nested to any reasonable depth. Text in front of the first section marker will be displayed on the screen when the file is entered from the top (The file "Header"). This may be addressed as section 0.
!PAGE forces a new page (screenful) to be thrown at that point.
Material for inclusion in HELP may be examined by calling HELP with the full filename (you must specify a directory or HELP will look in VIEW:). Once the material is ready for inclusion it should be transferered to the VIEW: directory and an entry made in the HELP index file 0INDEX. Entries are displayed on the screen in the order they appear in the file so new entries should be included in their correct alphabetical order. Entries take the form..
<Topic> <Filename> <Section>
<Topic>
describes the material being included. Only topics in the index may
be accessed by calling HELP <topic> or through the Topic: prompt.
<Filename>
indicates which file should be loaded. If <Filename> is omitted
VIEW:<Topic> will be taken by default. <Filename> need not be in
VIEW:. <Filename> MUST be specified if <Section> is specified.
<Section>
indicates which Section in <Filename> should be displayed. If
<Section> is omitted the file Header will be displayed and the user
prompted for a section. If <Section> is 0 then the file will be
searched for a match to <Topic>. HELP can be speeded up
considerably by specifying sections explicitly but at the expense
of having to change the index if new sections are added.
HELP
Simplest form of command. HELP will then guide you
through the database.
HELP LASER
Takes you directly to the section on the LASER command.
HELP QUOTE
Won't help you - QUOTE is too specific a topic. You'll
have to do a HELP APM then HELP QUOTE.
HELP
<carriage-return>
Takes you into the APM file (by default)
HELP JIM:INFO
Looks at a user HELP-format file.
There is no "print" command built into HELP or VIEW.
These utilities use an index file VIEW:0INDEX which crossreferences subject headings by the files they appear in. You can then locate the appropriate files and print them (nasty, isn't it?!)
LaTeX and LAYOUT versions of some of these documents exist in the directory MANUAL:.
You can usually prepare LaTeX source from a VIEW: file with the utility MANUAL:VTOT.
There's no index yet though there will be once I get organised...
view:help printed on 15/02/89 at 21.51