home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / print / handb137.zip / HBK136.HBK < prev    next >
Text File  |  1992-07-01  |  54KB  |  1,670 lines
  1. .bl 15
  2. .mn 1
  3. .wi 0
  4.                    HANDBOOK
  5.  
  6.                  Version 1.36
  7.                 February, 1992
  8.  
  9.                The Nit Orchard
  10.               2225 Desert Drive
  11.              Las Cruces, NM 88001
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                   USER GUIDE
  18. .pa
  19.               TABLE OF CONTENTS
  20. .h1 BRIEF DESCRIPTION
  21.  
  22. HANDBOOK is designed to produce a 3" by
  23. 5-1/2" Handbook from a specially formatted
  24. ASCII text file. The Handbook is printed on
  25. both sides of 8-1/2" by 11" paper, eight
  26. pages to a sheet, laid out for staple
  27. binding.
  28.  
  29. A second Layout, Mini-Manual, prints 5-1/2"
  30. by 8-1/2" double-sided pages suitable for
  31. loose leaf binding in a medium-sized
  32. notebook, or in Landscape mode ready for
  33. staple binding.
  34.  
  35. A third Layout, Letter, prints full size
  36. pages on 8.5" x 11" letter size paper,
  37. suitable for binding in a standard loose-leaf
  38. notebook.
  39.  
  40. HANDBOOK is intended to run on IBM PC
  41. compatible computers using MS/PC-DOS 2.11 and
  42. higher.
  43.  
  44. No display graphics capability is required,
  45. however HANDBOOK can take advantage of EGA
  46. and VGA extended text modes, if available.
  47.  
  48. .h1 OPERATION
  49.  
  50. .h2 Starting HANDBOOK
  51.  
  52. To start HANDBOOK, enter HANDBOOK <Enter>.
  53. There are no required command-line arguments.
  54.  
  55. HANDBOOK has only two menus, MAIN and
  56. CONFIGURE.
  57.  
  58. Your choices at the main menu are to (P)rint
  59. All, Print (S)ome, (V)iew, (E)dit,
  60. (C)onfigure, get (H)elp, or e(X)it to DOS.
  61.  
  62. .h2 Configuration
  63.  
  64. The first time you run HANDBOOK, you must
  65. review the default configuration. You may
  66. change any parameter, get (H)elp, (S)ave the
  67. configuration to disk, or e(X)it to the Main
  68. Menu. The first time you run HANDBOOK, the
  69. configuration is saved automatically upon
  70. exit.
  71.  
  72. Optional /m and /c command line arguments
  73. allow your disabling automatic color or
  74. monochrome operation. /m forces monochrome
  75. mode, and /c forces color mode. It is
  76. possible that these parameters may be useful
  77. for LCD displays or to provide grey scale on
  78. monochrome monitors.
  79.  
  80. The configuration parameters are (D)ata
  81. drive, (W)ork drive, (P)rinter and Print
  82. Mode, (C)opies, (F)orms, (L)ayout, (T)ext
  83. File, (E)ditor Name, Video (M)ode, and Video
  84. (A)ttributes.
  85.  
  86. "Data drive" refers to the drive that
  87. contains your Handbook text file. Any valid
  88. drive can be selected. (Handbook tries to
  89. prevent you from selecting a non-existent
  90. file, so the current (T)ext file name may
  91. change when a new data drive is selected.)
  92.  
  93. "Work drive" refers to the drive used to
  94. build a temporary work file during the
  95. Handbook Print and View routines. Again, any
  96. valid drive can be selected. Approximately
  97. 1.3 - 3.8 Kilobytes of temporary work file
  98. space is required for each Handbook page.
  99.  
  100. "Printer" provides a menu of printers
  101. supported by HANDBOOK. Select a printer by
  102. menu number. Landscape mode is automatically
  103. used when appropriate for H-P LaserJet
  104. printers. If you are using an H-P LaserJet
  105. IId/IIId, you can use Duplex mode, as well.
  106. When you select a dot-matrix printer and
  107. Mini-Manual layout, you can choose Landscape
  108. mode, which will print the text sideways on
  109. the sheet, four pages per sheet, ready for
  110. staple binding.
  111.  
  112. "Copies" allows you to print up to nine
  113. copies of a Handbook without having to
  114. intervene until all copies of side one are
  115. printed and it's time to turn over the paper
  116. and print side two.
  117.  
  118. "Forms" lets you choose continuous forms or
  119. cut sheets (manually loaded) for your
  120. Handbook. Continuous forms is by far easier,
  121. but if you must use manually loaded cut
  122. sheets, you should be able to. (Select
  123. "Continuous Forms" when using a Laserjet
  124. printer and most cut sheet feeders.)
  125.  
  126. "Layout" refers to whether you will print a
  127. pocket-sized Handbook, a sheaf of
  128. medium-sized loose leaf Mini-Manual pages, or
  129. Letter size pages.
  130.  
  131. "Text File" is your Handbook text data file.
  132. The current data drive is scanned for files
  133. ending with ".HBK", one of which can be
  134. selected by menu number. Select "New File" to
  135. create a new Handbook data file. (Handbook
  136. tries to prevent the selection of a
  137. non-existent file, so the current file name
  138. may change when a new data drive is
  139. selected.)
  140.  
  141. "Editor Name" is the complete path and
  142. filename of the editor YOU want to use to
  143. edit a Handbook file. The default editor is
  144. simply "edlin", the standard line editor
  145. provided with MSDOS since day one. HANDBOOK
  146. can be configured to use any editor,
  147. including VDE, which will fit into the memory
  148. available while HANDBOOK is loaded. The
  149. available memory will vary from PC to PC. The
  150. memory constraint may preclude the use of
  151. larger Word Processors, such as WordStar,
  152. WordPerfect and similar fare. 
  153.  
  154. HANDBOOK has been tested with edlin, DOS 5.0
  155. Edit, QEdit 2.1 and 2.15, vi (from MKS
  156. Toolkit), and VDE (Video Display Editor)
  157. 1.62, all of which are acceptable.
  158.  
  159. HANDBOOK now includes an excellent ShareWare
  160. Editor, VDE (Video Display Editor), which
  161. must be registered with Eric Meyer if used.
  162. Please read Mr. Meyer's documentation on disk
  163. for operating and registration details.
  164.  
  165. "Video Mode" refers to the number of 80
  166. character lines displayed on the monitor. 
  167.  
  168.     25x80 is available to all video hardware,
  169.     monochrome or color, and is the standard
  170.     mode most PCs run at startup.
  171.  
  172.     43x80 is available with EGA and VGA
  173.     hardware, and has the advantage of
  174.     allowing the (V)iew feature to present a
  175.     Handbook as facing pages.
  176.  
  177.     50x80 is only available with VGA hardware,
  178.     and offers the additional capability of
  179.     viewing an entire Mini Manual page on one
  180.     screen rather than in top and bottom
  181.     halves.
  182.  
  183.     60x80 is also only available using VGA
  184.     hardware, and allows you to view a Letter
  185.     Layout page on a single screen. This is a
  186.     graphics mode and is considerably slower
  187.     to display than the other modes. Since
  188.     only one background color can be used at
  189.     one time, you may need to adjust your
  190.     display colors before using this mode. The
  191.     default colors have been changed to
  192.     accommodate this situation.
  193.  
  194. HANDBOOK should prevent you from selecting
  195. extended video modes which your hardware does
  196. not support. In any case, you MUST restrict
  197. your selection to modes which are actually
  198. usable on the video hardware you are using,
  199. in order that HANDBOOK will not try to
  200. display characters beyond the limits of the
  201. visible screen.
  202.  
  203. "Video Attributes" refers to the colors and
  204. bold and blink attributes assigned to various
  205. parts of the HANDBOOK display. Use the arrow
  206. keys to move the brackets or highlight to the
  207. attribute you want to change, then use
  208. function keys F1 to F8 to select foreground
  209. and background colors, and F9 and F10 to
  210. toggle foreground bold and blink attributes. 
  211.  
  212. When using monochrome video adapters,
  213. selecting colors and attributes will have no
  214. effect. 
  215.  
  216. If a color adapter is used with a monochrome
  217. display, you may be able to adjust grey scale
  218. attributes using this routine. 
  219.  
  220. In 60x80 mode, the background color is
  221. restricted to a single color for the entire
  222. screen. In this mode, the background color
  223. for normal text is used for all background
  224. attributes, regardless of the other
  225. selections.
  226.  
  227. Running HANDBOOK is not very difficult, and
  228. the best way to learn how is simply to get
  229. started.
  230.  
  231. .h2 Entering Handbook Text
  232.  
  233. Select (E)dit from the Main Menu to edit the
  234. current Handbook data file. 
  235.  
  236. If you want to begin a new Handbook data file
  237. you must first select (C)onfigure from the
  238. Main Menu, then select (T)ext file from the
  239. Configure Menu. Next, select "New File" from
  240. the list of data files and enter a valid file
  241. name when prompted. It is not necessary to
  242. enter the file extension, ".HBK". The new
  243. data file will be created on the data drive
  244. and assigned as the current Handbook data
  245. file.
  246.  
  247. Prior to version 1.20, both Handbook Layout
  248. and Mini-Manual Layout used 36 lines and
  249. columns per page. Mini-Manual Layout has been
  250. expanded to 46 lines and columns to make
  251. better use of the larger page. (Thanks to
  252. Richard Scott for this suggestion...)
  253.  
  254. Letter Layout was added in version 1.36, and
  255. uses the entire 8.5" x 11" letter size sheet
  256. for each page. Letter Layout uses 66 columns
  257. per line and 56 lines per page, including
  258. headers and the page number.
  259.  
  260. Use the ASCII, or NON-document mode of a word
  261. processor when entering your Handbook text.
  262. HANDBOOK has been tested using several
  263. editors, including WordStar, PC Write, VDE,
  264. QEdit, and MSDOS 5.0 Edit, all of which are
  265. equally sufficient. 
  266.  
  267. Current versions of several popular word
  268. processors may require more memory to run
  269. than is available within the HANDBOOK
  270. environment. If this is the case with your
  271. editor of choice, you can still use it by
  272. exiting HANDBOOK and running the editor from
  273. the DOS prompt.
  274.  
  275. If you force HANDBOOK to process a word
  276. processor format file such as those normally
  277. produced by WordStar or WordPerfect, and
  278. especially if picture graphics are used, the
  279. resulting Handbook will most likely be
  280. unusable. You should expect similar results
  281. with most other special word processor file
  282. formats. Stay with ASCII, DOS Text,
  283. NON-document, or a similar mode.
  284.  
  285. HANDBOOK can print many of the graphics
  286. CHARACTERS such as those used to draw menu
  287. boxes on the monitor screen, if the printer
  288. supports the IBM PC extended character set
  289. without translation. Most late model dot
  290. matrix printers can print some of these
  291. characters, especially if the printer can
  292. emulate the IBM ProPrinter. All supported
  293. printers can print these characters in
  294. Landscape Mode.
  295.  
  296. However, graphics characters below ASCII 32
  297. (20 hex), the space character, must be
  298. removed by HANDBOOK's filter routine. Even
  299. though these characters can display properly
  300. as graphics characters, they are interpreted
  301. as control characters by the vast majority of
  302. printers and not only do not print what you
  303. might expect but often send the printer into
  304. unusual operating modes at inopportune times.
  305.  
  306. You can enter extremely long lines, and
  307. HANDBOOK will wrap the words to the next
  308. lines, but you'll probably get more
  309. predictable results if you enter your text
  310. just as you want it to appear.
  311.  
  312. A Handbook need not take advantage of any
  313. advanced features in order to be useful,
  314. especially if it is quite short, for example
  315. a two or three page list of phone numbers.
  316.  
  317. However, if your Handbook text file is larger
  318. than ten kilobytes in size, adding headers,
  319. subheaders, and an accompanying alphabetical
  320. index may be desirable.
  321.  
  322. .h2 Formatting Handbook Text
  323.  
  324. All special formatting features are
  325. controlled with "dot" commands, similar to
  326. those used with WordStar. HANDBOOK uses dot
  327. commands to control headers, indexing, page
  328. breaks, blank lines, and several additional
  329. features. All dot commands begin with a
  330. period (.) in column one, have two specific
  331. characters, either upper or lower case, in
  332. columns two and three, and may accept a
  333. parameter starting after column three.
  334.  
  335. The valid dot commands are: 
  336.  
  337.  .bl        Leave a line blank
  338.  
  339.  .bl #      Leave a block of # lines blank.
  340.             Start a new page if less than #
  341.             lines left on the current page.
  342.  
  343.  .h1 [text] Start a new page, using [text] as
  344.             the header at the top. If room,
  345.             print [text] double width and
  346.             centered. Create a major index
  347.             entry of [text]. Leave one line
  348.             blank under [text].
  349.  
  350.  .h2 [text] Start a new page only if less
  351.             than 6 lines left on current
  352.             page. Otherwise leave one line
  353.             blank, print [text] centered, and
  354.             leave another line blank. Create
  355.             a minor index entry with [text].
  356.  
  357.  .ca        Insert a six-month calendar
  358.             starting on a new page, using the
  359.             system date to determine the
  360.             first month. Create a major index
  361.             entry for the calendar.
  362.  
  363.  .ca mm-dd-yyyy Insert a six-month calendar
  364.                 starting on a new page, using
  365.                 mm-dd-yyyy to determine the
  366.                 first month.
  367.  
  368.  .ca prompt Prompt for valid calendar
  369.             starting date.
  370.  
  371.  .cm #      Reduces the number of months
  372.             printed per page by the .ca
  373.             (Calendar) command. Valid numbers
  374.             are 3 or 4 for Mini- Manual
  375.             Layout, and 3, 4, or 5 for
  376.             Letter.
  377.  
  378.  .cp #      Set the number of Calendar pages
  379.             to print. The default is two. In
  380.             Handbook Layout, three months per
  381.             page are printed; in Mini-Manual,
  382.             the default is four; and in
  383.             Letter, the default is five.
  384.  
  385.             Note that it is possible, though
  386.             unlikely, for the page number to
  387.             not print if the calendar is
  388.             extremely long. If the calendar
  389.             on one page is long enough to
  390.             extend to the next page, through
  391.             some quirk of Gregorian Calendar
  392.             Physics, you must select a
  393.             different starting month or use
  394.             the .cm command to set the number
  395.             of months per page to a lower
  396.             number.
  397.  
  398.  .dt        Insert current system date. Handy
  399.             for documenting a Handbook
  400.             printing date.
  401.  
  402.  .dw        If room, print header (.h1) text
  403.             using double width characters.
  404.  
  405.  .ix [text] Create a major index entry with
  406.             [text].
  407.  
  408.  .mn #      Set Minimum Number of "NOTES"
  409.             pages added after the index.
  410.             Valid numbers are 0 to 20.
  411.  
  412.  .ni        Suppress the INDEX completely.
  413.             Headers will be printed normally,
  414.             however, no index is generated.
  415.  
  416.  .no        Insert "NOTES" page.
  417.  
  418.  .ns        Do NOT sort index. (Handy for
  419.             Roman Numerals)
  420.  
  421.  .pa        Start a new page
  422.  
  423.  .pa #      Start a new page if less than #
  424.             lines left on the current page.
  425.  
  426.  .pn #      Sets the initial page number for
  427.             the Handbook. This must be at the
  428.             start of the Handbook text file
  429.             being processed. It will have no
  430.             effect if encountered after
  431.             processing the first page.
  432.  
  433.  .qu        Suppresses the "advertisement" on
  434.             the final "NOTES" page.
  435.  
  436.  .sw        Print header (.h1) text using
  437.             single width characters.
  438.  
  439.  .ta #      Set Horizontal Tab interval to 2,
  440.             4, or 8 column intervals. A
  441.             parameter other than 2, 4, or 8
  442.             leaves the interval unchanged.
  443.  
  444.  .wi #      Set Word Wrap Indentation to #.
  445.             The default is 2, and the valid
  446.             range is from zero to one third
  447.             of the page width. An invalid
  448.             parameter has no effect.
  449.  
  450.  .. [text]  Comment, not processed. Also,
  451.             illegal dot commands are treated
  452.             as comments and the entire line
  453.             will be ignored.
  454.  
  455. .h2 Index
  456.  
  457. The index is sorted by .h1 entries, keeping
  458. the .h2 entries in a group under the.h1 entry
  459. immediately preceding them.
  460.  
  461. The idea with this type of index is to use
  462. broad descriptive names or titles as .h1
  463. text, while using more pertinent labels as
  464. the .h2 text.
  465.  
  466. This will produce an index in which it is
  467. relatively easy to locate a topic, under
  468. which several specific items are indexed. 
  469.  
  470. Index entries created using .ix are sorted as
  471. a major index entry with no group of minor
  472. entries.
  473.  
  474. Use of the .ns (no sort) command anywhere in
  475. the Handbook file disables the sorting of the
  476. index for that file.
  477.  
  478. The index can be completely disabled by
  479. including .ni at the start of the Handbook
  480. file.
  481.  
  482. .h2 Notes Pages
  483.  
  484. HANDBOOK appends from zero to as many as
  485. twenty three "NOTES" pages after the index
  486. has been processed. The default minimum
  487. number of "NOTES" pages is three, which can
  488. be changed to any value from zero to twenty
  489. using the minimum notes (.mn) command.
  490. Additional "NOTES" pages may be appended in
  491. Handbook Layout or Mini-Manual Landscape mode
  492. to ensure that a bindable number of pages is
  493. printed.
  494.  
  495. .h2 Suggestion...
  496.  
  497. Try printing the sample Handbook text using
  498. HANDBOOK and again with the command, "COPY
  499. SAMPLE.HBK PRN", to compare the dot commands
  500. with their results. Extremely long lines were
  501. used in that file to allow it to fill to the
  502. margins in either Handbook, Mini-Manual, or
  503. Letter Layout.
  504.  
  505. .h2 Viewing the Handbook
  506.  
  507. (V)iew provides an opportunity to preview
  508. what will actually print on each page BEFORE
  509. printing. View uses text video modes, and
  510. does not require graphics capability, however
  511. HANDBOOK can take advantage of EGA and VGA
  512. extended text modes if they are available.
  513.  
  514. In viewing a Handbook using a standard 25
  515. line video mode, each page is presented on a
  516. single screen, the top half on the left, the
  517. bottom to the right. In EGA 43 line, or in
  518. VGA 50 or 60 line modes, the Handbook pages
  519. are shown as facing pages.
  520.  
  521. In standard 25 line and EGA 43 line modes,
  522. Mini Manual pages are split between two
  523. screens, each showing half the printed page.
  524. When VGA 50 line mode is used, the entire
  525. page is shown on one screen.
  526.  
  527. Letter Layout pages are split between two or
  528. three screens unless VGA 60 line mode is
  529. used.
  530.  
  531. Press PageDn to view the Next page, or PageUp
  532. to view the Previous one. 
  533.  
  534. View the First or Last page by pressing
  535. "Home" or "End", respectively. 
  536.  
  537. To view a particular page, enter the page
  538. number and press Enter.
  539.  
  540. When viewing a Mini Manual in 25 row or 43
  541. row modes, either the (T)op or (B)ottom half
  542. of the page can be displayed. When a new page
  543. is selected, the top half of the page is
  544. displayed first. View the bottom half by
  545. pressing "B".
  546.  
  547. Letter Layout can be viewed one full page per
  548. screen only when using VGA 60x80 mode. In
  549. 25x80 mode, select (T)op, (C)enter, or
  550. (B)ottom to view the entire page in thirds.
  551. In 43x80 and 50x80 modes, (T)op and (B)ottom
  552. are used to display the page in halves.
  553.  
  554. Press "S" to (S)earch for text, selecting any
  555. combination of (G)lobal, (I)gnore case, and
  556. (B)ackward search parameters to make the
  557. search more versatile. 
  558.  
  559. With no parameters, the search begins on the
  560. NEXT page, proceeds to the END of the
  561. Handbook, and IS cAsE SensItiVe.
  562.  
  563. (B)ackward causes the search to begin on the
  564. PREVIOUS page and proceed toward the First
  565. page. 
  566.  
  567. (G)lobal causes the search to start with the
  568. First or Last page depending on whether the
  569. (B)ackward parameter is also specified. 
  570.  
  571. (I)gnore case means that Upper and Lower case
  572. letters are treated alike. 
  573.  
  574. Abort a search by pressing the Escape key.
  575.  
  576. The search text and parameters entered are
  577. remembered, unless the search is aborted
  578. using Escape. This allows successive similar
  579. searches without having to do a lot of
  580. retyping. 
  581.  
  582. To change the search text or a parameter,
  583. delete the character to the left of the
  584. cursor using Backspace, or Erase the entire
  585. field with Control E (This means hold down
  586. the "Control" key and press E, then release
  587. both keys). Control D performs the same
  588. function.
  589.  
  590. After the search is complete, a status line
  591. will display the results of the search. If
  592. the search is successful, the page on which
  593. the text was found is displayed, with the
  594. "found" text highlighted (Color) or in upper
  595. case (Monochrome). 
  596.  
  597. While browsing through the Handbook, if
  598. search text happens to be found on the
  599. displayed page, it will display highlighted
  600. or in upper case.
  601.  
  602. Press "Esc" to return to the Main Menu.
  603.  
  604. .h2 Printing the Handbook
  605.  
  606. Select (P)rint All from the Main Menu to
  607. print the entire Handbook, Mini Manual, or
  608. Letter Layout book.
  609.  
  610. To print a page or range of pages, or to
  611. print only the front or back half, select
  612. Print (S)ome from the Main Menu, then (T)ag
  613. the pages you want to print. This can be
  614. handy to reprint a few pages without having
  615. to reprint the entire document. Please note
  616. that if the Handbook text file is edited and
  617. then only a few pages are reprinted, then you
  618. must be certain that the changes you made
  619. have not affected additional untagged pages.
  620.  
  621. HANDBOOK is designed to simplify the tagging
  622. process by automatically tagging (or
  623. untagging) all the pages on a sheet when any
  624. page on that sheet is selected. The exception
  625. (there is ALWAYS an exception) is when the
  626. (F)ront or (B)ack sides are tagged; in those
  627. cases, all existing tags are reset.
  628.  
  629. I have found the (F)ront and (B)ack tagging
  630. to be valuable when printing to a network
  631. printer. In my particular case, the network
  632. spooler does not release the print job until
  633. the entire job is complete, and by tagging
  634. the front side, the spooler prints the front
  635. side as soon as Handbook returns to the Main
  636. Menu. After I have inserted the paper to
  637. print side two (the back side), the back side
  638. is tagged and printed, the spooler again
  639. releasing the print job as Handbook returns
  640. to the main menu.
  641.  
  642. If you are tagging pages in a Very Large Text
  643. File, the page number display may be divided
  644. over several screens. You can view other
  645. screens by using PageUp and PageDn, but you
  646. can still tag pages without having their
  647. numbers displayed on the current screen.
  648.  
  649. HANDBOOK is designed to print on both sides
  650. of 8 1/2 x 11 inch paper, positioning the
  651. printed pages so that they can be trimmed
  652. from the sheet and bound using staples in the
  653. case of a Handbook or Landscape mode Mini-
  654. Manual, or punched for a loose leaf or spiral
  655. binder for a Portrait mode Mini Manual or for
  656. Letter Layout.
  657.  
  658. The paper normally must be fed through the
  659. printer twice in order to print on both
  660. sides. The notable exception is those H-P
  661. LaserJet printers which support Duplex
  662. printing, such as the IId and IIId models.
  663.  
  664. Handbook pages and Landscape mode Mini-Manual
  665. pages are printed from the outside of the
  666. Handbook to the center, and Portrait mode
  667. Mini Manual and Letter Layout pages are
  668. printed from the start of the Mini Manual to
  669. the end. 
  670.  
  671. When printing side two, the "back" side of
  672. the paper, be sure to feed the paper in the
  673. same direction as when side one, the "front"
  674. side, was printed, so that the pages are in
  675. the correct order for binding. Also, be sure
  676. that the paper is turned over so the printing
  677. is now done on the "back" side. Positioning
  678. the paper can be a bit confusing. I should
  679. know this program well enough to be able to
  680. load paper correctly in my sleep, but I still
  681. goof it up occasionally.
  682.  
  683. If you are using a LaserJet printer in Normal
  684. (Simplex) mode or a cut sheet feeder, the
  685. page order will have to be reversed before
  686. reloading the pages in the cassette to print
  687. side two.
  688.  
  689. For a LaserJet, the pages should be loaded
  690. for side two with the blank side up and the
  691. top of the page toward the rear of the
  692. printer, the first page to be printed on the
  693. top of the stacked sheets. 
  694.  
  695. For a cut sheet feeder, the first page to be
  696. printed must be on the top of the stack, the
  697. blank side on the back, and the top of the
  698. printed page at the bottom of the bin so that
  699. the top edge of the printed page feeds
  700. through the printer first. 
  701.  
  702. Remove any "curl" the pages acquired during
  703. the first pass through the printer to reduce
  704. paper feed problems. Usually, pulling them
  705. gently across the edge of a desk or rolling
  706. them up into a tube in the other direction
  707. with your hands is enough if you can do the
  708. trick without making them curl the other way.
  709.  
  710. Plus (+) signs are printed alongside the
  711. Handbook text to help determine where to cut,
  712. fold (spindle, mutilate), and staple the
  713. pages. When printing a Portrait mode Mini
  714. Manual, a combination of minus (-), plus (+),
  715. and vertical bar (|) signs are used to
  716. outline the pages.
  717.  
  718. It may be necessary to adjust the horizontal
  719. position of the paper slightly in order that
  720. the printing on the front and back sides
  721. align correctly. With most printers, a
  722. position can be found where the paper does
  723. not need to be adjusted horizontally between
  724. printing the front and back sides. On the
  725. C.Itoh and Epson printers used to test
  726. HANDBOOK, that position causes the leftmost
  727. plus signs to print 1/4 to 5/16 of an inch
  728. from the edge of the paper.
  729.  
  730. The vertical position of the paper is
  731. critical for a Handbook, less important for a
  732. Mini Manual or for Letter Layout. For a
  733. Handbook, the top and bottom margins of the
  734. sheet should be equal. If you are using a
  735. C.Itoh ProWriter or Draft printer, a set of
  736. plus signs will print exactly over the
  737. perforations between sheets when the vertical
  738. alignment is correct.
  739.  
  740. Three short Handbook files, "hbkalign.hbk"
  741. (one sheet), "minialgn.hbk" (two sheets), and
  742. "letralgn.hbk" (two sheets) have been
  743. included to help locate the proper starting
  744. points for Handbook, Mini Manual, and Letter
  745. Layout printing, respectively.
  746.  
  747. For cutting out the pages, the best tool I
  748. have tried is a paper cutter, the sharper the
  749. better.
  750.  
  751. For a Handbook, the paper should be cut
  752. exactly in half horizontally, to that each
  753. Handbook page is 5 1/2" high. If the paper
  754. was positioned perfectly during printing, the
  755. cut should go exactly through the horizontal
  756. row of plus signs between sheet halves. 
  757.  
  758. The side margins should be trimmed to be
  759. equal. Since it is simplest to make as few
  760. cuts as possible, I recommend that the left
  761. margin NOT be trimmed to the plus signs.
  762. Rather, extend the right margin a matching
  763. distance past the right plus signs.
  764.  
  765. Next, stack the pages in order, starting with
  766. page 1 face down on the left (you will then
  767. be looking at page two and the second from
  768. last page), separating pages still connected
  769. by a perforation.
  770.  
  771. A cover the same size as the Handbook can be
  772. cut from heavier, perhaps colored, paper to
  773. protect the printed pages.
  774.  
  775. Insert two or three staples from the outside
  776. of the Handbook or Portrait mode Mini-Manual
  777. to bind it together. Be careful to center the
  778. staples between the facing pages.
  779.  
  780. The final steps are to fold the Handbook or
  781. Portrait mode Mini-Manual and, if necessary,
  782. to trim the page edges a final time to make
  783. them line up properly.
  784.  
  785. .h1 DETAILS
  786.  
  787. An MS-DOS service is used to determine how
  788. many legal drives exist in the system. This
  789. determines how many drives will be presented
  790. as legal drives during configuration. Prior
  791. to MS-DOS version 3, this service always
  792. returned the proper number of drives.
  793. However, beginning with MS-DOS version 3,
  794. this service returns a value of five or the
  795. value corresponding to the drive code
  796. contained in the LASTDRIVE entry, if any, in
  797. CONFIG.SYS. This means that if no LASTDRIVE
  798. entry is used, HANDBOOK may erroneously
  799. report that drives A: through E: exist, when
  800. in fact there may be fewer or more. In any
  801. event you should restrict your selection of a
  802. drive to drives which actually exist, even
  803. though more may be listed in the drive menu.
  804.  
  805. When you select "Draft Printer" and
  806. "Handbook" Layout, you must, before you start
  807. printing, set your printer for Pica
  808. Compressed Pitch (17 characters per inch) and
  809. Eight Lines Per Inch (1/8" linefeed). If you
  810. cannot do this on your printer, then you
  811. cannot properly print "Handbook" Layout. When
  812. "Draft Printer" is selected, only text (NO
  813. printer control codes) is sent to the
  814. printer, forcing you to set the printer
  815. manually before you start. Try it...
  816.  
  817. HANDBOOK 1.36 includes HBKSET.EXE, which
  818. allows the knowledgeable and patient user to
  819. modify the graphic mode fonts for the
  820. dot-matrix printers and the control codes for
  821. all the printers. If you need to use a
  822. printer which is incompatible with any of the
  823. supported printers, you may be able to modify
  824. the printer parameter file to provide
  825. "aftermarket" support. My suggestion is to
  826. modify the "Draft Printer" parameter set,
  827. since it is least likely to be missed. It is
  828. essential that the entire parameter set,
  829. including Printer Name and index characters,
  830. not exceed 128 characters, or it will be
  831. truncated. Please make a safe copy of the
  832. original HANDBOOK.PRT file before starting
  833. ANY modifications, since it is quite easy to
  834. bring HANDBOOK to its knees if the parameter
  835. file is incorrectly implemented, and somewhat
  836. more difficult to recover from scratch. If
  837. you successfully implement any additional
  838. printers, please take a moment to send me a
  839. copy of your modified HANDBOOK.PRT file.
  840. Perhaps it can be added to a future version
  841. of HANDBOOK.
  842.  
  843. A bug which prevents HANDBOOK from running on
  844. a Leading Edge Model D computer and on a true
  845. blue IBM PC has come to my attention. The
  846. effect is that HANDBOOK apparently loads but
  847. displays nothing, locking up the PC. Cold
  848. boot time. On the Leading Edge, even a "do
  849. nothing" QuickBASIC program locks up, however
  850. the IBM will run some QuickBASIC programs.
  851. I'm investigating this...
  852.  
  853. When HANDBOOK encounters, during the (P)rint
  854. or (V)iew routines, an invalid date or the
  855. word "Prompt" as a parameter to a .ca (insert
  856. calendar) dot command, you will be prompted
  857. to enter a valid date, press X <Enter> for no
  858. calendar, or <Enter> alone for a calendar
  859. based upon the current system date. If you
  860. elect to enter a new date, you MUST (!) enter
  861. the date in the format MM-DD-YYYY, INCLUDING
  862. LEADING ZEROS. To change the date for
  863. subsequent printing, you can use (R)eset from
  864. the Main Menu to force HANDBOOK to reprocess
  865. the Handbook text file.
  866.  
  867. If you use an editor which employs word wrap,
  868. set the right margin to 35 (not 36) for a
  869. Handbook, 45 (not 46) for a Mini Manual, or
  870. 55 (not 56) for Letter Layout. Many editors
  871. leave the space character between words on
  872. the end of each wrapped line, and HANDBOOK
  873. will wrap any characters beyond column 36 (or
  874. 46 or 56) to the next line. This can result
  875. in blank lines occasionally being inserted by
  876. HANDBOOK for no apparent reason. HANDBOOK
  877. could be designed to ignore trailing spaces,
  878. but I have mixed feelings about programs that
  879. think they're smarter than the typist. I am
  880. open for suggestions on this one...
  881.  
  882. Having invested many hours in fighting to use
  883. a non-compatible computer in what often
  884. appears to be a PC-compatible world, I had,
  885. in versions prior to 1.25, reduced HANDBOOK's
  886. dependence on full compatibility by
  887. restricting all screen and keyboard I/O to
  888. MS/PC-DOS and ROM-Bios services. This did, at
  889. least, allow a Microsoft QuickBASIC 4.5
  890. application to be developed on my absolutely
  891. non-compatible NCR Decision Mate V PC.
  892.  
  893. The price paid for this concession to non
  894. compatibility was a noticeable slowing of the
  895. display and a considerably larger executable
  896. program file containing the additional I/O
  897. functions. With the addition of the (V)iew
  898. feature in version 1.22, the slow display
  899. became more noticeable, and the (V)iew
  900. routines pushed the program size toward large
  901. and unwieldy. 
  902.  
  903. Both problems were addressed in part by
  904. returning to internal BASIC I/O at the
  905. expense of being able to run HANDBOOK on
  906. almost compatible PCs; BIOS compatibility is
  907. no longer sufficient.
  908.  
  909. I became a bit frustrated during the
  910. development of HANDBOOK version 1.29.
  911. HANDBOOK also had finally gotten to the size
  912. where it would no longer compile within the
  913. QuickBASIC environment, and in fact would
  914. compile externally only if additional options
  915. were employed, even so having only a hundred
  916. bytes or so free. For the moment, this
  917. irritation has been addressed by moving the
  918. Help Text and Configure routines to external
  919. files, a solution I had hoped to avoid. I
  920. prefer that HANDBOOK not become a disk hungry
  921. system of modules and overlays in the style
  922. of so many other programs of recent release. 
  923.  
  924. Later, while Duplex mode print routines were
  925. being added, HANDBOOK again ran into the
  926. wall, and the print routines were moved to an
  927. external module, also. Adding Letter Layout
  928. almost got it there again, but not quite.
  929.  
  930. The idea of rewriting HANDBOOK in C or C++ is
  931. therefore still being kicked around. This may
  932. allow a more efficient use of memory, faster
  933. operation, and provide a smaller executable
  934. file.
  935.  
  936. .h1 SHAREWARE
  937.  
  938. HANDBOOK is NOT in the public domain and it
  939. is NOT free.
  940.  
  941. HANDBOOK is the Copyrighted Property of The
  942. Nit Orchard, and all rights are reserved
  943. exclusively to The Nit Orchard.
  944.  
  945. If you are in the business of acquiring
  946. software and then attempting to restrict
  947. further distribution of that software, then
  948. you are cautioned that HANDBOOK is NOT
  949. available for such acquisition and/or
  950. restriction.
  951.  
  952. HANDBOOK is being released under the
  953. "ShareWare" concept.
  954.  
  955. ShareWare is unique in that you have a
  956. reasonable time in which to "test drive" a
  957. program before paying for it. If you decide
  958. to use the program on a regular basis, you
  959. are expected to pay a "Licensing Fee" or
  960. "Registration Fee" to the author. The
  961. licensing fee is usually less than $50 and is
  962. almost never over $100.
  963.  
  964. This compares very favorably with purchasing
  965. a program in your favorite store for a large
  966. sum of hard-earned plastic credit, with no
  967. recourse if the program turns out to be
  968. unsuited for your application. In that event,
  969. you are out the purchase price, perhaps
  970. several hundreds of dollars.
  971.  
  972. With ShareWare, you are out NOTHING with the
  973. possible exception of a few bucks' shipping
  974. if you paid somebody to send you a copy.
  975.  
  976. It has been my experience that few people
  977. actually pay ShareWare licensing fees, the
  978. rationale being that nobody needs to pay for
  979. something they already have. I think that the
  980. tendency to fail to pay for ShareWare may
  981. herald the ultimate undoing of ShareWare
  982. distribution. If ya don't use it, ya lose
  983. it...
  984.  
  985. ShareWare has the potential to provide
  986. quality programs at very low cost compared to
  987. the prices charged by many large software
  988. publishers.
  989.  
  990. This seems a good idea. It can do no less
  991. than force large software publishers to
  992. reduce their prices to reasonably competitive
  993. levels. We can look at advertisements in
  994. nearly any computer magazine and see that
  995. there are some very nice software packages
  996. available, at very attractive prices.
  997.  
  998. Only a few years ago, this was not the case.
  999. I paid well over $100 for a GW-BASIC
  1000. interpreter, and another $150 for a GW-BASIC
  1001. compiler, both of which were riddled with
  1002. bugs. I also paid over $300 for P-System, but
  1003. I digress...
  1004.  
  1005. Compare that situation with a package like
  1006. Borland's Turbo-Whatever or Microsoft's
  1007. QuickBASIC, to mention only some, most of
  1008. which are available from many sources for
  1009. under $100, and which are far superior
  1010. programming environments in comparison to
  1011. GW-BASIC.
  1012.  
  1013. Certainly ShareWare is not the only factor
  1014. affecting software prices over the last few
  1015. years, yet it IS a factor, and software would
  1016. not be available so reasonably today had not
  1017. there been steady pressure to reduce prices
  1018. in competition with ShareWare.
  1019.  
  1020. The reason for this lengthy prose is to
  1021. encourage you to PAY for ShareWare, not only
  1022. this program, but all programs that you use.
  1023. If few users pay for ShareWare, an author has
  1024. far less incentive to continue to develop
  1025. enhancements and improvements to existing
  1026. software, or to begin the development of new
  1027. software.
  1028.  
  1029. So, by paying for ShareWare, you send the
  1030. author a clear message: "This is a worthwhile
  1031. program. Keep working on those upgrades." 
  1032.  
  1033. I think the ShareWare concept is an important
  1034. one to support, and the asking price of
  1035. HANDBOOK is beyond a shadow of a doubt
  1036. reasonable. If you find HANDBOOK useful
  1037. enough to use regularly, then you should pay
  1038. for it.
  1039.  
  1040. If you wish to use HANDBOOK without paying
  1041. for it, then you certainly can do so, though
  1042. with my express disapproval. You will have
  1043. only yourself to answer to.
  1044.  
  1045. In the case of HANDBOOK, which can be
  1046. registered for as little as FIVE DOLLARS,
  1047. THERE IS ABSOLUTELY NO EXCUSE TO NOT PAY FOR
  1048. IT if you use it regularly. Certainly, FIVE
  1049. DOLLARS is not too much to pay for any useful
  1050. program.
  1051.  
  1052. .h1 LICENSING AND MARKETING
  1053.  
  1054. If you use HANDBOOK, or a document you
  1055. produce using HANDBOOK, on a regular basis,
  1056. then you are responsible for voluntarily
  1057. paying a licensing fee described in detail
  1058. below, to: 
  1059.  
  1060. The Nit Orchard
  1061. 2225 Desert Drive
  1062. Las Cruces, NM 88001
  1063.  
  1064. There are four ways to license HANDBOOK:
  1065.  
  1066. You can use the enclosed INVOICE.TXT file to
  1067. print a registration form.
  1068.  
  1069. Send your Name and Address, and...
  1070.  
  1071. 1. Send a FIVE dollar licensing fee. Your
  1072. name will be added to a list of registered
  1073. users, and The Nit Orchard will respond to
  1074. correspondence or questions on HANDBOOK. Your
  1075. conscience will be clear...
  1076.  
  1077. 2. Send a FIFTEEN dollar licensing fee. The
  1078. Nit Orchard will, in addition to the above,
  1079. mail you printed documentation and the latest
  1080. version of HANDBOOK on 5- 1/4" or 3-1/2"
  1081. diskette. We will also notify you in writing
  1082. of the next two major revisions of HANDBOOK,
  1083. which you may request for a ten dollar
  1084. handling fee.
  1085.  
  1086. 3. Send a THIRTY dollar licensing fee. The
  1087. Nit Orchard will mail the latest version of
  1088. HANDBOOK, as above, and will also mail the
  1089. next two major revisions of HANDBOOK without
  1090. waiting for your request, and free of any
  1091. additional handling fee.
  1092.  
  1093. 4. Site licenses are available. Please write
  1094. to The Nit Orchard for details.
  1095.  
  1096. HANDBOOK is available by mail directly from
  1097. The Nit Orchard using either the FIFTEEN or
  1098. THIRTY dollar licensing options above.
  1099.  
  1100. Please address your request to:
  1101.  
  1102. The Nit Orchard
  1103. 2225 Desert Drive
  1104. Las Cruces, NM 88001
  1105.  
  1106. PRICES ARE SUBJECT TO CHANGE WITHOUT NOTICE.
  1107.  
  1108. HANDBOOK may be available for downloading
  1109. from Bulletin Board Systems. Look for a file
  1110. called HNDBKnnn.EXE, HNDBKnnn.ZIP,
  1111. HNDBKnnn.ZOO, etc, where nnn is the version
  1112. number.
  1113.  
  1114. Some Shareware Suppliers have included
  1115. HANDBOOK in their offerings. You should be
  1116. aware that The Nit Orchard receives no part
  1117. of the fee you may pay these suppliers, and
  1118. that you should still license HANDBOOK with
  1119. The Nit Orchard if you use it accordingly.
  1120.  
  1121. .h1 PACKAGING
  1122.  
  1123. HANDBOOK consists of the following files:
  1124.  
  1125. HANDBOOK.EXE    The HANDBOOK Program
  1126.  
  1127. HBKCFG  .EXE    The Configuration Program
  1128.  
  1129. HBKPRT  .EXE    The Print Program
  1130.  
  1131. HANDBOOK.PRT    The Printer Command Parameter
  1132.                 file.
  1133.  
  1134. ITOH .FNT, EPMX .FNT, IBM .FNT
  1135.                 Fonts for the dot-matrix
  1136.                 printers in Landscape Mode.
  1137.  
  1138. HANDBOOK.HLP    Help Text displayed by
  1139.                 HANDBOOK
  1140.  
  1141. HANDBOOK.TXT    This documentation To Print:
  1142.                 COPY HANDBOOK.TXT PRN
  1143.  
  1144. SAMPLE .HBK     A sample Handbook text file
  1145.                 demonstrating most features
  1146.  
  1147. HBKALIGN.HBK    A short (one sheet) Handbook
  1148.                 text file to help align paper
  1149.                 for Handbook Layout.
  1150.  
  1151. LETRALGN.HBK    A two sheet Handbook text
  1152.                 file to assist in alignment
  1153.                 of paper for Letter Layout.
  1154.  
  1155. MINIALGN.HBK    A two sheet Handbook text
  1156.                 file to assist in alignment
  1157.                 of paper for Mini Manual
  1158.                 Layout.
  1159.  
  1160. CHARTEST.HBK    Contains the IBM extended
  1161.                 character set. Can be used to
  1162.                 determine if your printer can
  1163.                 use those characters. These
  1164.                 characters are built into the
  1165.                 Landscape font files.
  1166.  
  1167. HBKSET  .EXE    A barebones utility which was
  1168.                 written primarily to expedite
  1169.                 the creation of the font
  1170.                 files and HANDBOOK.PRT. Used
  1171.                 carefully, it can allow the
  1172.                 support of printers which do
  1173.                 not conform to the standards
  1174.                 already supported by
  1175.                 HANDBOOK.
  1176.  
  1177. INVOICE .TXT    A HANDY REGISTRATION FORM FOR
  1178.                 HANDBOOK.
  1179.  
  1180. HANDBOOK is also distributed electronically
  1181. as a self-extracting library, HNDBKnnn.EXE,
  1182. where nnn is the version number. When
  1183. HNDBKnnn.EXE is run, it creates the files
  1184. named above.
  1185.  
  1186. The reason for distributing HANDBOOK
  1187. electronically in this manner is that it is
  1188. much simpler to back up one file and keep
  1189. track of it than three.
  1190.  
  1191. Another consideration is that during the
  1192. library process, the member files are
  1193. compressed significantly, so less disk space
  1194. is required to back up a library than the
  1195. individual files.
  1196.  
  1197. Bulletin Board System operators generally
  1198. keep files in compressed library format to
  1199. conserve disk space and to reduce expensive
  1200. transmission time, as well.
  1201.  
  1202. If you want to upload this program to a
  1203. Bulletin Board System, you should upload only
  1204. the library, to make life easier for the
  1205. SysOp.
  1206.  
  1207. .h1 FINE PRINT
  1208.  
  1209. NCR and Decision Mate V are registered
  1210. trademarks of NCR Corporation, and/or AT&T.
  1211.  
  1212. IBM is a registered trademark of IBM
  1213. Corporation.
  1214.  
  1215. QuickBASIC, GW-BASIC, and Microsoft are
  1216. registered trademarks of Microsoft.
  1217.  
  1218. WordStar is a registered trademark of
  1219. WordStar Corporation and/or MicroPro
  1220. International.
  1221.  
  1222. WordPerfect is a registered trademark of
  1223. WordPerfect Corporation.
  1224.  
  1225. Borland and Turbo-BASIC (and Turbo Everything
  1226. Else) are registered trademarks of Borland
  1227. International.
  1228.  
  1229. LaserJet and Hewlett Packard are registered
  1230. trademarks of Hewlett Packard.
  1231.  
  1232. Qedit is a registered trademark of SemWare.
  1233.  
  1234. PC Write is a registered trademark of
  1235. QuickSoft.
  1236.  
  1237. VDE (Video Display Editor) is the copyrighted
  1238. property of Eric Meyer.
  1239.  
  1240. All other trademarks are owned by their
  1241. respective companies.
  1242.  
  1243. The Nit Orchard makes no representations or
  1244. warranties with respect to HANDBOOK and the
  1245. contents hereof and specifically disclaims
  1246. any implied warranties of merchantability or
  1247. fitness for any particular purpose. Further,
  1248. The Nit Orchard reserves the right to revise
  1249. this publication and to make changes from
  1250. time to time in the content hereof without
  1251. obligation to notify any person or
  1252. organization of such revisions or changes.
  1253.  
  1254. The HANDBOOK software and documentation is
  1255. provided AS IS and without warranty as to
  1256. performance. While The Nit Orchard firmly
  1257. believes this to be a high quality product,
  1258. and has run extensive tests to ascertain just
  1259. that, the USER MUST ASSUME ALL RISKS OF USING
  1260. THIS PROGRAM.
  1261.  
  1262. .h1 SUPPORT
  1263.  
  1264. <whew...>
  1265.  
  1266. Having said all that legal stuff, I should
  1267. let you know where I stand with reference to
  1268. HANDBOOK.
  1269.  
  1270. It is my intention to continue to upgrade
  1271. HANDBOOK to correct bugs and to be responsive
  1272. to users who may have questions, criticisms,
  1273. compliments, or whatever. I do, however,
  1274. maintain a record of LICENSED USERS, and will
  1275. handle correspondence with LICENSED USERS
  1276. before any other.
  1277.  
  1278. When a program such as HANDBOOK is released,
  1279. the author has to make a decision as to
  1280. whether further support is intended. If not,
  1281. then the program should be released to the
  1282. public domain so that others can modify and
  1283. improve the program as suits their needs or
  1284. fancy. If the author intends to retain rights
  1285. to and control of the program, then further
  1286. support is an automatic moral, though not
  1287. legal, obligation.
  1288.  
  1289. HANDBOOK, including all source code,
  1290. executable program code, and documentation is
  1291. the copyrighted property of The Nit Orchard.
  1292. All rights to and control of HANDBOOK are
  1293. reserved by The Nit Orchard, and that
  1294. morally, though not legally, obligates The
  1295. Nit Orchard to a minimum of support.
  1296.  
  1297. I admit to having mixed feelings about
  1298. supporting HANDBOOK. While I want it to be
  1299. bug-free and for users to be able to run it
  1300. with confidence, I don't want to be married
  1301. to it. My wife objects. So, supporting
  1302. HANDBOOK is hereby limited to part-time
  1303. status.
  1304.  
  1305. HANDBOOK is a pretty good program, a reliable
  1306. and predictable performer, and will probably
  1307. require very little support in any case.
  1308. (Famous last words...)
  1309.  
  1310. When you license your copy, please take time
  1311. to include a note letting me know what you
  1312. think of HANDBOOK, with a mention of problems
  1313. encountered and any suggestions for
  1314. improvement.
  1315.  
  1316. If, on the other hand, you think HANDBOOK
  1317. stinks and you have no intention of using it,
  1318. then of course you won't license it, either.
  1319. I would still like to hear from you to find
  1320. out why HANDBOOK was so inappropriate for
  1321. your use, in order that I can attempt to
  1322. improve this and other programs and make them
  1323. better products in the future.
  1324.  
  1325. Thanks for giving HANDBOOK a try.
  1326.  
  1327. .h1 PROGRAM HISTORY
  1328.  
  1329. 1.00    Initial Release
  1330.  
  1331. 1.01    Fixed problem in Epson pitch control
  1332.         string
  1333.  
  1334.         Removed delay routine
  1335.  
  1336. 1.02    Replaced ANSI.SYS screen controls
  1337.         with ROM-Bios video services.
  1338.  
  1339.         Speeded up displays.
  1340.  
  1341.         Added option to change default data
  1342.         file name.
  1343.  
  1344.         Added option to restore default
  1345.         configuration.
  1346.  
  1347.         Added character filter to remove
  1348.         unwanted control characters from
  1349.         processed text.
  1350.  
  1351.         Added Key Buffer Flush routine to
  1352.         reduce the effects of key (or finger)
  1353.         bounce.
  1354.  
  1355. 1.03    Added error trap to prevent printer
  1356.         failures from crashing HANDBOOK.
  1357.  
  1358. 1.04    Improved operator interface in
  1359.         selecting drives and files.
  1360.  
  1361. 1.05    Changed default data file name to
  1362.         "SAMPLE.HBK".
  1363.  
  1364. 1.06    Added error trap for recovery from
  1365.         disk errors.
  1366.  
  1367.         Removed "Beep" routine by popular
  1368.         demand...
  1369.  
  1370. 1.07    Added Calendar feature
  1371.  
  1372. 1.08    Changed Calendar routine to allow
  1373.         recovery when an invalid date is
  1374.         entered.
  1375.  
  1376. 1.09    Added extended error trap
  1377.  
  1378. 1.10    Enabled Handbook format with draft
  1379.         printer
  1380.  
  1381. 1.11    Minor change to work file progress
  1382.         messages
  1383.  
  1384. 1.12    Changed file deletion routine
  1385.  
  1386. 1.13    Added .no (Insert NOTES page) command
  1387.  
  1388. 1.14*   Changed "Save" to "Save and exit"
  1389.  
  1390.         Minor change to progress messages
  1391.  
  1392. 1.15    Fixed bug that caused early exit from
  1393.         Configure Menu
  1394.  
  1395. 1.16    Added abort if nothing in .HBK file
  1396.  
  1397. 1.17    Cosmetic change to source code only
  1398.  
  1399. 1.18    Added Hewlett-Packard Laserjet Series
  1400.         II support
  1401.  
  1402. 1.19    Fixed bug introduced in v1.18
  1403.         calendar
  1404.  
  1405. 1.20    Changed Mini-Manual Layout to 46
  1406.         lines by 46 columns
  1407.  
  1408. 1.21*   Added word wrap for long headers
  1409.  
  1410.         Added .dt (insert current system
  1411.         date) command
  1412.  
  1413.         Added support for IBM Proprinter
  1414.  
  1415.         Added .ta (tab interval) command
  1416.  
  1417.         Added .wi (wrap indent) command
  1418.  
  1419. 1.22    Added .ns (no sort) command
  1420.  
  1421.         Added .sw (single width) command for
  1422.         .h1 text
  1423.  
  1424.         Added .dw (double width) command for
  1425.         .h1 text
  1426.  
  1427.         Added View feature
  1428.  
  1429.         Added .mn (minimum notes) command,
  1430.         range 0 to 20
  1431.  
  1432. 1.23    Added "Search" to View feature
  1433.  
  1434.         Changed .mn command range to 1 to 20
  1435.  
  1436. 1.24    Added 43x80, 50x80, and 60x80 screen
  1437.         support
  1438.  
  1439.         Changed Handbook view to facing pages
  1440.         for extended screens
  1441.  
  1442. 1.25    Changed most BIOS screen I/O to
  1443.         internal BASIC I/O
  1444.  
  1445.         Speeded up displays
  1446.  
  1447.         Reduced size of executable program
  1448.         file
  1449.  
  1450. 1.26    Added (E)dit to Main Menu
  1451.  
  1452.         Added (E)ditor name to Configure Menu
  1453.  
  1454.         Removed 60x80 screen support (caused
  1455.         problems with most editors)
  1456.  
  1457.         Added Calendar entry to index
  1458.  
  1459.         Fixed bug in Index Sort routine
  1460.  
  1461. 1.27    Fixed bug in manual date entry
  1462.         routine
  1463.  
  1464. 1.28    Improved Help Screen display routines
  1465.  
  1466.         Moved Help Text to external formatted
  1467.         file
  1468.  
  1469.         Changed (N)ext, (P)revious, etc, to
  1470.         PageDn, PageUp, etc.
  1471.  
  1472. 1.29    Added Color and Borders
  1473.  
  1474. 1.30    Moved Configure routines to external
  1475.         program
  1476.  
  1477.         Added Display Attribute configuration
  1478.         routine
  1479.  
  1480. 1.31*   Fixed bug in monochrome display
  1481.         routines
  1482.  
  1483.         Added /m and /c command line
  1484.         parameters to override automatic
  1485.         monochrome or color operation
  1486.  
  1487. 1.32    Fixed bug in Notes and Index headers
  1488.  
  1489.         Improved scrolling of help text
  1490.  
  1491.         Fixed video mode bug in configuration
  1492.         module
  1493.  
  1494.         Now include Shareware editor VDE
  1495.         (Video Display Editor) Note: VDE must
  1496.         be licensed separately with Eric
  1497.         Meyer if used.
  1498.  
  1499. 1.33    Added .qu (Quiet) command to suppress
  1500.         message on last page.
  1501.  
  1502.         Revised .mn (Minimum Notes) command
  1503.         to allow 0 - 20 NOTES pages added
  1504.         after Index. Since a Handbook or
  1505.         Landscape mode Mini-Manual requires a
  1506.         bindable number of pages (divisible
  1507.         by 4), .mn will be overridden if
  1508.         necessary.
  1509.  
  1510.         Added .ni (No Index) command to
  1511.         suppress the Index.
  1512.  
  1513.         Added Configuration Status box to
  1514.         Main Menu screen.
  1515.  
  1516.         Added Landscape print mode support
  1517.         for H-P LaserJet printers.
  1518.  
  1519.         Added Duplex (double-sided print)
  1520.         mode support for H-P LaserJet IId and
  1521.         IIId printers.
  1522.  
  1523.         Added (R)eset choice to Main Menu.
  1524.         This deletes any current work files
  1525.         and forces the Handbook text file to
  1526.         be reprocessed. This allows you to
  1527.         select a new manually entered
  1528.         calendar date between print jobs.
  1529.  
  1530. 1.34    Moved Print routines to separate
  1531.         modules.
  1532.  
  1533. 1.35    Combined Print routines into single
  1534.         external module.
  1535.  
  1536.         Added .pn (Set initial page number)
  1537.         command.
  1538.  
  1539.         Added Print (S)ome to Main Menu. This
  1540.         allows you to reprint a page or range
  1541.         of pages without having to reprint
  1542.         the entire Handbook.
  1543.  
  1544. 1.36*   Added Letter Layout (8.5 x 11).
  1545.  
  1546.         Added 60x80 VGA mode to support
  1547.         Letter Layout.
  1548.  
  1549.         Modified .ca (Calendar) to print a
  1550.         default of four months per
  1551.  
  1552.         Mini-Manual page, and five months per
  1553.         Letter Layout page.
  1554.  
  1555.         Added .cm (Calendar Months per page)
  1556.         command to adjust the number of
  1557.         months per calendar page for the best
  1558.         fit.
  1559.  
  1560.         Added Landscape Mode for dot-matrix
  1561.         printers.
  1562.  
  1563.         Added HBKSET utility.
  1564.  
  1565. .h1 FUTURE PLANS
  1566.  
  1567. Development of HANDBOOK came to a temporary
  1568. halt early in 1990, for several reasons. I
  1569. was out of town on business for four months
  1570. starting in January, and in late May started
  1571. a new job which has occupied a great deal of
  1572. time. Finally, in September I returned to
  1573. College after an absence of nearly twenty
  1574. years to complete the requirements for a
  1575. degree in Computer Science. In December, my
  1576. department began a project which resulted in
  1577. my kids asking if, not when, I was coming
  1578. home from work. Fortunately this project is
  1579. complete and we are back to a normal rat
  1580. race. 
  1581.  
  1582. All these things contributed to my shelving
  1583. HANDBOOK, but what made it easy was that
  1584. since it was initially released only a
  1585. handful of people had ever registered (or
  1586. criticized) the program, most of those
  1587. members of a local computer club. It appeared
  1588. that HANDBOOK was not being received well and
  1589. that there was little reason to improve
  1590. HANDBOOK beyond the basic capability which I
  1591. still used regularly.
  1592.  
  1593. More recently, HANDBOOK has been discovered,
  1594. kind of, and we have received some more
  1595. registrations and requests for upgrades. I
  1596. have therefore decided to dig back into it
  1597. and add some requested features plus a few I
  1598. wish I had thought of earlier. 
  1599.  
  1600. As the previous version was being readied for
  1601. delivery, several users asked for additional
  1602. features within HANDBOOK. In some cases they
  1603. are probably beyond the scope of a $5
  1604. shareware program, but many have been
  1605. implemented. 
  1606.  
  1607. I am considering a "Signature" mode in which
  1608. the Handbook is printed in 16-page booklets.
  1609. This is a suggestion from Evelyn Stewart, of
  1610. Milford, New Jersey, and in her words, near
  1611. as I recall, "...would allow some serious
  1612. bookbinding".
  1613.  
  1614. .h1 IN CLOSING...
  1615.  
  1616. I hope that HANDBOOK is as useful for you as
  1617. it has already been for myself and others,
  1618. and that it becomes one of those "handy
  1619. little programs" that keep getting used again
  1620. and again. I think that that hope is how
  1621. these things get written in the first
  1622. place... 
  1623.  
  1624. I wish to thank those of you who have
  1625. registered your copies of HANDBOOK, and all
  1626. of you who provided constructive criticism of
  1627. the program in addition to letting me know
  1628. what is right with it.
  1629.  
  1630. The original idea for this program, and its
  1631. first implementation, is credited to Tony
  1632. Vasilakis, who needed a tiny phone list to
  1633. shove in his pocket for easy reference. 
  1634.  
  1635. Pete Cosman expanded the phone list into
  1636. NOTEBOOK, coding in Microsoft MBASIC on an
  1637. NCR Decision Mate V PC under CP/M-80.
  1638.  
  1639. HANDBOOK is a complete rewrite of NOTEBOOK,
  1640. with many enhancements, and is implemented
  1641. under Microsoft QuickBASIC 4.5 with some help
  1642. from Microsoft Macro Assembler 5.1, running
  1643. under MS/PC-DOS 2.11 and above. 
  1644.  
  1645. It is axiomatic that programmers should never
  1646. be permitted to produce their own
  1647. documentation. Several previous versions of
  1648. HANDBOOK provided a few pages of useful
  1649. instructions, and twenty or so of general
  1650. "grumble, grunt, and snort", or words to that
  1651. effect. I hope that the documentation is now
  1652. more useful. My sincere thanks to Evelyn
  1653. Stewart of Milford, New Jersey, for her
  1654. pertinent comments.
  1655.  
  1656. Special and Continuing Thanks to Richard
  1657. Scott, of Hobbs, New Mexico, for your
  1658. constructive criticism, and your consistently
  1659. excellent and valuable help. And thanks for
  1660. helping me through those first stumbling
  1661. trials when my Decision Mate V was new and
  1662. all I knew about computers was how to play
  1663. Adventure...
  1664.  
  1665. Again, thanks for giving HANDBOOK a try. 
  1666.  
  1667. Chuck Sterling 
  1668. The Nit Picker...
  1669.  
  1670.