diff options
author | Norbert Preining <norbert@preining.info> | 2024-01-30 03:00:44 +0000 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2024-01-30 03:00:44 +0000 |
commit | 084f5d8435744b7ea7ef487ec111a7bfd100ed62 (patch) | |
tree | d4e91f6ef6d075509a2b33942f57337725089951 /macros/hptex/hpmanual.tex | |
parent | 6c43653052d016d5913aabb728c484f0e62b4754 (diff) |
CTAN sync 202401300300
Diffstat (limited to 'macros/hptex/hpmanual.tex')
-rw-r--r-- | macros/hptex/hpmanual.tex | 1240 |
1 files changed, 0 insertions, 1240 deletions
diff --git a/macros/hptex/hpmanual.tex b/macros/hptex/hpmanual.tex deleted file mode 100644 index b776529494..0000000000 --- a/macros/hptex/hpmanual.tex +++ /dev/null @@ -1,1240 +0,0 @@ -% THIS IS FILENAME MANUAL -% -% ***This is the Users' Guide to the HP TeX Macro package *** -% -% Copyright 1984 Hewlett-Packard Co. -% -\let\indx=\relax -\def\evenheading{\vbox{\hbox to \hsize{\eightrm Page \folio\hfil\HPTEX} - \nointerlineskip\vskip2pt - \hbox{\vrule width \hsize height .4pt}}} -\def\oddheading{\vbox{\hbox to \hsize{\eightrm Macros \hfil Page \folio} - \nointerlineskip\vskip2pt - \hbox{\vrule width \hsize height .4pt}}} -\def\noheading{\hfil} -\headline{\ifnum\pageno=1\noheading - \else\ifodd\pageno\oddheading - \else\evenheading\fi\fi} -\centerfooting{} - -\tolerance=1000 -\noindentstyle -\font\hplogo=hplogo -\font\csc=amcsc10 \def\headno{\levelno} \def\emspace{\enspace} -\def\lb{$\langle$} \def\rb{$\rangle$} -\def\bs{{\tt \char92}\relax} -\font\bo=amb10 -\font\tenbo=amb10 -\def\+{{\tt \char92}\relax} \def\_{\kern.06em\vbox{\hrule width.5em}} -\def\[{$\{$} \def\]{$\}$} \def\tbw{{\bf - TO BE WRITTEN -}} -\def\ent{\textbox{\tt ENTER}} \def\sec{{\bf -SECTION NUMBER HERE-}} -\def\degrees{$^\circ$} -\def\gt{$>$} -\def\spacechar{\hskip1pt\lower3pt\vbox{ - \hbox to 5pt{\vrule height4pt width.009in - \hfill - \vrule height4pt width.009in} - \hrule depth.009in height0pt}\hskip2pt} - -\firstlevelhead{\need.75in\null\bigskip\leftline{\fourteenbf\levelno\enspace% - \title}% - \medskip\ctswrite{\hskip15pt\tenrm\title}} -\secondlevelhead{\need.6in\medskip\leftline{\twelvebf\levelno\enspace\title}% - \ctswrite{\hskip30pt\tenrm\title}} -\thirdlevelhead{\need.5in\medskip\leftline{\twelvebf\levelno\enspace\title}% - \ctswrite{\hskip45pt\ninerm\title}} - -\def\bs{{\tt \char92}\relax} -\def\+{{\tt \char92}\relax} - -\def\tspec{\lb{\sa table spec.}\rb} -\def\colspec{\lb{\sa column spec.}\rb} -\def\col{\lb{\sa column list}\rb} - - -\def\cmd#1{\need 0.5in\bigskip {\tentt\bs #1}\lbreak} -%\def\mcmd#1{\need 0.5in\bigskip {{\tentt\bs #1}}\lbreak} -%\def\\#1{\lbreak\indent{{\tentt\bs #1}}} -\def\lb{$\langle$} -\def\rb{$\rangle$} -\def\[{$\{$} -\def\]{$\}$} -\def\blk{\lb{\sa blockname}\rb} -\def\hor{\lb{\sa horizontal list}\rb} -\def\int{\lb{\sa integer}\rb} -\def\dim{\lb{\sa dimension}\rb} -\def\ver{\lb{\sa vertical list}\rb} -\def\vol{\lb{\sa Volume Name}\rb} - -\null -\vskip1in -\centerline{\eighteenbf THE HP \TeX\ MACROS}\footnote{}{\eightrm\copyright - 1984 Hewlett-Packard Co.} - -\vskip.5in -\centerline{HEWLETT-PACKARD CO.} -\vskip1.47in - -\level1{Introduction} -This set of macros was written as part of \HPTEX, Hewlett-Packard's software -package designed to facilitate the use of \TeX\ on the HP Series 200 Desktop -Computers. The \HPTEX\ program can be run on either an SRM based, or a -stand-alone (LIF) system, and requires 1.25 Mbytes main memory and a minimum -of 15 Mbytes mass storage. It uses an HP 2688A Laser Printer. - -The HP2688A is a page printer which uses scanned electrophotography technology -to print computer output on single sheet paper. The 300 dots per inch -resolution, high contrast and speed, plus sophisticated character printing, -allow a high degree of application flexibility. Unique features include -90\degrees\ rotation of page print, multiple pages of data output per printed -sheet, and a graphics option. The print rate is approximately 12 pages per -minute. - -The \HPTEX\ macro package is designed to supplement \TeX\ by providing macros -for formating documents and for controlling the HP2688A. The user of \HPTEX\ -can use any of the \TeX\ commands as well as the \HPTEX\ macro commands. - -While the formating macros include macros for headings and footings, -paragraph style, lists, lines, boxes, paragraph headings, multiple columns, -tables, and table of contents, they are not meant to be a complete system. -They are intended to enable the user to get -started, and to provide useful macros that can be modified and used as -examples by the user for the creation -of a customized macro package. - -A second release of \HPTEX\ is planned that will include graphics capability. - -\vfil -On \indx{syntax} -lines, when curly braces ``\[$\ldots$\]'' are shown, they are required in the -source file, text between -angle brackets ``\lb$\ldots$\rb'' identifies a parameter variable, -and the character ``\spacechar '' represents a required space. -\vfil\eject - -\level1{ Document Formatting Macros} -The following HP \TeX\ commands control the basic style and formatting -of a document: - -\level2{Page Layout} -The HP \TeX\ defaults for \indx{page layout} are the same as they are in -the \TeX\ program. That is, -all margins are set to approximately -one inch from the edges. (Plain \TeX\ sets {\tt \+vsize=8.9in} and -{\tt \+hsize=6.5in}.) \indx{Headings and footings} are printed {\bo outside} -those margins. - -The following macros affect the running head and the footing of -each page. The heading and footing lists are expanded during the -output routine so the \TeX\ commands \indx{{\tentt\bs firstmark}}, -\indx{{\tentt\bs topmark}} and -\indx{{\tentt\bs botmark}} are compatible here. - -\need.5in\bigskip\relax{{\tentt \+centerheading}}\[\hor\]\lbreak - \relax{{\tentt \+leftheading}}\[\hor\]\lbreak - \relax{{\tentt \+rightheading}}\[\hor\]\lbreak - \relax{{\tentt \+outsideheading}}\[\hor\]\lbreak - \relax{{\tentt \+insideheading}}\[\hor\]\lbreak -These macros accept text which is to be placed at the top of every page. -The first three macros place the argument in the center, left, or right -of the page respectively. -{\tt\bs outsideheading} and {\tt\bs insideheading}, -if specified, override the left and right headings. On odd pages, the -inside heading will appear on the left, outside on the right. Even -pages are the opposite. (This feature is helpful when the output is -to be used as two-sided copy.) - - -\need.5in\bigskip\relax{{\tentt \+centerfooting}}\[\hor\]\lbreak - \relax{{\tentt \+leftfooting}}\[\hor\]\lbreak - \relax{{\tentt \+rightfooting}}\[\hor\]\lbreak - \relax{{\tentt \+outsidefooting}}\[\hor\]\lbreak - \relax{{\tentt \+insidefooting}}\[\hor\]\lbreak -These are like the above commands, only they are for footings at the bottom -of each page. For example, if page numbers -are desired in the left side of the bottom of each page, type: -{\tt\bs leftfooting\[\indx{\bs folio\]}} - -{\tt\bs outsidefooting} and {\tt\bs insidefooting} will -produce similar results as {\tt\bs outsideheading} and -{\tt\bs insideheading} (see above). The default in HP \TeX\ is -{\tt \+centerfooting\[\+folio\]}. This produces page numbers at -the center of the bottom of each page. - -\need.5in\bigskip\relax{{\tentt \+noheading}}\lbreak - \relax{{\tentt \+nofooting}}\lbreak -These macros turn off headings or footings for the current and all -successive pages until the {\tt\bs resumefooting} or -{\tt\bs resumeheading} command is used. - -\need.5in\bigskip\relax{{\tentt \+suspendheading}}\int\lbreak - \relax{{\tentt \+suspendfooting}}\int\lbreak -These macros suspend headings or footings for the specified number of -pages or until the use of a {\tt\bs resumeheading} or {\tt\bs resumefooting}. - -\need.5in\bigskip\relax{{\tentt \+resumeheading}}\lbreak - \relax{{\tentt \+resumefooting}}\lbreak -These macros undo the effects of the {\tt\bs suspendheading}, -{\tt\bs noheading}, {\tt\bs suspendfooting} and -{\tt\bs nofooting} macros above. - -\break -\level2{Paging} - -\cmd{\indx{newpage}} -This macro forces a \indx{page eject} if not on a new page.\note{\tenpoint -If {\tt \+newpage, \+oddpage}, or {\tt \+evenpage} -occur at the bottom of a full page, they will cause an extra page -eject. If this happens, insert an {\tt \+eject} just before the -page command.} - -\cmd{\indx{oddpage}} -This macro causes a page eject, and if the current page is an odd-numbered -page, leaves an extra blank page so that the following text is -guaranteed to begin on an odd-numbered page. - -\cmd{\indx{evenpage}} -This macro is similar to oddpage, but the following text will appear on -an even rather than an odd numbered page. - -The {\bo plain} \TeX\ command, {\tt\+pageno} will set the current page number -to the specified page number. (See ``Some Useful \TeX\ Commands'' in -Chapter~2 of this manual.) - -\level2{Paragraph Style} -As \TeX\ accepts text from the input file, the text is formatted into -paragraphs. The following commands can be used to control the shape -of the paragraphs. - - -\cmd{\indx{inset}=\dim} -Specifies a general amount of indentation to be used with itemized -lists, notes, warnings and indent blocks. Default is 0.5 - inch. - -\need.5in\bigskip\relax{{\tentt \+start\[indent\]}}\lbreak - \relax{{\tentt \+finish\[indent\]}}\lbreak -These commands are used to indent the left margin by the inset -dimension. The right margin is unaffected by this block. - -\cmd{\indx{indentspace}=\dim} -This command assigns the indentation value for the first line of all succeeding -paragraphs when {\tt\bs indentstyle} is in effect. The default is -20 points. - -\cmd{\indx{indentstyle}} -This causes the first line of each paragraph to be indented -(the amount of the indentation is assigned by the {\tt\bs indentspace} -command). This is the default paragraph style. - -\cmd{\indx{noindentstyle}} -This causes the paragraphs to be formatted with no indentation. -The nominal \indx{spacing} between paragraphs is 5 points greater without -indentation than when {\tt\bs indentstyle} is being used. -\start{note} -\centerline{-- NOTE --} -Spacing between paragraphs can be user specified by using the {\tt -\bs parskip} command. -\finish{note} - -\level2{Itemized and Bulleted Lists} -The following macros are aids in producing lists. The various list commands -cause indentation at various levels and use various tokens (numbers, letters, -dots, dashes, $etc.$) to the left of the -first line of the listed item to set off the list entry. - -\need.5in\bigskip\relax{{\tentt \+numbereditems}}\lbreak - \relax{{\tentt \+lettereditems}}\lbreak - \relax{{\tentt \+Lettereditems}}\lbreak - \relax{{\tentt \+romanitems}}\lbreak - \relax{{\tentt \+Romanitems}}\lbreak - \relax{{\tentt \+squareditems}}\lbreak - \relax{{\tentt \+dotteditems}}\lbreak - \relax{{\tentt \+dasheditems}}\lbreak -These macros initialize the tag allocation macro {\tt\bs itemtag}. -Default is {\tt\bs numbereditems}. - -\need.5in\bigskip\indx{{\tentt \+numberedsubitems}}\lbreak - \relax{{\tentt \+letteredsubitems}}\lbreak - \relax{{\tentt \+Letteredsubitems}}\lbreak - \relax{{\tentt \+romansubitems}}\lbreak - \relax{{\tentt \+Romansubitems}}\lbreak - \relax{{\tentt \+squaredsubitems}}\lbreak - \relax{{\tentt \+dottedsubitems}}\lbreak - \relax{{\tentt \+dashedsubitems}}\lbreak -These macros initialize the tag allocation macro {\tt\bs subitemtag}. -Default is\lbreak {\tt\bs letteredsubitems}. - -\cmd{\indx{itemtag}} -This macro causes a number, letter, roman numeral, square, dot or dash -to be printed as the item specifier -depending upon what initialization has taken place (see above). - -\cmd{\indx{subitemtag}} -Similar to {\tt\bs itemtag} but pertains to subitems. - -\cmd{\indx{square}} -This macro prints a .4em-by-.4em square ( \square\ ). This macro can be used at -any time a horizontal list is being built (such as the middle of a -paragraph), -but it is particularly useful as the argument for the {\tt\bs itemlist} macro. -(This command produces the same symbol as \TeX 's {\tt \+bull} command.) -\cmd{\indx{dott}} -This macro prints a solid round dot ( \dott\ ). (Same as {\bo plain} \TeX 's -{\tt \$\+bullet\$}.) - -\cmd{\indx{emdash}} -Sets a horizontal rule one ``\indx{em}'' long ( \emdash\ ). - -\cmd{\indx{itemlist}\[\hor\]} -This macro introduces an item of a list by indenting both left and right -margins by the \dim\ specified in the last {\tt\bs inset} command. -The \hor\ is inserted within braces to specify the token -which is to set off the text. If the token has already been -specified (using {\tt \bs dotteditems, \bs Romanitems}, $etc.$), -or the default {\tt \bs numbereditems} is acceptable, -then the command {\tt \bs itemtag} can be inserted here. -The text of the item follows. (The text -does {\bo not\/} need to be enclosed within braces.) -Indentation continues only for the duration -of one paragraph (if more than one paragraph is desired in an -item, {\tt\bs itempar} should be used). -The use of {\tt\bs itemlist} resets the subitem tag. - -\cmd{\indx{subitem}\[\hor\]} -This macro is similar to {\tt\bs itemlist}, but the indentations are twice as -large as for {\tt\bs itemlist}. This can be used to indicate a - second level of list. (See {\tt \bs itemlist} for contents of - the \hor . - -\need.5in\bigskip\relax{{\tentt \+itempar}}\lbreak - \relax{{\tentt \+subitempar}}\lbreak -These macros are used to start new paragraphs within an item or -subitem respectively. - -\cmd{\indx{enditems}} -This commands properly ends an itemized list by resetting the item counter -and appending {\tt\bs bigskip} \indx{glue}. - -\cmd{\indx{itm}} -Similar to {\tt\bs itemlist\[\bs itemtag\]} except that a -period is appended to the tag if it is a letter, number -or roman numeral. With this command, the item tag must be -specified ahead of time using the command -{\tt \bs dotteditems, \bs lettereditems}, $etc.$, unless the -default ({\tt \bs numbereditems}) is acceptable. Again, -{\tt\bs itm} will {\bo not} accept any \hor\ -as an item tag specifier. - -\cmd{\indx{sitm}} -Similar to {\tt\bs itm} but pertains to subitems. Like -{\tt\bs itm}, {\tt\bs sitm} will {\bo not} -accept any \hor\ as a subitem tag specifier. The subitem tag must -be specified beforehand, unless the default -({\tt \bs letteredsubitems}) is acceptable. -%\need3in -\start{note} -\centerline{-- NOTE --} -If you enter a local \indx{block structure} prior to setting an itemized list, -and want to exit that structure immediately after your last item, then -you must first be sure that you are in {\bo \indx{vertical mode}}. -Otherwise, the last item may not be indented properly. - -Three ways to accomplish this are by using {\tt\bs enditems, -\bs vskip}, or {\tt\bs par}. \finish{note} - -\level2{Line Specifier Macros} -The content of individual lines can be controlled, and they can be -centered or justified using the following -commands. - -\cmd{\indx{centerline}\[\hor\]} -This takes the text within the brackets and centers it between the -margins. The line does not count as a paragraph, so the normal -interparagraph space is not inserted above the line. If this command -follows a paragraph, it is -usually appropriate to precede it with a {\tt\bs vskip}. This command -has been redefined from {\bo plain} \TeX\ in that it uses the -HP macro {\tt \+lline} (described below), so {\tt \+leftskip} -and {\tt \+rightskip} values are taken into account. - -\cmd{\indx{lline}\[\hor\]} -This is very similar to the plain \TeX\ {\tt\+line} command -in that it creates a horizontal box that is the width of the current -{\tt\+hsize}, except that {\tt\+lline} takes into account -the values of {\tt\+leftskip} and {\tt\+rightskip} -if they have been specified. In other words {\tt\+lline} -stays within the current margins. The \hor \ is the contents of -the horizontal box. - - -\cmd{\indx{leftline}\[\hor\]} -This left justifies the contents of the \hor . The comments about vertical -spacing above apply here, also. This command has also been redefined -to use {\tt \+lline} (see {\tt \+centerline}, above). - -\cmd{\indx{rightline}\[\hor\]} -This right justifies the contents of the \hor . The comments about vertical -spacing above apply here, also. This command has also been redefined -to use {\tt \+lline} (see {\tt \+centerline}, above). - -\cmd{\indx{raggedright}} -The {\tt\bs raggedright} macro causes paragraphs to be formatted -in such a way that they are not necessarily justified -on the right margin. This command has also been redefined from -{\bo plain} \TeX\ in that {\tt \+rightskip} values are preserved. - -\cmd{\indx{justify}} -This macro has the opposite effect of the {\tt\bs raggedright} macro -and causes the text to be right justified -({\tt\bs justify} is the default in HP \TeX ). - -\level2{Boxes} - -\cmd{\indx{boxline}=\dim} -This macro assigns the width of the lines used for {\indx{boxes}. The default -boxline dimension is 0.01332 inch. - -\cmd{\indx{boxspace}=\dim} -This macro assigns the width of the space between a boxed item and -the line of the box. The default width in HP \TeX\ is 5 points.\super{4} - -\cmd{\indx{boxit}\[\hor\]} -This macro encloses the argument in a box. If encountered -while making a line of text, the box's bottom line will -be along the baseline of the text. The \hor\ may contain multiple -lines separated by {\tt\bs cr} to be centered within the box. Note -that each line is then treated as a {\bo group}, so font changes, -$etc.$~on one line will not affect the next line. - When using this command, the \hor\ will be -raised somewhat above the line, \boxit{like this.} -If you desire that the text not be raised above the baseline, -use the {\tt\bs textbox} command (described below). - -\cmd{\indx{textbox}\[\hor\]} -This command causes a box to be placed around the \hor , -{\bo without} altering the text, \textbox{like this.} A -textbox cannot be broken from one line of text to another. - -\cmd{\indx{centerbox}\[\hor\]} -This macro centers a box horizontally on the page -and inserts space above and below. -Multiple lines can be specified using {\tt\bs cr} (see -{\tt \bs boxit} description). A {\tt \+centerbox} within a - {\tt \+centerbox} will not work, but {\tt \+boxit} inside - {\tt \+centerbox} will. - %\need1.25in -\level2{Notes and Warnings} -Two other text structures available with the HP \TeX\ macro package are notes -and warnings. - -\need.5in\bigskip\relax{{\tentt \+start\[note\]}}\lbreak - \relax{{\tentt \+finish\[note\]}}\lbreak -A note is inset twice the {\tt\bs inset} dimension on both margins and -set apart from the rest of the text by extra vertical space. -If a note would otherwise start less than half an inch from the -bottom of a page, a page eject is performed prior to the note. -{\tt\bs finish\[note\]} signifies the end of the note. - -\need.5in\bigskip\relax{{\tentt \+start\[warning\]}}\lbreak - \relax{{\tentt \+finish\[warning\]}}\lbreak -A warning is similar to a note, except that is also set apart by horizontal -rules above and below the text. {\tt\bs finish\[warning\]} -signifies the end of the warning text. - -\level2{Verbatim Mode} -Verbatim mode will cause text to be printed ``as is,'' -without any justification. Special characters in this mode -are the backslash (\bs ) and the curly brackets (\[), (\]). -Most other characters can be used and will be printed \indx{verbatim}. - -Verbatim mode is intended for use with simple text which does -{\bo not} contain a large number of control sequences. -The reason for this restriction is that there are many -characters (such as a space, a \indx{tilde}, $etc.$) -which take on different meanings in verbatim mode. Some of these may be -imbedded within a control sequence and can cause -problems when they are expanded. - -You will usually want to select a ``non-proportionally spaced'' -font (like ``tt'') for use in verbatim mode. The -reason for this is that ``proportional fonts'' (like ``rm'') -will cause the printed output to be aligned differently -than what appears on the CRT during source file typing. Other -non-proportional fonts available with the HP 2688A Laser Printer - are Courier, Gothic, Pica, Script, Prestige and Line Printer. - -\start{note} -\centerline{-- NOTE --} -Although verbatim mode using \indx{non-proportional fonts} will -{\bo usually} produce output -that exactly matches what you see on the CRT, there is -at least one exception to this. Long sequences of characters - may be spaced -slightly differently than a string -of blank spaces of identical length . This is -a result of the rounding anomalies that occur when \TeX 's -{\bo ideal} character sizes are converted to the printer's -{\bo actual} sizes. -\finish{note} -\cmd{\indx{start\[verbatim\]}} -This macro causes the following text to be printed ``verbatim'' -without any justification. - -\cmd{\indx{finish\[verbatim\]}} -This macro ends the verbatim mode described above. - -%\need1.25in -\level2{Paragraph Levels} -These macros can be used to create \indx{paragraph headings} -of four different levels. -The \hor, and page number can be written -to the file \lb{\sa jobname}\rb\lower.3em\hbox{*} -to be used for a table of contents (the asterisk ``\lower.3em\hbox{*}'' -signifies the {\tt contents} file). - -The command {\tt\+ctswrite\hor} will automatically open a file and write the -\hor\ and the page number to the file. The {\tt\+contents} command -then uses the \lb{\sa jobname}\rb\lower.3em\hbox{*} file to -create the \indx{table of contents} (refer to the {\tt\+contents} command -description in this section). - -\cmd{\indx{level}\lb\sa integer between 1 and 4\rb\[\hor\]} -This is the command used to print a paragraph heading. Whatever -format is specified using the commands listed below ({\tt \+firstlevelhead, -\+secondlevelhead}, $etc.$) will be used. For example, the command used to set -the paragraph heading of this section looked like this: - -\centerline{\tt \+level3\[Paragraph Levels\]} - -The {\tt \+level} command will automatically update the {\tt\bs levelno} -to print the paragraph head. - -\need.5in\bigskip\relax{{\tentt \+firstlevelhead}}\[\hor\]\lbreak -\relax{{\tentt \+secondlevelhead}}\[\hor\]\lbreak -\relax{{\tentt \+thirdlevelhead}}\[\hor\]\lbreak -\relax{{\tentt \+fourthlevelhead}}\[\hor\]\lbreak -These commands specify the tokens that are inserted to format -each of the various head levels. They should be used when the -default conditions of HP \TeX , as described below, - are not satisfactory. A control sequence {\tt \bs title} -is defined to be the \hor\ from the corresponding {\tt \bs level} -command. For example, the command: -\start{verbatim}\tt{\hfuzz=31pt - \+secondlevelhead\[\+need.75in\+bigskip\+leftline\[\+fourteenbf% - \+levelno\+enspace\+title\]\+medskip% - \+ctswrite\[\+hskip15pt\+tenrm\+title\]\]} - \finish{verbatim} -\vskip3pt\noindent - would cause all second level paragraph heads to be printed on -a new page if less than .75 inch remains on the current page. -The title will be left justified in fourteen point boldface -type. The level number is followed by an ``enspace.'' - ``Bigskip'' \indx{glue} is inserted before the title with a ``medskip'' -after. The \indx{{\tentt\+ctswrite}} command specifies how the -level heading will be written in the table of contents, as -described below. - -Whenever you define a {\tt \bs firstlevelhead, \bs secondlevelhead}, $etc.$, -command to specify the formatting of paragraph headings, you must also -specify how it will be written in the table of contents (if -you plan to create one). The command for doing this is -{\tt \bs ctswrite}. For example, the fourth level head was -redefined from the HP \TeX\ defaults in this document, and the -contents writing command was used as follows:\lbreak -\centerline{\tt \bs ctswrite\[\bs hskip45pt\bs ninerm\bs title\]} -This causes all fourth level headings in the table of contents -to be inset 45~points and be written in nine--point roman type. - -The default HP \TeX\ paragraph level headings -are formatted as follows: {\tt \bs level1} begins on a new page, -prints the title in 14 point bold face type and down 1.5 inches -from the top of the page. {\tt \bs level2} - requires that at least .75 inch remain on the -page. If so, the title is printed with some vertical space above it, -otherwise, it is set on the top of the next page. In any case, it is printed -in 12 point boldface type. {\tt \bs level3} and -{\tt \bs level4} are similar, but -require less space to remain on the page and print the title in 10 -point bold face and 10 point roman respectively. - -The ``levelhead'' macros are {\bo local} to -their \indx{block structure}. This provides a simple means -to return to the HP \TeX\ default levelhead -style. All you would need to do is enclose the command -and any text you want affected within braces. After the -closing brace, \TeX\ will return to the default format. Note -that this should only be attempted for {\bo shorter} blocks. -Creating large blocks of several pages in length can cause -\TeX\ to run out of memory. - - -\start{note}\centerline{-- NOTE --} -If you need to change the font style or size within a level -heading, you must specify the {\bo entire} font name, -(for example: {\tt \bs tentt}$\ldots$ not {\tt \bs tt}). -\finish{note} -\cmd{\indx{levelno}} -This macro can be used whenever the author desires the number -of the heading to appear in the document. The number of the -various levels of headings appear, separated by periods. -For example, typing {\tt Section \bs levelno} might result -in: Section 1.2.7.1 if this was the first fourth-level heading -of the seventh third-level section of the second$\ldots$ $etc.$ -Levels lower than the last modified level do not appear in -{\tt\bs levelno}. - -\def\delim{.} -\cmd{\indx{setlevelno}\[\int\delim\int$\ldots$\int\]} -This macro can be used for presetting the one through -four heading numbers. If you use -this command before a {\tt\+level} command, then the -counter will increment to the next number when the -{\tt\+level} command is encountered. Therefore, you -should preset to one number below the desired level. - You cannot preset the level 2 counter without - specifying the level 1, or the level 3 without level 1 and 2 - and so on. (For example, you cannot specify {\tt\+setlevelno\[1.~.~.4\]}, - you must specify {\tt \[1.\int .\int .4\]}.) - -\cmd{\indx{contents}} -This macro forces a page eject and produces a \indx{table of contents} -on the following pages as dictated by the previous heading macros. -No vertical \indx{glue} is inserted, so you may want to use a {\tt \bs vfil} -command immediately before {\tt \bs contents}. - -\need.5in\bigskip\relax{{\tentt \+topofcontents}}\[\ver\]\lbreak - \relax{{\tentt \+botofcontents}}\[\ver\]\lbreak -These macros specify a list to be placed above and below the table of -contents. The \ver\ may include logos, rules, $etc.$ The table of contents -is quite rigid, so a {\tt\bs vfill} is appropriate in at least one \ver. -Defaults in HP \TeX\ will format the table of contents as they appear in the -beginning of this manual (with the exception of the headings). -\start{note}\need1in -\centerline{-- NOTE --} -{\tt\+topofcontents} and {\tt\+botofcontents} must -{\bo both} be specified {\bo before} the -{\tt\+contents} command is used. (That is, you cannot -specify {\tt\+botofcontents} after {\tt\+contents}, -even though this seems logical.) -\finish{note} -\level2{Multiple Columns} - -The following macros control the number of columns on the page. -Multiple column and single column text can be mixed on a page by -using the following commands. - -\cmd{\indx{columnspace}=\dim} -This command specifies the amount of space between columns on a page. -This dimension should be assigned before entering multicolumn mode and -should remain unchanged for the duration thereof. The default -column space in HP \TeX\ is 0.5 inch. - -\need.5in\bigskip\relax{{\tentt \+start\[twocolumns\]}}\lbreak - \relax{{\tentt \+start\[threecolumns\]}}\lbreak - \relax{{\tentt \+finish\[twocolumns\]}}\lbreak - \relax{{\tentt \+finish\[threecolumns\]}}\lbreak -These four commands cause the text to be formatted into multiple columns. -If a {\tt\bs balance}, - {\tt\bs newpage}, {\tt\bs evenpage} or {\tt\bs oddpage} macro is -encountered while in multicolumn mode, the columns are balanced -on the page prior to the page eject. Exit from multicolumn mode -causes the columns to be balanced as well. Unbalanced columns may -be obtained by using {\tt\bs vfill} {\tt\bs eject} while in multicolumn mode. -Balancing forces the top lines of each column to be lined up. The -bottom lines are lined up as well unless {\tt\bs raggedbottom} has been -specified. Discardable items (such as glue, penalties, $etc.$) -immediately following these commands will be ignored. (To prevent -this, you may use {\tt\+null} immediately -after {\tt\+finish\[$n$columns\]}.) - -\cmd{\indx{balance}} -This command causes the columns to become balanced. Discardable -items (such as \indx{glue}, penalties, $etc.$) immediately following these -commands will be ignored. (To prevent -this, you may use {\tt\+null} immediately -after {\tt\+finish\[$n$columns\]}.) - - -\start{note} -\centerline{-- NOTE --} -When using multiple columns, you may find it helpful to use the -plain \TeX\ commands {\tt\+tolerance} and -{\tt\+hbadness} (to increase the stretch and -shrinkability of interword \indx{glue} and decrease complaints -regarding ``underfull hboxes''). See {\tenit The -\TeX book} for more information. -\finish{note} - -\level2{Tables} -The following macros are useful for setting \indx{tables}. These -macros are different from the plain \TeX\ {\tt\bs halign} and -{\tt\bs valign} commands in that -they format one row at a time. The table can be justified as a whole -either left, right or centered. As long as the number of columns -in each entry remains constant, the entire table appears justified. -(Interesting figures, such as pyramids, hopscotch boards, $etc.$ can -be produced by changing the format and the number of -columns in each entry.) -Each column of the table has its own user specified width. -Between each column -is a vertical line (which can be easily made invisible). -This vertical rule takes no space from any column so the rule -width may be varied without altering the column dimensions. -An entry may also be designed to span two or three columns. -Horizontal bars are -treated exactly the same as data entries. The macro \indx{{\tentt\bs tbar}} -can be used to produce such a bar. - -\cmd{\indx{tableline}=\dim} -This parameter specifies the dimension of bars and rules in -all subsequent entries. This parameter should remain unchanged -throughout the entire table. Default value is 0.01332 inch.\super{7} -\start{note} -\centerline{-- NOTE --} -There may be some occasion when printing a table that you -get the error message,\lbreak -~~~~``{\tt Printer error: \lbreak -~~~~**Could not process all the data, data lost.}''\lbreak -The printer uses a variety of different length line segments to -``build'' a line. If the {\tt tableline} specification you have -chosen requires too many individual segments to make up the exact -specification, it may cause this error. -There are a few remedies available, as follows: - ----If you are using the default magnification (1.0), then -try using the default {\tt tableline} dimension (just leave out -the {\tt\+tableline} command. - ----If you are using a file magnification value other than 1.0, then alter -your {\tt\+tableline} specification so that its value, when converted -to dots (multiply length in inches $\times\ 300$), is a power of 2 ($i.e.$ 1, 2, -8, 16, 32 or a multiple of any of these except 1). -\finish{note} - -\cmd{\indx{tablespace}=\dim} -This parameter specifies the minimum amount of space to be placed -between the vertical rules and data entries in the table. Default in -HP \TeX\ is 5 points. - -\cmd{\indx{tableformat}\[\tspec|\colspec\dim|$\ldots$|\colspec\dim\]} -This command specifies the table format. Note that a \indx{vertical bar} -(\indx{{\tentt |}}) is required as a separator -between specifications, but not at the beginning or end of the -list (different than {\tt \+tablerow} or {\tt \+tablebar}). - -\tspec\ can be any of {\tt\bs leftline}, {\tt\bs rightline}, - or {\tt\bs centerline}. \colspec\ can be any of -{\tt\bs leftline}, {\tt\bs rightline}, {\tt\bs centerline} or -{\tt\bs paragraph}. Other options are -allowed if you make them yourself; for example, if you type: -\par\vskip3pt -\centerline{\tt\bs def\bs mything\#1\[\bs line\[\bs hskip 1in \#1\bs hss\]\]} -\par\vskip3pt -\noindent then {\tt\bs mything} would be a valid \tspec\ option that -would print the table 1 inch from the left margin. -The \colspec\ is always a single token ({\tt\bs leftline}, {\tt\bs rightline}, -{\tt\bs centerline} or {\tt\bs paragraph}), and is -followed by a dimension. The token specifies the standard -justification of the column ({\tt\bs paragraph} must be used if the -column is to contain paragraphs), and the dimension specifies the -absolute width of the column. Again, if you are not satisfied with the -selection you can make your own---the rules are that the macro consume -one token (containing the text) and produce a box of width {\tt\bs hsize}. -%\need2in -\start{note} -\centerline{-- NOTE --} -If the {\tt\bs paragraph} column specification is used, {\tt \+parskip} -must be 0 points (this is the default). Otherwise, the paragraph entry -will be raised or lowered by the current {\tt \+parskip} amount and the -table will be out of alignment. If you are using {\tt\+noindentstyle} -and have not reset {\tt\+parskip}, then inserting an {\tt\+indentstyle} -command just prior to the table will return to the proper (0 points) parskip. -\finish{note} - -\need.5in\bigskip -\relax{{\tentt \+tablerow}}\[{\tt |}\col{\tt |}\col$\ldots${\tt |} - \col{\tt |}\]\lbreak -\relax{{\tentt \+tablebar}}\[{\tt |}\col{\tt |}\col$\ldots${\tt |} - \col{\tt |}\]\lbreak -These commands are used to build tables. {\tt\bs tablerow} should -be used if the \col\ contains text, while {\tt\bs tablebar} should -be used for bars or other non-text entries. Horizontal bars are -obtained by using either {\tt\bs vrule height} \dim , {\tt width} \dim\ - or {\tt\bs tbar} -as a \col\ ({\tt\bs tbar} uses {\tt\bs tableline} as the rule height). -The following syntax holds true for both macros:\dotteditems - -\itm A \indx{vertical bar} (\indx{{\tentt |}}) or a \indx{tilde} (\~{}) must be -beginning and end of each column, including the first and last entry -(differs from {\tt \+tableformat} syntax). -\itm The \indx{vertical bar}s ({\tt |}) may be replaced by tildes (\~{}) -if a visible vertical bar in that position is not desired. - -\itm If the first thing in a \col\ happens to be the control sequence -\indx{{\tentt \bs span}}\[\int\]{\tt \bs tbar}, then the number -of columns specified -as \int\ are spanned by the entry (in this case a horizontal bar). The -natural justification for the spanned entry will be that of the -leftmost column spanned. (Note that {\tt span}\[\int\] is -{\bo not} followed by a blank space as this can cause difficulties.) -%\need1.25in -\start{note} -\centerline{-- NOTE --} -While building tables, if a {\tt\+tablebar} or {\tt\+tablerow} -runs more than one line of text (on the CRT), it is good practice -to use the percent -sign (\indx{{\tentt \%}}) at the end of each line. This will tell \TeX\ to -ignore anything else on that line and prevent -possible problems with extra spaces being -misinterpreted by \TeX . -\finish{note} -\level2{Fonts} -Only a few fonts are preloaded in HP \TeX. These macros allow you -to access a variety of font families, styles, and sizes. - -\cmd{\indx{fontdef}\bs\lb{\sa command}\rb=\[\lb{\sa library}\rb,% - \lb{\sa font name}\rb\]} -This command equates a command of your choice with a -font (as used in the library). You can use \lb{\sa library}\rb -(optional) to -specify other than the default font library. -This command differs from \TeX's {\tt\+font} command in that the -font won't actually be loaded until -the first request (if any). - -\need.5in\bigskip\relax{{\tentt \+fivepoint}}\lbreak - \relax{{\tentt \+sixpoint}}\lbreak - \relax{{\tentt \+sevenpoint}}\lbreak - \relax{{\tentt \+eightpoint}}\lbreak - \relax{{\tentt \+ninepoint}}\lbreak - \relax{{\tentt \+tenpoint}}\lbreak - \relax{{\tentt \+tenpoint}}\lbreak - \relax{{\tentt \+fourteenpoint}}\lbreak - \relax{{\tentt \+eighteenpoint}}\lbreak - \relax{{\tentt \+twentyfourpoint}}\lbreak -These commands select the font point size from five to twentyfour. (In -{\bo Math Mode}, these commands only apply to the default -font within a font family. If you are using a current family -other than {\tt\+fam0}, you must make the appropriate -font assignments -(see Appendix A, ``Changing Fonts in HP \TeX ''). - -%\mcmd{{cm}}\lbreak - %tr\lbreak - %gv} -%These commands select Computer Modern, times roman -%and geneva font families respectively. -\need.5in\bigskip\relax{{\tentt \+rm}}\lbreak - \relax{{\tentt \+it}}\lbreak - \relax{{\tentt \+bf}}\lbreak - \relax{{\tentt \+sl}}\lbreak - \relax{{\tentt \+sa}}\lbreak - \relax{{\tentt \+tt}}\lbreak -These commands select \indx{roman} style, \indx{italic}, \indx{bold face}, -\indx{slanted}, -\indx{sans serif}, and \indx{typewriter} style. - -If the selected font is undefined, the font style is changed -to roman. If that new font is still undefined, the size is -changed to ten points. Computer Modern ten point -roman will always be defined in HP \TeX. - -\level2{Miscellaneous Macros} - -%\cmd{\indx{indx\[\hor\]} -%This command sets the \hor. The \hor\ along with the current page -%number are then written to the file {\job.inx} for use as an index. -% -\cmd{\indx{note}\[\hor\]} -This macro puts a footnote at the bottom of the current page -and inserts a superscript footnote number at the location -of the command and the footnote. -Footnote numbers are allocated starting with~1 and can be -reset by the use of {\tt\bs resetnotes}. The \hor\ is the footnote -text. - - -\cmd{\indx{need}\dim} -The result of this macro is that if the page breaking algorithm -of \TeX\ determines that the current position would optimally -fall within \dim\ of the bottom of the page, the page is broken -leaving some empty space at the bottom. -\need1in -\start{note} -\centerline{-- NOTE --} -Since the {\tt \bs need} command uses a negative penalty -to {\bo encourage} (not {\bo force}) \TeX\ to break -the page, it will -not always have the effect you might anticipate. This is especially -true if the command is encountered near -the top of the current page and the remaining text will not -adequately fill the current page. -\finish{note} -\cmd{\indx{super}\[\hor\]} -The argument is printed as a superscript. - -\cmd{\indx{sub}\[\hor\]} -The argument is printed as a subscript. - -\cmd{\indx{lbreak}} -This macro forces a line break within a paragraph. It inserts ``hfil'' -\indx{glue} before the break, so the line will {\bo not} be right -justified. If you want right justification, use plain \TeX 's -{\tt \bs break} command. - -\cmd{\indx{uline}\[\hor\]} -This macro causes the argument to be underlined. - -\cmd{\indx{mon}} -This command prints the current month name. For -example, if the current month were August, {\tt\bs mon} would -print the letters ``August'' in the current font. - -\cmd{\indx{date}} -This command prints the current date in the format Month Date, Year. -For example, if today's date were 12 December 1984, {\tt\bs date} -would print the characters ``December 12, 1984'' in the current font. - -\cmd{\indx{hour}} -This command prints the current time of day (for example -- 4:07 PM) - -\level2{Block Structure} -Certain local document styles are considered to belong to a ``block.'' -(\indx{Block structure}, as used here, simply refers to a portion of a -file that has some common formatting instructions applied -to it.)\note{\tenpoint The concept of {\tenbo \indx{grouping}}, explained -in this manual and in {\it The \TeX book}, is basically the -same as the ``\indx{block structure}'' referred to here.} - -The current block is defined to be the most recently opened -block. Pending blocks are blocks that have been opened but -not closed. The HP \TeX\ macros {\tt\+start} and {\tt\+finish} -are used to open and close blocks. - -Valid \blk s pre-loaded in HP \TeX\ include {\tt indent, note, - warning, ver\-ba\-tim, twocol\-umns} and {\tt threecolumns}, - all of which have been described in this chapter. - User defined blocks may be implemented by defining a control - sequence, {\tt\bs BEGIN\blk} and, optionally, another - control sequence, {\tt\bs END\blk}. - -\cmd{\indx{start}\[\blk\]} -This command determines if a control sequence {\tt\+BEGIN\blk} has -been defined. If one exists, a new block is opened and the control -sequence is invoked. Otherwise, an \indx{error message} is issued and the -command is ignored. - -\cmd{\indx{finish}\[\blk\]} -This command is used to close the current block and invoke the -control sequence {\tt\+END\blk} if one has been defined. If \blk\ matches -the current block name, the current block is closed. If not, an -appropriate error message is issued and corresponding corrective -action is taken. If \blk\ is not valid or there are no pending -blocks, the command is ignored. If \blk\ is valid but does not -match the current block -name, {\tt\bs done} commands are inserted until either \blk\ matches -the current block name or until all pending blocks are closed. - -\cmd{\indx{done}} -This command closes the current block without -any error checking and invokes the control sequence {\tt\+END\blk} if -one has been defined. A \TeX\ error message will be issued if -there are no pending blocks. - -Following is an sample usage of the {\tt\+BEGIN} and {\tt\+END} -commands in creating user-defined blocks: - -\def\BEGINexample{\bigskip\centerline{- EXAMPLE -} - \medskip\leftskip.75in\rightskip.75in} -\def\ENDexample{\medskip} -\start{example} -This example was created by defining the following block:\medskip -\centerline{\tt \+def\+BEGINexample\[\+bigskip\+centerline\[- EXAMPLE -\]} -\centerline{\tt ~~~~~~\+medskip\+leftskip.75in\+rightskip.75in\]~~~~~~} -\medskip -The block was opened using the command: {\tt\+start\[example\]}. The -optional control sequence {\tt\+END\blk} was also used, as follows:\medskip -\centerline{\tt \+def\+ENDexample\[\+medskip\]}\medskip -The {\tt\+medskip} vertical glue will be inserted after the block is -closed using the command: {\tt\+finish\[example\]}. -\finish{example} - - -\level1{\indx{HP 2688A} Control Macros} - -These macros are for controlling certain features of the 2688A Laser -Printer: - -\level2{Page Copy Control} - -\cmd{\indx{copies}\int} -This macro assigns the number of copies per page starting with the current -page. The copies are uncollated; in other words, if {\tt\bs copies5} -occurred on page 3, the output will have five copies of page 3, -then five copies of page 4, $etc.$ The control of the number of copies -is accomplished through one of \TeX's counters. Default is counter -number~1. Possible integers and their effect are shown below: -\itm 1 to 32,767 will produce the specified number of copies. -\itm Greater than 32,767 will produce 32,767 copies. -\itm 0 will produce 1 copy. -\itm Less than 0 (negative number) no copies (can be used -to suppress certain sections of a document, $etc.$) -\enditems -The counter -can be changed using the following macro. - -\cmd{\indx{selectcopycounter}\lb {\sa integer from 0 to 9}\rb} -This is used for changing which counter is used for controlling -the number of \indx{copies} per page (default is 1). This command generally -should not be used except by people who are writing their own -macros. - -\need.5in\bigskip\relax{{\tentt \+copieson}}\lbreak - \relax{{\tentt \+copiesoff}}\lbreak -If the multiple copies feature is being used in a document, these -macros can be used to alternate between one copy per page and the -number of copies assigned by the {\tt\bs copies} macro. The difference between -{\tt\bs copiesoff} and {\tt\bs copies1}~is that when the former is followed -with {\tt\bs copieson}, the original number of copies is restored, whereas -when the latter is followed with {\tt\bs copieson}, there is, -of course, no effect. - -\level2{Logical Page Control} - -The Print Server features a concept called ``\indx{logical paging}'' -which is controlled using the following set of macros. A -logical page is a rectangular addressing space on the sheet of paper -(referred to as the ``\indx{physical page}''). Logical pages have an -orientation (\indx{portrait}, \indx{landscape}, \indx{reverse portrait} -or \indx{reverse lanscape}) and a position on the physical page. -Through the operator -interface of PS2688A, you may define a list of logical pages that -may be written to on any sheet of paper. -These logical page specifications may also be stored in a PS2688A -input file to avoid typing in the specifications for each job. -Using these macros, you -can address the logical pages with either of two methods: -either by explicitly specifying a logical page for each page of -\TeX\ output, or by specifying an ordered list of logical pages -and letting the system cycle through the list. - -\cmd{\indx{lpdef}\[\lb\sa logical page definition\rb\]} -This command defines a logical page size and orientation. The -\lb{\sa logical page definition}\rb -consists of the logical page -number, followed by the {\bo left}, -then the {\bo top} dimensions (distance from the - edges of the physical page), and the -\indx{logical page orientation} (portrait, landscape, rev--portrait or -rev--landscape). Orientation may be abbreviated {\tt P,L,RP,}and -{\tt RL,} respectively, and either upper or lower case -characters will work. The edges of the page that -would normally be the top and left as viewed from that -logical page's orientation are -always considered top and left in this context. - An example usage follows:\medskip -\centerline{\tt \bs lpdef \[1, 1.5in, 3in, L\]}\medskip -This would cause logical page number 1~to be printed -in {\bo landscape} orientation, with the left edge of the -print (as viewed from landscape orientation) beginning 1.5~inches -from the edge of the physical page. The ``top'' (left-hand -edge along the paper path) will begin 3~inches from the -edge. - -The default values for logical pages in HP \TeX\ are: LEFT=1in, -TOP=1in. - - - - -\start{note} -\centerline{-- NOTE --} -The dimension specified as distance from the top edge does not -take into account the space needed for headings. If running headings -are to be used, the logical page definition should allow extra -room for them when specifying ``top'' dimension. (Footings -are also printed ``in the margin,'' so when specifying -{\tt vsize} be sure to leave room for them.) -\finish{note} - -\cmd{\indx{lplist}\[\lb\sa logical page list\rb\]} -This command specifies the logical page list to be used whenever -logical pages are being used implicitly. Only one such -specification is allowed within a document, if more than one exist, -all but the last are ignored. This command initializes -implied logical paging. - - The \lb {\sa logical page list}\rb ~is a list -of integer numbers from 1~to 32~which have been defined -using the {\tt \bs lpdef} command. Positive number entries will -cause a physical page eject prior to initiating the logical -page entry. Negative numbers require no such physical -page eject. Each entry number should be separated from -the next by a comma. - -%\need3in -\medskip The remaining commands control explicit logical paging. If any of -these commands occur within a page, a page eject is issued and the -next page to be printed will be dependant upon the particular -command. If any of these commands occur on the top of a page, the -prescribed action will be delayed until the next page break -(be it natural or forced by a {\tt\bs newpage}, {\tt\bs eject}, $etc.$). -For example, suppose the first page of every chapter in a -document uses logical page 5, then {\tt\bs ppageto5} {\tt\bs lpresume} -would eject the current page (assuming it is not empty), issue -a physical page eject and begin printing on page 5. Later, -when the page is full, \TeX\ breaks the page and resumes printing -according to the logical page list. - -\cmd{\indx{lpageto}\lb {\sa integer between 1 and 32}\rb} -This command causes the next page to be printed on the specified -logical page. No physical page eject is implied. - -\cmd{\indx{ppageto}\lb {\sa integer between 1 and 32}\rb } -This command is similar to {\tt\bs lpageto} but implies a physical -page eject prior to printing on the specified logical page. - -\cmd{\indx{lpresume}} -This command is used after a {\tt\+ppageto} or {\tt\+lpageto} -command to resume -printing on the current page of the logical page list. - -\cmd{\indx{lpreset}} -This command resets the logical page list and prints on the first -page in the list. - -\cmd{\indx{lpexit}} -This command exits the current loop in the logical page list and -prints on the next page in the list. - -\cmd{\indx{selectlpcounter}\int} -This is used for changing which counter is used for specifying the -logical page (default is 2). This macro generally should not be used -except by people who are writing their own macros. -\vfill\eject - -% THIS BEGINS THE SAMPLE PAGE*** - -\def\oddheading{\vbox{\hbox to \hsize{\eightrm A Sample Document - \hfil Page \folio} - \nointerlineskip\vskip2pt - \hbox{\vrule width \hsize height .4pt}}} -\centerfooting{\eightbf THIS DOCUMENT WAS CREATED USING \HPTEX} -\firstlevelhead{\leftline{\fourteenbf\levelno\enspace% - \title}% - \medskip\ctswrite{\hskip15pt\tenrm\title}} -\numbereditems -\level1{Formatting a \indx{Sample Document}} -In this section we will format a simple document -utilizing many of the HP \TeX\ macros. -For this example, we will accept all the HP \TeX\ default values for the -various commands. -\vskip.5in -\centerline{\twelvebf A Sample Document} - -Isn't that nice? If we wanted to, we could have easily set that off to the -right like this:\lbreak -\rightline{\twelvebf A Sample Document} - -Now, how about \textbox{a textbox?} Those are -always fun. Or, if we really want to set something off, we could -ask \TeX\ to: -\centerbox{put it inside\cr - a nice little\cr - centered box,} -or, maybe just \boxit{``boxit'' -- like this.} - -But say you're really serious about getting someone's attention. - -\start{warning} -\centerline{\bf LOOK!} -\centerline{You can use the ``Warning'' command, like we did here.} -\finish{warning} - -Now, let's use the extraordinary capabilities of \TeX\ to -generate a mathematical formula: -$$\hat{n}_2(s)={1\over \alpha_2}\biggl[ \biggl({\partial C_2\over - \partial x} \biggr)_{x=0}+{k_1 \hat{n}_1\over D_1} \biggr]$$ -Next, we'll create a table to show the dimensional units available in \TeX : -\medskip -\tableformat{\centerline|\centerline 1in|\leftline 1.2in|\centerline 1in|% - \centerline .05in|\centerline 1in|\leftline 1.2in|\centerline 1in} -\tablebar{|\span7\tbar|} -\tablerow{|\TeX\ UNIT|DESCRIPTION|PER INCH||\TeX\ UNIT|DESCRIPTION|PER INCH|} -\tablebar{|\span7\tbar|} -\tablerow{|{\tt in}|inch|1||{\tt mm}|millimeter|25.4|} -\tablerow{|{\tt cm}|centimeter|2.54||{\tt dd}|Didot point|67.54|} -\tablerow{|{\tt pt}|printer's point|72.27||{\tt bp}|big point|72|} -\tablerow{|{\tt pc}|pica|6.02|| | | |} -\tablebar{|\span7\tbar|} -\medskip -Itemized lists are very useful: -\itm For listing things. -\itm For making a series of points. -\sitm You can even use subitems. -\enditems -Now, look at the next page to see exactly how this sample -document was formatted. -\vfil\eject - - -\nofooting -\centerline{\bf Here's the source file for ``\indx{Sample Document}''} -\medskip -\start{verbatim}{\tentt\inset=.6in\start{indent} -\+noindentstyle -\+centerfooting\[\+eightbf THIS DOCUMENT WAS CREATED USING \+HPTEX\] -\+null\+bigskip -\+centerline\[\+twelvebf A Sample Document\] - -Isn't that nice? If we wanted to, we could have easily set that off to the -rightlike this:\+lbreak -\+rightline\[\+twelvebf A Sample Document\] - -Now, how about \+textbox\[a textbox?\] Those are always -fun. Or, if we really want to set something off, we could ask \+TeX\+ to: -\+centerbox\[put it inside\+cr - a nice little\+cr - centered box,\] -or, maybe just \+boxit\[``boxit'' -- like this.\] - -But say you're really serious about getting someone's attention. - -\+start\[warning\] -\+centerline\[\+bf LOOK!\] -\+centerline\[You can use the ``Warning'' command, like we did here.\] -\+finish\[warning\] - -Now, let's use the extraordinary capabilities of \+TeX\+ to -generate a mathematical formula: -$$\+hat\[n\]_2(s)=\[1\+over \+alpha_2\] \+biggl[ \+biggl(\[\+partial C_2\+over - \+partial x\] \+biggr)_\[x=0\] +\[k_1 \+hat\[n\]_1\+over D_1\] \+biggr]$$ -Next, we'll create a table to show the dimensional units available in \+TeX : -\+medskip -\+tableformat\[\+centerline|\+centerline 1in|\+leftline 1.2in|% - \+centerline 1in|\+centerline .05in|% - \+centerline 1in|\+leftline 1.2in|\+centerline 1in\] -\+tablebar\[|\+span7\+tbar|\] -\+tablerow\[|\+TeX\+ UNIT|DESCRIPTION|PER INCH||\+TeX\+ UNIT|DESCRIPTION|PER INC -\+tablebar\[|\+span7\+tbar|\] -\+tablerow\[|\[\+tentt in\]|inch|1||\[\+tentt mm\]|millimeter|25.4|\] -\+tablerow\[|\[\+tentt cm\]|centimeter|2.54||\[\+tentt dd\]|Didot point|67.54|\] -\+tablerow\[|\[\+tentt pt\]|printer's point|72.27||\[\+tenttbp\]|big point|72|\] -\+tablerow\[|\[\+tentt pc\]|pica|6.02|| | | |\] -\+tablebar\[|\+span7\+tbar|\] -\+medskip -Itemized lists are very useful: -\+itm For listing things. -\+itm For making a series of points. -\+sitm You can even use subitems. -\+enditems -Now, look at the next page to see exactly how this sample document was -formatted. -\+vfil\+eject -\finish{indent} -} -\finish{verbatim} - -\bye - |