1% Copyright The Numerical Algorithms Group Limited 1991.
2% Certain derivative-work portions Copyright (C) 1988 by Leslie Lamport.
3% All rights reserved
4
5% @(#)help.ht	1.9 92/06/24 17:09:42
6% Help page
7
8%%  % ----------------------------------------------------------------------
9%%  \begin{page}{TopHelpPage}{Help Menu}
10%%  % ----------------------------------------------------------------------
11%%
12%%  You are in ``\HyperName,'' \Language{}'s hypertext document browser.
13%%  This section describes how to make \HyperName do what you want.
14%%  \pp
15%%  This document is organized into pages.
16%%  Pages usually have active areas, marked in \downlink{this font.}{YouTriedIt}
17%%  An active area is usually linked to another page: clicking the mouse
18%%  in the active area moves you to the linked page.
19%%  The mouse cursor changes from a filled dot to an open circle when
20%%  it is in an active area.
21%%  You can try \downlink{this}{YouTriedIt} out now.
22%%  \beginscroll
23%%  You can select any one of the items below:
24%%  \beginmenu
25%%  \menulink{Quit Help}
26%%  {\ifcond\hasreturn ReturnPage\else UpPage\fi}
27%%	Go back to  what you were doing.
28%%
29%%  \item
30%%	\searchwindow{\menuitemstyle{Simple Search}}
31%%		     {\stringvalue{FindTopic}}
32%%	Find references to \inputstring{FindTopic}{15}{series}
33%%	\searchwindow{Start Search} {\stringvalue{FindTopic}}.
34%%
35%%  \menulink{Buttons}{ugHyperHeadingsPage}
36%%  Learn about the buttons at the top of the page.
37%%
38%%  \menulink{Menus}{MenuHelp}
39%%  Learn about menus.
40%%
41%%  %\menulink{Commands}{CommandHelp}
42%%  %	 Learn how to run \Language{} commands from \HyperName.
43%%
44%%  \endmenu
45%%  \endscroll
46%%  \end{page}
47
48%%  % ----------------------------------------------------------------------
49%%  \begin{page}{ButtonHelp}{Know These Buttons}
50%%  % ----------------------------------------------------------------------
51%%  \beginscroll
52%%  All pages have a standard set of buttons at the top.
53%%  \newline
54%%  This is what they mean:
55%%  \par \ExitBitmap   \space{} Leave \HyperName.
56%%  \par \HelpBitmap   \space{} Get help, if there is any.
57%%  \par \UpBitmap     \space{} Go back to the previous page.
58%%  \par \ReturnBitmap \space{} Return to the home menu.
59%%  \newline
60%%  \pp
61%%  \HyperName remembers where you came from.
62%%  You can always make forays into new topics
63%%  without worrying about how to get back.
64%%  \pp
65%%  The buttons at the top of the page can be used at any time
66%%  to return to what you were doing.
67%%  \pp
68%%  The buttons will not be displayed if they are not applicable to the page
69%%  you are currently viewing.	So, for example, there is no ``HOME'' button
70%%  on the top-level menu.
71%%  \endscroll
72%%  \end{page}
73
74%%  % ----------------------------------------------------------------------
75%%  \begin{page}{MenuHelp}{Menus}
76%%  % ----------------------------------------------------------------------
77%%  \pp
78%%  \beginscroll
79%%  A `menu' is a list of topics.
80%%  You went through at least one to get here without even trying.
81%%  \newline
82%%  To choose a topic from a menu, you click on the active area
83%%  for the topic.
84%%  \horizontalline
85%%  Here is a menu to practice:
86%%  \newline
87%%  \beginmenu
88%%  \menulink{Hypertext}{WhatIsHyperText}  What is hypertext?
89%%  \menulink{\HyperName}{WhatIsHyperDoc}  What is \HyperName?
90%%  \menulink{Buttons}{ugHyperHeadingsPage}  Headings in HyperName{}.
91%%  \endmenu
92%%  \endscroll
93%%  %\autobutt{HelpHelp}
94%%  \end{page}
95
96%%  % ----------------------------------------------------------------------
97%%  \begin{page}{WhatIsHyperText}{What is hypertext?}
98%%  % ----------------------------------------------------------------------
99%%  \beginscroll
100%%  A ``hypertext'' document is a structured entity which is part book
101%%  and part program.
102%%  You can think of it as a museum with many exhibits you can try.
103%%  \newline
104%%  ``\HyperName'' is a computer program for presenting \Language{}'s \HyperName
105%%  documents.
106%%  \endscroll
107%%  %\autobutt{HelpHelp}
108%%  \end{page}
109%%
110%%  \begin{page}{WhatIsHyperDoc}{What is \HyperName?}
111%%  \beginscroll
112%%  This is \HyperName, a program for reading hypertext documents.
113%%  The name comes from the fact that the pages of the document are
114%%  composed using a variant of the ``TeX'' typesetting language.
115%%  \endscroll
116%%  %\autobutt{HelpHelp}
117%%  \end{page}
118
119%%  % ----------------------------------------------------------------------
120%%  \begin{page}{ExamplesHelp}{\Language{} Examples}
121%%  % ----------------------------------------------------------------------
122%%  \pp
123%%  \beginscroll
124%%  Many pages have \Language{} examples.  These are ``active''
125%%  also but if you click here, the example is copied to an
126%%  interactive \Language{} ``buffer.''
127%%  You can then edit it or use it as a command for the \Language{} interpreter.
128%%  Try these: \newline
129%%  \indent{5}
130%%  \spadcommand{a:= x^2 + 1 \bound{a}} \newline
131%%  \spadcommand{(a - 2)^2 \free{a}} \newline
132%%  \indent{0}
133%%  Notice that the \Language{} examples are printed in a different font.
134%%  \pp
135%%  The interactive \Language{} buffers will disappear when you leave
136%%  \HyperName.
137%%  If you want to get rid of them beforehand,
138%%  you can always use the ``Cancel'' button of the X window manager.
139%%  \endscroll
140%%  %\autobutt{HelpHelp}
141%%  \end{page}
142