home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / CPM / PROGRAMS / LIST / FANFLD21.LBR / FANFLD21.DZC / FANFLD21.DOC
Text File  |  2000-06-30  |  53KB  |  1,161 lines
  1. FANFOLD: A CP/M TURBOPASCAL TEXT COMPACTING/FORMATTING/PRINTING UTILITY
  2. VERSION 21.0r  Copyright: January 29, 1990 
  3. Ron Rock,Sr. and Ron Rock,Jr.
  4. Chicago,IL
  5.  
  6. Issued as SupportWare with Public Domain Distribution; No Warranty of
  7. any type is Expressed or Implied. TurboPascal (tm) is Borland
  8. International's v.3.0. This program is full featured as I personally
  9. dislike the disabled shareware concept. However, because of the
  10. amount of time involved, I am  no longer able to respond to inquiries
  11. from non-registered users. 
  12.  
  13. If you find this program useful and wish to become a registered user
  14. of  FANFOLD, send your name, address and a donation of $15.00 (U.S.) by
  15. check or  money order to:
  16.  
  17. [S]
  18.          Ron Rock
  19.          316 N. Michigan Ave. #400
  20.          Chicago, IL 60601
  21. [E]
  22.  
  23. A registered user will receive a registration #, notification of
  24. significant updates, consideration of suggestions for new features (or
  25. customization), and direct mail and/or phone support. 
  26.  
  27. MAY BE INSTALLED FOR ANY CP/M Z80 OPERATING SYSTEM  WITH A FREE TPA ADDRESS
  28. OF AT LEAST D180h.  If your TPA is insufficient you will be told that you
  29. are "OUT OF MEMORY" and the program will be aborted.
  30.  
  31. See INSTALLATION below.
  32.  
  33. `Why use FANFOLD ? `
  34.  
  35. The reason for FANFOLD is a personal one, perhaps widely shared, that
  36. many formatted text files are simply too long. While a .DOC file may
  37. look very nice, I cringe at the first "dot" command or expanse of
  38. empty space on-screen, especially when the file is 40 or 60k.
  39. Depending on how many formfeeds are embedded in the text, a printout
  40. may take 20 to 40 sheets which then must be handled, stored, and
  41. flipped through  when needed. After using a word processor several
  42. times to clean up the text before printing a hard copy, FANFOLD
  43. emerged. By printing on both sides of fanfold paper you can save at
  44. least 50% of all of the above. Ridding the text of most of the
  45. "Formatting Fluff" saves even more and choosing the 2 column mode may
  46. save another 50%. Various lists, catalogs and BBS messages are also
  47. prime candidates for "compaction". In fact, I run FANFOLD even on
  48. files I will only read from disk. I can quickly set the format as I
  49. wish and eliminate print commands by viewing the <fn>.FAN file.
  50.  
  51. Finally, I save about 75% on my paper costs.
  52.  
  53. As I recall, a recent example is EPEX11.MAN by James H. Whorton. Nice
  54. program,  nice doc; but it printed out on some 51 pages. After
  55. FANFOLD: 5 sheets; more  than 1500 blank lines eliminated; with only a
  56. small fraction of the total  printing time needed. (If you want to
  57. replicate, set FANFOLD to NOT change  linelength; delete whitespace; 2
  58. column mode; 88 lines/page and two sided  output: 1779 lines will be
  59. processed; 1588 blank lines will be eliminated.)
  60.  
  61. A 90% saving of paper!
  62.  
  63. [S]
  64. FANFLD21.LBR CONTAINS THE FOLLOWING FILES:
  65.  
  66. The files with a "Z" in the extent are "CRUNCHED" and must be
  67. "un-CRUNCHED" before use.
  68.  
  69. FANFLD21.DZC    DOCUMENTATION
  70. FANFLD21.UPD    UPDATE NOTES
  71. FANFLD21.COM    The program
  72. FANINS21.CHN    for installation of Printer/Defaults
  73. FANTRM21.COM    for installation of Terminals
  74. FANTRM21.DTA    for installation of Terminals
  75. FANTRM21.MSG    for installation of Terminals
  76. [E]
  77.  
  78. See INSTALLATION below.
  79.  
  80. -----------------
  81.  
  82. `What is FANFOLD ? `
  83.  
  84. FANFOLD is a "What You See Is What You Get" text file utility to compact and 
  85. reformat a text file including printing on both sides of fanfold paper. The 
  86. Source Text may be either standard ASCII text files or WordStar/NewWord type 
  87. document text with embedded soft spaces, hyphens, and carriage returns. The 
  88. user has full menu control of the output format. You may take any Source File
  89. text and:
  90.  
  91. [S]
  92.           * lengthen, shorten, fill, and justify Text lines;
  93.           * carry to new line or truncate "as is" lines;
  94.           * save to disk file and/or send to printer; with
  95.           * one or two sided printout on fanfold
  96.             or regular paper;
  97.           * normal or two column printout with variable
  98.             column #2 start location;
  99.           * delete excess whitespace; toggled, left edge, or all;
  100.           * 10/12/17/20 characters per inch;
  101.           * 1 to 66/88/99 lines per page;
  102.           * number of blank lines at top/bottom of page;
  103.           * header line on odd pages;
  104.           * page number placement; top, bottom, corners;
  105.           * hole-punching offset on odd pages only;
  106.           * left margin on all pages;
  107.           * pre-View output;
  108.           * create a Table of Contents;
  109.           * and redirect output to another drive/user.
  110. [E]
  111.  
  112. Internal checks and /or default settings are provided to assure that the final 
  113. printout is compatible with the printer, i.e. printing linelength of less than 
  114. 136 characters at 17 chars per inch, etc., etc.
  115.  
  116. At first, FANFOLD may seem very complicated because of the many
  117. options available. However, the options are just that --options-- to
  118. be used or not as the spirit dictates. Try various combinations and
  119. V>iew to see the results.  No change is made to the
  120. Source File. FANFOLD creates new files as needed. You may exit FANFOLD
  121. at any "Yes,No,Exit" prompt by entering "E". You may stop scrolling by
  122. entering a control-S (^S) during a V>iew and start again with any keypress.
  123. A control-S followed by a control-C may also halt FANFOLD.
  124.  
  125. NOTE: At times FANFOLD will appear to pause for varying periods of
  126. time without displaying any screen prompt. During such times, FANFOLD
  127. is filling its buffers and performing other tasks within the buffers.
  128. The length of the pause is dependent upon the task and the speed of the 
  129. hardware and medium used for the drives. RAM DISK is shortest, next HARD DISK
  130. and finally FLOPPY SSSD's. If NOTHING has occurred for say, 30 sec.,
  131. during an expected READ or WRITE to  a file or the screen, FANFOLD may
  132. have hung-up. Check for corrupted files.
  133.  
  134. A <CR> WILL ENTER THE INDICATED DEFAULT SETTING AND PROCEED TO THE
  135. NEXT ITEM IN THE MENU. AN <ESC> WILL ENTER ALL OR REMAINING DEFAULT
  136. VALUES IN THE "PRE-FORMAT" MENU.
  137. (Exception: The R>un command in the Format Menu is displayed but "R" 
  138. MUST be entered to Run.) You may alter the default settings: see 
  139. INSTALLATION below.
  140.  
  141. `Getting started `
  142.  
  143. Enter "FANFLD21" or "[du:]FANFLD21 [du:source.ext]"
  144.  
  145. - and follow the screen prompts.
  146.  
  147. You should not need to read this documentation except to install FANFOLD for 
  148. your computer. (Oh sure! Only if I wrote the program!) You might want
  149. to print this out as your first "attempt". Be sure to have a backup
  150. original of everything - "Just in case!" 
  151.  
  152. See INSTALLATION below.
  153.  
  154. An example of the Pre-Format Menu for the file FANFLD21.DOC is as
  155. follows: ( Questions are asked in sequence. User entry follows the ":"
  156. or ">" N.B. The actual file size, etc. may vary from this example.)
  157.  
  158. [S]
  159. The screen prompts are presented sequentially in the PRE-FORMAT MENU.
  160.  
  161. ----Top of Screen (PRE-FORMAT MENU)---------
  162. GEMINI 10X/FANFOLD v21.0b Copyright 1/29/90 Ron Rock Sr/Jr Chicago, Il
  163. ----------------------------------------------------------------------
  164. Source Filename: E0:FANFLD21.DOC
  165. Write output to another Drive-User (DU:) [Y/N/Exit] ? > Y
  166. Drive letter [A-P] > E User # [0-15] > 15
  167. Output to Drive-User: E15:- Ok [Y/N/Exit] ? > Y
  168. WS/NW type file [Y/N/Exit] ? > N
  169. Reformat for new Maximum Linelength [Y/N/Exit] ? > Y
  170.  
  171. Text between "[S]<CR>" and "[E]<CR>" is unaltered, otherwise:
  172.  
  173. (Width:Linelength) 78:160; 66:136; 46:96 ; 38:80; w/o Margin & Offset
  174. Gives minimum column separation of 2 <SP>.
  175. Max Linelength [1-160] > 78
  176. Truncate "unaltered" to the maximum linelength of 78 [Y/N/Exit] ? > N
  177. Delete whitespace [Y/N/Exit] ? > Y
  178. Carryover to new line [Y/N/Exit] ? > N
  179. Fill [Y/N/Exit] ? > Y
  180. Justify [Y/N/Exit] ? > N
  181.  
  182. All Flush Left [Y/N/Exit] ? > N
  183. View results [Y/N/Exit] ? > Y
  184. Everything Ok [Y/N/Exit] ? > Y
  185.  
  186. ----- Bottom of screen ------
  187. [E]
  188.  
  189. And now to step through the Pre-Format Menu...
  190.  
  191. `Source File Name: `
  192.  
  193. Enter the name of the file you wish to FANFOLD if you did not enter it
  194. as a CP/M command parameter. 
  195.  
  196. EXAMPLE> Source File Name: A0:FANFLD21.DOC<CR>
  197.  
  198. While processing a SOURCE FILE, FANFOLD  creates and names files with
  199. the filename of the SOURCE FILE plus EXTENTS of FAN, ODD, EVE and
  200. NDX. These extents must be considered as reserved for FANFOLD. With
  201. the exception of <fn>.FAN files (as explained below) FANFOLD will
  202. abort with "INVALID" if a source file name with an extent of ODD,
  203. EVE, or NDX is entered.  Rename the source file extent. 
  204.  
  205. FANFOLD will ask a number of pre-formatting questions in order to
  206. create the intermediate file, "<source>.FAN", which is then used as
  207. the "draft" for the Format Menu. The first line of a <source>.FAN file
  208. contains the the original filename, the total number of lines, the
  209. pre-format linelength ,the longest linelength (see the "as is"
  210. toggle below) retained, and the number of blank lines eliminated.
  211. The format is: 
  212. source filename=<# lines>/<set maxlength>$<longest>*<blank lines  deleted>
  213. ie."FANFLD21.DOC=423/78$78*0".
  214.  
  215. When you E>xit from the FORMAT MENU ( not this Pre-Format Menu), the
  216. <source>.FAN file is saved and closed and the empty <fn>..ODD,.EVE,.NDX
  217. files are erased.
  218.  
  219. If you wish, the <source>.FAN file then may be edited, index markers added
  220. or other changes made. The Format Menu will use the original
  221. parameters for calculations but will process the changed text in full.
  222.  
  223. FANFOLD  recognizes that a source file name with the reserved extent
  224. ".FAN" has  been "cleaned up" and pre-formatted by FANFOLD and is prepared 
  225. for final formatting.
  226.  
  227. When "<source>.FAN" is entered as the Source File, FANFOLD seeks the
  228. information contained in the first line and goes directly to the formatting
  229. menu, saving the cleanup/counting time. Entering an <ESC> will enter the
  230. remaining default values in the Pre-Format Menu. You may redirect the
  231. output (.ODD,.EVE,.NDX files) to another DU:.
  232.  
  233. `Write output to another Drive-User (DU:) [Y/N/Exit] ? > Y`
  234. Drive letter [A-P] > E User # [0-15] > 15
  235. Output to Drive-User: E15:- Ok [Y/N/Exit] ? > Y
  236.  
  237. Default = "N".
  238.  
  239. If "E" is entered you will be returned to CP/M whenever the prompt is
  240. in the form  ...... [Y/N/Exit] ? >. Open files are closed and
  241. retained in this Pre-Format Menu.
  242.  
  243. You may write the output to another drive by answering "Y". The
  244. default "N" writes to the drive of the Source File. As a rough measure
  245. of the free space needed on a drive, double the size of the Source
  246. File. If the space on a drive is less than needed, direct the output
  247. to a fresh disk on another drive. In some instances, a step by step
  248. approach may be needed...ie. Source to <source>.FAN then <source>.FAN
  249. to <source>.ODD /<source>.EVE/<source>.NDX.  If an error message of
  250. "F0" is displayed while running FANFOLD, you have run out of disk
  251. space and must begin again after making room for the files. The only
  252. limitation on the size of a source file is the available free disk
  253. space. You may find it best to pre-format to the <source>.FAN file,
  254. exit and/or write to a fresh logged disk for the .ODD,.EVE,.NDX files,  
  255. ie. "FANFLD21 du:source.FAN. FANFOLD will read the parameters from
  256. the <du:source>.FAN file, permit redirection of the output and go to
  257. the Format Menu.
  258.  
  259. `Output to [DU:]- Ok [Y/N/Exit] ?> `
  260.  
  261. Default = "Y".
  262.  
  263. The Drive-User of the files to be created are displayed. The default 
  264. is "Y" to continue. If "N" is entered you will be returned to the 
  265. "Drive" question. If "E" is entered you will be returned  to CP/M. 
  266.  
  267. `Is FANFLD21.DOC a WS/NW type file [Y/N/Exit] ? > `
  268.  
  269. Default = "N".
  270.  
  271. FANFOLD will read a text file, either line by line (a standard ASCII
  272. text file) or character by character ( a WS/NW-Wordstar(tm) or 
  273. NewWord(tm) text file ) eliminating any embedded formfeeds, dot 
  274. commands or strings of carriage returns greater than two. If the fill
  275. is a WS/NW type it will strip the set bit and provide hard carriage
  276. returns. You must have specified a linelength.
  277. The default is "N" since FANFOLD will automatically stop and ask to 
  278. restart if  non-ASCII text lines are encountered. The WS/NW mode is 
  279. 1/3 slower than the default ASCII mode.
  280.  
  281. `Reformat for new maximum linelength [Y/N/Exit] ? > `
  282.  
  283. Default = "Y".
  284.  
  285. The "Reformat for new maximum linelength " question has two purposes:
  286. first, to set the linelength for two column printing or to be certain
  287. the text line will fit; and second, to permit fill and justification
  288. of paragraphs. If "N" is entered the Source File lines are unaltered
  289. but for formatting purposes,  FANFOLD keeps track of the longest line
  290. encountered, the number of blank lines eliminated and size of the new
  291. file ( with an extent of FAN) in lines. You must select a maximum line
  292. length in order to FILL and/or JUSTIFY and/or DELETE WHITESPACE. If
  293. you do not want to fill or justify but you do want to delete whitespace
  294. set the maximum linelength to 160 (the upper limit of a line in
  295. FANFOLD).
  296.  
  297. If the default "Y" is chosen the following will appear:
  298. ----------------------------
  299. `Text between "[S]<CR>" and "[E]<CR>" is unaltered, otherwise:`
  300.  
  301. (Width:Linelength) 78:160; 66:136; 46:96 ; 38:80; w/o Margin & Offset
  302. Gives minimum column separation of 2 <SP>.
  303. Max Linelength [1-160] > 78
  304. ----------------------------- 
  305. [S]  
  306. Note the "[S]" immediately above this line and the "[E]" at the end of
  307. this paragraph and other places in this .DOC if you have not FANFOLD'ed this
  308. file. The open square bracket-uppercase S/E-close square bracket are toggles
  309. which must be placed at the leftmost column within the SOURCE FILE to [S]tart
  310. and [E]nd the  preservation of Source "AS IS". No filling, justification, or
  311. deleation of whitespace occurs and the toggles (The "[S]" and "[E]" placed
  312. in the source file to invoke the "as is" feature) are not written to the 
  313. <sourcename>.FAN file.
  314. [E]
  315.  
  316. The purpose of the "as is" toggle is to maintain tabular or other formated text
  317. portions of a Source file unaltered or "as is", while the remaining
  318. text is processed.
  319.  
  320. If 2 column mode is selected in the later Format Menu, "as is" lines
  321. which are longer than the selected column width are included in full,
  322. UNLESS you select the OPTION to:
  323.  
  324. `Truncate "unaltered" to the maximum linelength of (nn) [Y/N/Exit] ? > Y`
  325.  
  326. This option is provided to insure that a printer which will carry-
  327. over any line which exceeds the maximum printable linelength will
  328. not destroy the page format.  In some cases it is acceptable to 
  329. "lose a few characters" at the end of a line rather than re-format.
  330. The "problem" will usually occur where an "as is" segment in 2
  331. column mode will exceed the printer's capacity, forcing an
  332. unexpected and unaccounted for extra line. The default value is "Y"
  333. since the result of the "N" may be a disaster in a long file. 
  334. However, you may wish to try FANFLD with a "N" for your printer.
  335.  
  336. OTHERWISE: 
  337. in 2 column mode, if column #1 within the [S] & [E] toggles exceeds
  338. the start of column #2, a delineator of " | " will be added to the end
  339. of the column #1 text to separate it from column #2 text. This
  340. provides a means of obtaining "readable" text in 2 column mode when
  341. the unformatted text in column #1 is near but not the same as the
  342. column #2 position selected. The Format Menu will display the number
  343. of chars in the "Longest" line found within the "[S]/[E]" blocks IF
  344. greater than the selected maximum linelength.
  345.  
  346. Most users will find that source text which contains many small
  347. tabular text segments will print best in 2 column mode. If only
  348. occasional tabular text or many long paragraphs are present, selecting
  349. a FILLED and/or JUSTIFIED linelength as long as possible is best for
  350. conserving paper. However, the two column mode is easier on the eyes.
  351.  
  352. If MAXIMUM LINELENGTH, FILL,JUSTIFY,and DELETE WHITESPACE are not
  353. selected, FANFOLD will preserve the source text "as is" with only
  354. FORMFEEDS, DOT COMMANDS and multiple <CR>'s removed.  Two sided printing
  355. and other options will still be possible.
  356.  
  357. `Max Linelength [1-160] > 78`
  358.  
  359. The default is set to a linelength of "78" characters. (See installation
  360. to change this default.)  The longest line which may be set is 160 
  361. characters.  
  362.  
  363. The user may specify a linelength for the <source>.FAN file either to
  364. utilize the 2 column per page mode; assure that the text will print
  365. properly at 10,12,17,20 CPI; or set the linelength for FILL and/or
  366. JUSTIFY.  (Yes, you can cause FANFOLD to crash by selecting a length
  367. of "1". The minimum linelength is equal to the longest word in the
  368. text.)
  369.  
  370. If the column mode is later selected in the Format Menu, the printer 
  371. linelength will be automatically adjusted to accommodate the 2
  372. columns with a default column separation of 2 spaces. You may increase/
  373. decrease that value in the Format Menu.
  374.  
  375. If "E" is entered you will be returned to CP/M. 
  376.  
  377. A bit of technical information may be helpful. To conserve file size,
  378. especially in the 2 columns per page mode, FANFOLD makes maximum use
  379. of tabs for formatting. You will be able to set the start of column #2
  380. to any value. The column position will be padded with spaces from the 
  381. nearest tab. 
  382.  
  383. Setting the column #2 position also sets the maximum acceptable text
  384. characters per column. In other words, it is not possible to put a
  385. line of text of 45 characters into a column of 40 characters. However,
  386. if when asked : "Reformat for a new maximum linelength > " a
  387. linelength of "38" was entered, no line of text would exceed 38
  388. characters and would fit in the 40 spaces reserved for Column #1.  The
  389. 2 character difference between the 38 and 40 provides the separation
  390. between Column #1 and Column #2. In practice a 2 space separator is a
  391. good minimum value. If more than 2 spaces is desired, select a smaller
  392. " new maximum linelength " or enter a higher column #2 start position.
  393.  
  394.  `Delete whitespace [Y/N/Exit] ? > `
  395.  
  396. The default is set to "Y" since it is almost always desirable to delete 
  397. existing source text whitespace, especially with the FILL and JUSTIFY 
  398. options. HOWEVER:
  399.  
  400. If you do not select the "delete whitespace" option you will be 
  401. given another option later; "All Flush Left" (see below).
  402.  
  403. `Carryover to new line [Y/N/Exit] ? > `
  404.  
  405. Having set the Maximum linelength, you may not want the excess characters
  406. of any of a "long" line prepended to the next line as in Fill Mode. 
  407. For example, the text may be a line numbered assembler PRN file and you
  408. wish to retain the left edge even on "too long" lines. Selecting the 
  409. Carryover option will place any excess over the selected maximum linelength
  410. to the next line as a new line.  
  411.  
  412. The default is "N".
  413.  
  414. If you do not select the Carryover option you will be asked:
  415.  
  416. `Fill [Y/N/Exit] ? > `
  417.  
  418. `Justify [Y/N/Exit] ? > `
  419.  
  420. It is possible to have a filled and/or justified line of any length up
  421. to 160 characters. To reach this feature you must choose to reformat a
  422. linelength and specify the new linelength.
  423.  
  424. The Fill option will append words from the following line to fill-up
  425. any "short" line which is not the end of a paragraph. A paragraph is
  426. defined as any block of text separated from the next block of text
  427. by at least one blank line. 
  428.  
  429. The JUSTIFY option will add spaces to any line which is within 16
  430. characters of the selected maximum linelength to provide a uniform
  431. right edge of text.
  432.  
  433. The default is "Y". If "E" is entered you will be returned to CP/M.
  434.  
  435. `Flush left only [Y/N/Exit] ? >`
  436.  
  437. Choose this option if the Source file contains a left margin which
  438. you wish to eliminate but you wish to preserve the remainder of the
  439. line spacing. This option applies even to the "AS IS" text. Useful
  440. when the source file contains a left margin which you wish to eliminate.
  441.  
  442. `View results [Y/N/Exit] ? > `
  443.  
  444. The default is "Y".
  445.  
  446. The pre-formatting output to the <Source>.FAN file is displayed
  447. on-screen to permit "checking" of the pre-formatting.  If a line is
  448. greater than 78 characters long, only the first 78 characters are displayed
  449. on the CRT to prevent "carryover".
  450.  
  451. Note the timed instruction at the base of the screen to toggle
  452. V>iewing off. You must strike a key while the instruction is present
  453. to toggle viewing off. If viewing is toggled off during creation of
  454. the FAN file, you will be asked if you wish to continue to view the
  455. Fan file (it's faster if not Viewed) or re-start by returning to the
  456. beginning of the pre-format menu. A <CR> or "Y"  will continue
  457. pre-formatting and show progress without viewing output.
  458.  
  459. `Everything Ok [Y/N/Exit] ? > ` 
  460.  
  461. This is your final chance to check that everything shown is correct
  462. for the creation (and viewing) of the <source>.FAN file. The default
  463. is "Y". If you enter "N" you will be returned to the beginning of the
  464. pre-format menu, AFTER the "SourceName" and you may reset any parameters 
  465. you wish. 
  466.  
  467. If "E" is entered you will be returned to CP/M.  
  468.  
  469. While writing the intermediate file, <source>.FAN, without viewing,
  470. FANFOLD will indicate progress every 100 or so lines processed.
  471.  
  472. Once the <source>.FAN file is written, FANFOLD moves to the `FORMAT
  473. MENU` which will look as follows: (The actual values may vary.) 
  474.  
  475. [S]
  476. --------TOS---- (FORMAT MENU) ------------
  477. GEMINI 10X/FANFOLD  v21.0b Copyright  1/29/90  Ron Rock Sr/Jr Chicago, Il  
  478. ------------------------------------------------------------------------- 
  479. > 27 blank lines were deleted > Output to E15:
  480.  
  481. File E15:FANFLD21.FAN contains 996 Lines: Pre-formatted= 78 chars; Longest= 79 
  482.  
  483. THE FORMAT FOR THE OUTPUT FILES IS AS FOLLOWS :
  484. " FANFLD21.DOC  "
  485. H>eader     : 2 Line Header with the above at Line: 1
  486. F>ooter     : 3 Line Footer with Page # in LOWER MIDDLE
  487. O>ffset Pun : 0 TAB offset on ODD Pages for hole punching
  488. C>olumn Tgl.: Normal text
  489. M>argin     : 0 space LEFT margin on ALL Pages
  490. L>inelength : 80 CHARACTERS per Line  [ 10 Chars Per Inch ]
  491. P>agelength : 88 LINES/PAGE [ 8 LPI ] FOR : 13 Pages/7 Sheets
  492. I>ndex Tgl. : Off
  493. V>iew       : Scroll 1st 80 columns as formatted
  494. E>xit       : to CP/M with E15:FANFLD21.FAN Saved
  495.    ENTER CHAR OF ITEM YOU WISH TO CHANGE OR "R" IF READY TO RUN  > R
  496.  
  497.  ODD: |< text  1..to..78 >| of |80
  498. EVEN: |< text  1..to..78 >| of |80
  499.  
  500. | O |= Hole tab : T= 8 sp. tab : m=margin <SP> : |.s.|= Col. Separator
  501.  
  502. --------BOS---------- 
  503.  
  504. [E]
  505.  
  506. If you are running FANFOLD for the first time or don't recall the
  507. effect of the various commands, the best way to learn is to step
  508. through them and V>iew the result. You will be guided by screen
  509. prompts as needed. Nothing will be written to the <source>.ODD and/or
  510. <source>.EVE file until you enter the "R" to run the settings. FANFOLD
  511. is designed to only permit or automatically adjust the settings to a
  512. consistent whole.
  513.  
  514. NOW, TO STEP THROUGH THE  FORMAT MENU DISPLAY ...
  515.  
  516. `> 27 blank lines were deleted > Output to E15:`
  517.  
  518. Tells the number of blank lines eliminated from the Source File as the
  519. <source>.FAN file was created. Just makes you feel good if the number
  520. is large. Also reminds you of the DU: of the <fn>.ODD,.EVE.,.NDX files.
  521.  
  522. `File E15:FANFLD21.FAN contains 996 Lines: Pre-formatted= 78 chars; Longest= 79 `
  523.  
  524. Information about the <source>.FAN file just created. LONGEST = nn
  525. chars refers to the longest line in <source>.FAN which may be greater
  526. than the "Pre- formatted = nn", if the "as is" ([S]/[E]) toggles have
  527. been inserted in the Source File, "Longest" displays the longest line
  528. therein or the Pre-formatted value if that is greater."As Formatted =
  529. nn" will give the maximum linelength  selected or found if no maximum
  530. linelength was set.
  531.  
  532. `" FANFLD21.DOC "`
  533.  
  534. The text between the "  "'s displays the contents of the header line.
  535. The default is simply the Original Source Filename. If page number
  536. placement is set to T>op while setting the F>ooter parameters " Page
  537. nn of nn Pages"  is automatically appended and displayed.
  538.  
  539. `H>eader     : 2 Line Header with the above at Line: 1`
  540.  
  541. Permits the changing of the default header line as displayed in the
  542. line above. The number of lines in the header may be set to any value
  543. but the placement of the text will always be two lines above the body
  544. of the text. While the header may be up to 160 characters long, entry
  545. of more than 78 characters will affect screen alignment. The header
  546. line text is written only to ODD numbered pages. Page numbers are
  547. written to all pages.
  548.  
  549. `F>ooter     : 3 Line Footer with Page # in LOWER MIDDLE`
  550.  
  551. Permits selection of the placement of the page # and the number of
  552. lines in the footer. If the page number is retained at the page bottom
  553. (middle or corners) a blank line then the page number  line is
  554. written. To assure skipping over the perforation of fanfold paper the
  555. number of footer lines may be increased. FANFOLD ends a formatted page
  556. with a Formfeed (^L) to align subsequent pages. Recall that FANFOLD
  557. has eliminated all formfeeds in <source>.FAN so that pagination will
  558. be controlled by you, the user. To prevent, in so far as possible,
  559. multiple formfeeds at printing, the body of the text will never be
  560. greater than the number of lines per page selected less three. Thus,
  561. selecting 0 H>eader lines and 0 F>ooter lines will result in 63 (of
  562. 66); 85 (of 88) or 96 (of 99) lines of text per page. If multiple
  563. formfeeds are still encountered when printing, increase the number of
  564. F>ooter lines.
  565.  
  566. `O>ffset Pun : 0 TAB offset on ODD Pages for hole punching`
  567.  
  568. Permits setting of an offset for hole punching by tabbing text to the
  569. right on odd pages. If FANFOLD will not accept an offset, the
  570. available space in a line must be increased by increasing L>inelength;
  571. decreasing M>argins toggling C>olumn off or (worst case) starting
  572. again with a smaller maximum linelength. The bottom line display will
  573. assist in making that decision. It will also show a "| O |" to
  574. represent the punched hole position. Note that if the C>olumn toggle
  575. is set, the O>ffset will relocate the columns IF the selected
  576. linelength permits.
  577.  
  578. `C>olumn Tgl.: Normal text`
  579.  
  580. This command is a "toggle" command. Entering a "C" will toggle the
  581. command on; entering a "C" once again will return to "Normal Text".
  582.  
  583. Permits choosing to print with two columns of text per page side. It
  584. is this option which is referred to in the pre-format menu line above:
  585.  
  586. [S]
  587.  Column (width:length) 78:160; 66:136; 46:96 ; 38:80; w/o Margin & Offset
  588.  Gives minimum column separation of 2 <SP>. Column Width [1-160] > 78
  589. [E]
  590.  
  591. FANFOLD will automatically calculate a minimal Column #2 position
  592. (column length + 2 spaces) and readjust the L>inelength if possible. 
  593. You may override by entering your own values as desired but FANFOLD will 
  594. not accept "Bad" values. You may also want to check the P>agelength line 
  595. to see what affect the C>olumn toggle has on the number of " nn Pages/nn Sheets"
  596. calculation. You may toggle back and forth as desired. 
  597. You may also V>iew at any time or check the bottom line display to assist. 
  598. Note that FANFOLD wants at least a 2 space column separator, but you may 
  599. increase or decrease that value.
  600.  
  601. While personal preference is paramount, I usually try to maximize
  602. linelength and if the Source File contains few tables to be left "as
  603. is" I choose not to use the two column mode. If more than a few
  604. portions are left "as is" I use the two column mode. (I find I'm using
  605. the 2 column mode almost all the time for printing, and the 78 character
  606. linelength for only viewing disk files...at this writing)
  607.  
  608. The effect may be V>iewed and you have the option to view either the
  609. right edge or left edge if the formatted linelength is greater than
  610. the screen width.
  611.  
  612. A two column page with Column #2 at 80 will appear to be only half there with 
  613. the left or rightmost 80 characters "hidden".
  614.  
  615. `M>argin     : 0 space LEFT margin on ALL Pages`
  616.  
  617. Permits setting a left margin on all pages, though it may be better to
  618. set the paper to the left in the printer to provide the margin. 
  619. Spaces are written to each line which increases the size of the output
  620. files. The affect may be V>iewed or seen in the bottom "line
  621. display"as "mmmm"s. 
  622.  
  623. `L>inelength : 80 CHARACTERS per Line [ 10 Chars Per Inch ]`
  624.  
  625. No default setting; Dynamically determined by Maximum Linelength;
  626. O>ffset; C>olumn toggle; and M>argin settings. May be increased to
  627. allow greater O>ffsets, M>argins, etc. The "Rule" for dynamic setting
  628. is to set to the largest type/smallest linelength which will suffice.
  629. The 2 column toggle will automatically re-set the linelength.
  630.  
  631. Remember, setting the linelength sets the character pitch of the
  632. printer,  which determines the number of characters that can be
  633. written to a printed line. The size of the typeface may affect the 
  634. acceptable number of lines per page. You may want to re-set that value.
  635.  
  636. `P>agelength : 88 LINES/PAGE [ 8 LPI ] FOR : 11 Pages/6 Sheets`
  637.  
  638. Default is 88 lines for printing to an 11 inch sheet.
  639.  
  640. Choices include 66, 88, or 99 lines/page. The number of pages for a
  641. setting is calculated and displayed. The number of "Sheets" is based
  642. on two-sided printing of text.
  643.  
  644. The printer's type face (as determined by the L>inelength setting, may
  645. limit acceptable choices. Thus, 99 lines of 10 cpi type may look too
  646. crowded while 99 lines at 17 cpi may be acceptable.
  647.  
  648. You may also choose a "pagelength" of less than 66 lines for card files,
  649. etc. You must work out the correct linelength for the various sized
  650. cards, i.e. 2x5,4x6, etc.
  651.  
  652. `I>ndex Tgl. : Off`
  653.  
  654. Default is Off.
  655.  
  656. If toggled on by entering an "I", FANFOLD will write text found
  657. between delimiters, which may be specified; the default is "`" and "`"(Accent 
  658. Grave as opposed to "'" and "'" which are single quotes). Any delimiters
  659. ( both the same or different ) may be chosen, but they should not occur 
  660. otherwise within the text.
  661.  
  662. The text between the delimiters is written both to the bottom of the
  663. screen  during a "Run" and to the <source>.NDX file.
  664.  
  665. After the <source>.ODD and <source>.EVE files are written the "Table
  666. of Contents" is appended to the files from the separate <filename>.NDX
  667. file created during the page writing to file procedure. The Table of
  668. Contents is paginated separately for later physical placement.
  669.  
  670. (Note the "`"s which appear in this DOC as delimiters for examples of
  671. placement in a Source or <source>.FAN file.)
  672.  
  673. The output is a "Table of Contents" rather than an index, the phrases
  674. are indexed by the page within which they appear. If the phrase is in
  675. the second column of two column formatting, a "b" is appended to the
  676. page number.
  677.  
  678. [S]
  679. Thus, "I>index Tgl. : Off" may appear as:
  680.  
  681. FANFLD21.DOC      Table of Contents   Page n of n Pages 
  682.     .
  683.     .
  684.     .
  685.     10b   I>index Tgl. : Off
  686.     etc.
  687. [E]
  688.  
  689. Because the format of a Table of Contents is a subjective choice, the
  690. output is minimal. Use an editor to "fancy up" the output. Note that
  691. the <source>.NDX file is a scratch file which may not be edited with
  692. any effect. Edit the Table  of Contents pages which are appended to
  693. the end of the <source>.ODD/.EVE files.
  694.  
  695. `V>iew       : Scroll 1st 80 columns as formatted`
  696.  
  697. Permits viewing of the text as formatted (right or left edge), with 
  698. headers, offsets, etc. displayed on the screen. The text will scroll 
  699. until any key is entered during a pause prompt. You are then returned to 
  700. the Format Menu. The parameters may be changed and V>iewed as often as 
  701. desired. You may also select any start or end page number to view.
  702.  
  703. `E>xit       : to CP/M with E0:FANFLD21.FAN Saved`
  704.  
  705. Permits exiting from the Format Menu and FANFOLD to CP/M without
  706. writing the formatted files to disk. May be used to permit adjusting
  707. the <source>.FAN with your favorite editor after viewing the results.
  708.  
  709. The display at the bottom of the screen gives a symbolic representation
  710. of a line as it will be written to the <source>.ODD and <source>.EVE
  711. files.
  712. [S]
  713.  
  714.   ODD:  |< text 1..to..78 >| of |80
  715.   EVEN: |< text 1..to..78 >| of |80
  716.  
  717.   | O |= Hole tab : T= 8 sp. tab : m=margin <SP> : |.s.|= Col. Separator
  718.  
  719. [E]
  720.  
  721. The display will change as the various parameters are entered.
  722.  
  723. When  the  formatting is Ok'ed by entering a <R>un, FANFOLD will begin
  724. writing the  odd  and  even  page files (<filename>.ODD  and
  725. <filename>.EVE)  to  the selected  disk. But first you will be asked:
  726.  
  727. `Include Printer setup in Files [Y/N/Exit] >`
  728.  
  729. Default is "Y".
  730.  
  731. Answering "Y" places the CLEAR,CPI,LPI, and Tab commands of the
  732. installed printer at the beginning of the <source>.ODD & <source>.EVE
  733. files for delayed printing with proper printer initialization
  734. included. Simply use your favorite method (TYPE,NEWSWEEP, etc.) to
  735. send text to your printer; sending the <source>.ODD text first. When
  736. complete, turn over the paper in the printer at page 1 and send
  737. <source>.EVE. (Actually, in two sided output you may send either file
  738. first but it seems right to send first things first.)
  739.  
  740. While it is not recommended, you may insert formatting commands in the
  741. <fn>.ODD,.EVE,.NDX files and print the files from within Wordstar, 
  742. NewWord, VDE, etc. Bold and Underlining should work but any changes
  743. to linelength, pagelength, and character pitch could destroy the 
  744. page format.
  745.  
  746. Note: If any installed printer command includes a "^Z" (ASCII 26),
  747. you will NOT be given the option to include the printer commands.  
  748. However, you will be able to print the files from within FANFOLD.
  749. FANFLD21 always sends the installed printer commands before sending
  750. the text to the printer. (See printer installation below.)
  751.  
  752. If FANFOLD is not installed for the printer (See installation below)
  753. the user should answer 'N'  to the "Include Printer commands" question
  754. and preset the printer to the CPI,LPI and Tab commands consistent with
  755. the selected format.
  756.  
  757. Next, you may choose one or two sided output:
  758.  
  759. `Two sided output [Y/N,Exit] ? >`
  760.  
  761. The default is "Y".
  762.  
  763. An answer of "Y" will produce the <>.ODD and <>.EVE files for two
  764. sided printout.  An answer of "N" will result in the entire formatted
  765. output to  be written  to the <source>.ODD file for single sided
  766. printing. No <source>.EVE file will be  created.  The number of sheets
  767. required for printing will be  adjusted  to reflect the single-sided
  768. format.
  769.  
  770. Finally, you may select the start and end page to be processed. Useful
  771. if only a page or two of a long text is needed.
  772.  
  773. When the <source>.ODD/EVE/NDX files have been written the Printing
  774. Menu is displayed and the following prompts are displayed
  775. sequentially:
  776.  
  777. [S]
  778. -------TOS---------
  779. GEMINI 10X/FANFOLD v21.0b Copyright 1/29/90 Ron Rock Sr/Jr Chicago,IL
  780. ---------------------------------------------------------
  781.  
  782. DONE!! Print FANFLD21.ODD first; Turn over at Page 1 and print FANFLD21.EVE
  783.  
  784. Have > 6 Sheets of paper in your Printer.
  785.  
  786. Enter "P" to Print NOW: [Turn DAISYWRITER ON and LOAD PAPER] or
  787. Enter "E" to Exit [ + <CR>] ? >
  788.  
  789. ERASE FANFLD21.FAN/.ODD/.EVE files ? [Y/N +<CR>] >
  790.  
  791. Another file [Y/N/Exit] ? > N
  792.  
  793. -------BOS----------
  794.  
  795. [E]
  796.  
  797. The user has the option of printing the file immediately (if the
  798. printer  has been installed in FANFOLD) or exiting with the
  799. <source>.ODD, <source>.EVE, <source>.NDX and <source>.FAN files
  800. remaining on disk for "Manual" printing later (perhaps after adjusting
  801. the Table of Contents). The user is told the minimum number of sheets
  802. of paper needed for the printout (including the Table of Contents, if
  803. selected).
  804.  
  805. If immediate printing is selected you will be asked to be sure the
  806. paper is LOADED and the PRINTER IS ON as the format commands will be
  807. sent first. The odd pages are printed first; then FANFOLD pauses for
  808. the user to remove the paper turn it over at page one and continue the
  809. printing of the other side. The Table of Contents is printed last on
  810. the corresponding side or sides and page numbered separately as "Page
  811. x of Table of Contents". If page numbering has not been excluded in
  812. formatting, each page will have "Page n of nn Pages" at the bottom
  813. center, corners or top as selected.
  814.  
  815. If you enter "E" for Exit you will be asked:
  816.  
  817. `ERASE FANFLD21.FAN/.ODD/.EVE files ? [Y/N +<CR>] >`
  818.  
  819. If you answer "Y" FANFOLD will erase the FAN/ODD/EVE/NDX files. Useful
  820. if you have printed the files and wish to process another file.
  821.  
  822. `Another file [Y/N/Exit] ? > N`
  823.  
  824. You may continue on with a new <Source> or <Source>.FAN file if you
  825. answer "Y".
  826.  
  827. ---------------------------------------------------------
  828.  
  829. `When things go WRONG `
  830.  
  831. FANFOLD is designed to eliminate possible problems or recover if it
  832. makes sense. For example, the user is asked if the Source file is in
  833. Wordstar format. An answer of "Y","N" or "E" is requested. If a "N" 
  834. is entered FANFOLD will begin by processing the file as a standard
  835. ASCII text. If FANFOLD finds lines greater than 160 characters, it will
  836. pause, close the files and ask if the user wants to continue as though
  837. the source file is a WS file. FANFOLD will then begin again on a
  838. character by character basis rather than line by line.
  839.  
  840. Processing line by line takes only about 1/3 rd as much time as
  841. character  by character. Thus FANFOLD is much faster with standard
  842. ASCII text  files. However, if the file is a WS/NW type file with soft
  843. <CR>'s and spaces FANFOLD convert it to standard ASCII in the FAN
  844. file in about the same amount of time as using another utility to
  845. "unsoft" it.
  846.  
  847. If FANFOLD seems to be "hung up", try <^C>'s. Next try a ^S^C (control
  848. S, control C) several times. If you are not returned to CP/M you must
  849. reset.
  850.  
  851. `FANFOLD quit and I got something about an "F0" error `
  852.  
  853. You just ran out of disk space. Restart FANFOLD after eliminating some
  854. files or redirect the output to another drive with more space. As a
  855. safety feature, FANFOLD will only "read" from a Source file (The
  856. Source File may NOT have an extent of "ODD","EVE" or "NDX" or it may
  857. be lost). 
  858.  
  859. FANFOLD creates FAN, ODD, EVE and NDX files as it proceeds. Roughly 2.5
  860. times the Source file's size is needed for these files. If you have
  861. proceeded to printing, upon completion you have the option of having
  862. FANFOLD erase the created files before exiting.
  863.  
  864. `FANFOLD doesn't seem to accept what I enter ! `
  865.  
  866. FANFOLD sometimes will take a single character and continue...or ask
  867. for  a character or string of characters PLUS a carriage return
  868. "+<CR>". It  will also ignore an "incorrect" entry. For example, at
  869. the formatting menu only a listed character will be accepted. If a
  870. Pagelength of "66, 88  or 99" is requested - a "95" is ignored.
  871.  
  872. `FANFOLD keeps saying that the lines are longer than 160 characters! `
  873.  
  874. Try running the source as a WS/NW type file when prompted. In this
  875. mode (byte by byte processing) FANFOLD will end an input line with the
  876. first space after 150 characters have been read as an input line. It
  877. is good practice to always indicate a maximum linelength to avoid
  878. surprises on printing files.
  879.  
  880. If this occurs after FANFOLD has tried to process the file as a
  881. WordStar(tm) file, you have a non-text file. If the file looks like
  882. ASCII text it may be that at least part of the file was written in a
  883. "non- document" mode i.e. no automatic <CR> at the end of a screen
  884. line and the author did not end a screen line with a <CR> but the rest
  885. of the line did scroll on the screen. The result is lines of more than
  886. 80 characters which may not be "viewable" with some editors. If you
  887. try printing such a file you get run-on lines. Perfect Writer(tm) in
  888. the "Normal" mode rather than the "Fill" mode is a common offender.
  889.  
  890. FANFOLD will indicate the approximate location of the error in its
  891. linecount or the last line V>iewed. Use your favorite editor to locate
  892. and correct with a <CR> insert or process the file as a WS/NW type.
  893. FANFOLD is looking for a hard or soft carriage return to end a line.
  894. Even a simple linefeed is converted into a carriage return to end a
  895. line.
  896.  
  897. `What happened to all the "." (dot) commands ? `
  898.  
  899. FANFOLD will drop any line with a "." in the leftmost position. Can be
  900. used to pre-edit a file to exclude unwanted lines. If for some reason
  901. you wish to retain the dot commands, place a space in the leftmost column
  902. of the line in the Source file. Note that the "dot" commands will return
  903. to the leftmost column in the ".FAN" file if you have eliminated whitespace
  904. in the pre-format menu.
  905.  
  906. `What happens to ^ (control) characters ? `
  907.  
  908. FANFOLD will delete most embedded control characters. Only ^M and ^J
  909. are retained. The ^I (TAB) is converted into a space if the "Delete
  910. whitespace" option is selected. Otherwise up to 8 tabs per line will
  911. be recognized. Since control characters may be seen by the printer as
  912. a printing command, it is best to eliminate them rather than
  913. "discover" them at printout time. Most likely your printer would
  914. ignore the control character since it isn't in a printer recognizable
  915. form i.e. ESC+^B etc.
  916.  
  917. `When things still go WRONG or go RIGHT ! `
  918.  
  919. If you find this program useful and wish to become a registered user,
  920. send your name and address and a donation of $15.00 by check or money
  921. order to:
  922.  
  923. [S]
  924.     Ronald Rock
  925.     316 N. Michigan Ave. #400
  926.     Chicago, IL 60601
  927. [E]
  928.  
  929. A registered user will receive notification of significant updates and
  930. direct mail and/or phone support. Because of the time involved, I will
  931. no longer be  able to respond to inquiries from non-registered users.
  932.  
  933. ------------------------------------------------------
  934. [S]
  935.  
  936. `INSTALLATION `
  937.  
  938. IF YOUR SCREEN DOESN'T LOOK RIGHT YOU MUST RE-INSTALL FOR YOUR
  939. COMPUTER TERMINAL. IF THE PRINTOUT IS NOT CORRECT YOU MUST RE-INSTALL
  940. YOUR PRINTER COMMANDS.
  941.  
  942. FANFLD21.COM has a default or scratch installation of the Gemini 10X
  943. dot matrix printer. Any other printer may be installed.
  944.  
  945. FANFOLD as found in this Library is installed for a KayPro, without
  946. highlighting. With some exceptions, the KayPro emulates the ADM3
  947. terminal. Exceptions: clear to end of screen, clear to end of line,
  948. home cursor, insert line, and delete line.
  949.  
  950. FANFOLD does not use HIGHLIGHTING, REVERSE VIDEO, DIM or UNDERLINING.
  951. However, FANFOLD does utilize the cursor addressing, clear to end of
  952. screen, clear to end of line, home cursor, insert line and delete line.
  953. YOU MUST INSTALL THE TERMINAL COMMANDS BEFORE ANY CHANGES TO THE PRINTER
  954. OR DEFAULT COMMANDS. If you do not, the screen will not be correct.
  955.  
  956. 1. To install FANFLD21.COM just enter "FANTRM21 FANFLD21.COM" and you 
  957.    will be  guided through the Terminal Installation procedure.  
  958.    The following files should be present on a single drive/user 
  959.    area:
  960.  
  961. [S]
  962. (all the files present in FANFLD21.LBR which are not Doc's)
  963. FANFLD21.COM
  964. FANINS21.CHN  (only needed for "INSTALL" (Printer/Default)
  965. FANtrm21.COM  (only needed for Terminal Installation)
  966. FANTRM21.DTA  (only needed for Terminal Installation)
  967. FANTRM21.MSG  (only needed for Terminal Installation) 
  968. [E]
  969.  
  970. Unfortunately, FANFLD21.COM has been changed to a Start: 21A0 End:D180
  971. to provide for the INSTALL option and permit full DU: specification. If
  972. you are installing V.21 you MUST use the "INSTALL" parameter. You may wish
  973. to copy the printer/default commands from eariler versions and have them
  974. handy for the new installation.
  975.  
  976. `TERMINAL/COMPUTER INSTALLATION`
  977.  
  978. If you are NOT running a KAYPRO you MUST install your Terminal
  979. first. 
  980.  
  981. With all the above files on the same DU: enter:
  982.  
  983. A0> FANTRM21 FANFLD21.COM
  984.  
  985. When you are asked what you wish, answer "T".
  986.  
  987. You will be provided a list of terminals which may be installed.
  988.  
  989. IT IS NECESSARY TO INSTALL YOUR TERMINAL AND WRITE THE NEW
  990. FANFLD21.COM FILE BEFORE INSTALLING/CHANGING THE DEFAULT/
  991. PRINTER CODES. IF YOUR TERMINAL HAS NOT BEEN WRITTEN TO THE
  992. FANFLD21.COM FILE, THE DEFAULT/PRINTER MENUS WILL NOT APPEAR
  993. CORRECTLY ON SCREEN. 
  994.    
  995. Enter "FANTRM21 FANFLD21.COM" (be sure to enter the ".COM", extention)
  996. and select Terminal Installation.
  997. Your choices will be:
  998. [S]
  999.                                                                                
  1000. "Choose one of the following terminals:                                         
  1001.                                                                                
  1002.   1) ADDS 20/25/30          12) Kaypro with hilite     23) Soroc new models    
  1003.   2) ADDS 40/60             13) Kaypro, no hilite      24) SSM-UB3             
  1004.   3) ADDS Viewpoint-1A      14) Lear-Siegler ADM-20    25) Tandberg TDV 2215   
  1005.   4) ADM 3A                 15) Lear-Siegler ADM-31    26) Teleray series 10   
  1006.   5) Ampex D80              16) Liberty                27) Teletex 3000        
  1007.   6) ANSI                   17) Morrow MDT-20          28) Televideo 912/920/92
  1008.   7) DEC Rainbow, 8 bit     18) Osborne 1              29) Visual 200          
  1009.   8) Hazeltine 1500         19) Otrona Attache         30) Wyse WY-100/200/300 
  1010.   9) Hazeltine Esprit       20) Qume                   31) Zenith              
  1011.  10) IBM-PC CCP/M b/w       21) RC-855 (ITT)           32) None of the above   
  1012.  11) IBM-PC CCP/M color     22) Soroc 120/Apple CP/M   33) Delete a definition 
  1013.  
  1014. Which terminal? (Enter no. or ^Q to exit):"
  1015. [E]
  1016.  
  1017. If none of the listed terminals are correct, select the "None of
  1018. the Above" and you will be permitted to enter a new terminal
  1019. definition. I suggest you have your terminal manuals handy and 
  1020. check the values for a nearly matching Terminal.
  1021. NOTE: When you enter a command ASCII value, enter a <SPACE> then the
  1022. next value.  The initalization/de-initalization strings may be up to
  1023. 15 values, other command strings may be up to 5. 
  1024.  
  1025. `DEFAULT/PRINTER- Change or Installation`
  1026.  
  1027. 2. Once your terminal has been installed in FANFLD21.COM
  1028.    it will be saved to disk and you will be returned to CP/M. 
  1029.    
  1030.    Using this "new" FANFLD21.COM enter the command line:
  1031.  
  1032.    "FANFLD21 INSTALL". 
  1033.  
  1034.    Check that the named terminal is now correct and follow the 
  1035.    instructions. You may return to the scratch distribution values
  1036.    for the Gemini 10X and default responses by selecting the scratch
  1037.    option. You will lose/overwrite any current printer/default values.
  1038.    Thus, use this option only when you wish to begin from "scratch".
  1039.    You will NOT have to re-install your terminal.  
  1040.  
  1041.    You may change/correct values by stepping through the menus.
  1042.    
  1043.    You may now install your printer commands by following the screen prompts.
  1044.    In general you will be asked for the byte length (in decimal only) of the
  1045.    command for a particular printer function followed by the specific bytes.
  1046.    You may find that the optional ASCII DECIMAL conversion table is helpful.
  1047.    The actual codes must be entered in ASCII DECIMAL format only. Thus
  1048.    an "ESC" code is "27" NOT "1B" etc.,etc.
  1049.    To have the table displayed on-screen answer "Y" to the prompt.
  1050.  
  1051. NOTE: If any of your printer control commands includes a ^Z ( 26 ASCII ),
  1052. you will be warned that the printer code cannot be included in the ODD/EVE
  1053. files for "manual" printing outside of FANFLD and you will NOT be given
  1054. that option.  The ^Z code is the CP/M END OF FILE code and output will cease 
  1055. with the first line of the ODD/EVE file.  FANFLD21 will accept a ^Z and 
  1056. send it to the printer code before sending the ODD/EVE/NDX files.
  1057. If the code is NOT written to the files, printing will proceed.  Very
  1058. few printers require the ^Z command in any string, but one or more do.  It
  1059. may be possible to use an alternate command string for such printers.
  1060.  
  1061. 3. After you have run FANFOLD for a period of time you may wish to alter the
  1062.    Default values. In general, if you find that you almost always change a
  1063.    particular value you may wish to change those values. 
  1064.    Note well - It is not recommended to change the "WS/NW type file ?" default
  1065.    to "Y" even if you usually use FANFOLD on such files. FANFOLD reads a
  1066.    WS/NW type file byte by byte and as a result the processing time is
  1067.    significantly increased. If FANFOLD finds lines without "hard returns"
  1068.    it will prompt for a restart as a WS/NW type source file.
  1069.  
  1070. As an aside, you will find that installing printer commands can be difficult
  1071. since even the manual may not give the proper command string. The problem is
  1072. familiar to those of us who have written printer setup programs. For example
  1073. a command may be given as "<ESC> 32". Is that (in hex) a 2 byte command "1B
  1074. 32" or a 3 byte command <ESC>+"3"+"2" which would be "1B 33 32". Also is a
  1075. "0" a hex 00 or 30 (the hex value of the ASCII number 0)? FANFOLD requires the
  1076. ASCII DECIMAL value of the particular command byte. Systematic trial and error
  1077. may be the only answer.
  1078. [S]
  1079.  
  1080. For your convenience:
  1081. --------------------------------------------------------------------
  1082. (You will need the following PRINTER codes for your printer )
  1083.  
  1084. Current ( ASCII decimal ) FANFOLD Printer Codes:        (scratch area)
  1085.  1.           Printer Name : GEMINI 10X               _______________
  1086.  2.              RESET code:  2 bytes >  27 64        _ _ _ _ _ _ _
  1087.  3.     11 INCH Page Length:  0 bytes >               _ _ _ _ _ _ _
  1088.  4.  10 characters per inch:  3 bytes >  27 66  1     _ _ _ _ _ _ _
  1089.  5.  12 characters per inch:  3 bytes >  27 66  2     _ _ _ _ _ _ _
  1090.  6.  17 characters per inch:  3 bytes >  27 66  3     _ _ _ _ _ _ _
  1091.  7.  20 characters per inch:  3 bytes >  27 66  3     _ _ _ _ _ _ _ *
  1092.  8.       66 lines per page:  2 bytes >  27 50        _ _ _ _ _ _ _
  1093.  9.       88 lines per page:  2 bytes >  27 48        _ _ _ _ _ _ _
  1094. 10.       99 lines per page:  3 bytes >  27 51 16     _ _ _ _ _ _ _
  1095. 11.  11 TABS of 8 <sp> each: 14 bytes >
  1096.                                         * enter 17 cpi if 20 not avail.
  1097.          27 68  9 17 25 33 41 49 57 65 73 81 89  0    _ _ _ _ _ _ _ _
  1098.                                                       _ _ _ _ _ _ _ _
  1099. Choose # to change ( <CR> to Exit) > ~                _ _ _ _ _ _ _ _
  1100.                                                       _ _ _ _ _ _ _ _
  1101.                                                       _ _ _ _ _ _ _ _
  1102.                                                       _ _ _ _ _ _ _
  1103.  
  1104. ____________________________________________________________________
  1105.  
  1106. Current FANFOLD Menu default responses:
  1107.  
  1108.  1.         Is Source a WS/NW type file : N
  1109.  2.       Write output to another Drive : N
  1110.  3.                           Output OK : Y
  1111.  4. Reformat for new Maximum Linelength : Y
  1112.  5.            Max Linelength [1 - 160] : 78
  1113.  6.                  Truncate unaltered : Y  (try "N" here)
  1114.  7.                   Delete whitespace : Y
  1115.  8.                           Carryover : N
  1116.  9.                                Fill : Y
  1117. 10.                             Justify : Y
  1118. 11.                       Flushleft All : Y
  1119. 12.                        View results : Y
  1120. 13.      Include printer setup in Files : Y
  1121. 14.                    Two sided output : N
  1122. 15. Reset "as is" Start Toggle [to 3 chars]  : [S]
  1123. 16.   Reset "as is" End Toggle [to 3 chars]  : [E]
  1124. 17.             Number of Header Lines  : 2
  1125. 18.             Number of Footer Lines  : 3
  1126. 19. Page # in lower M>iddle; C>orners; T>op or N>one : T
  1127.  
  1128. Choose # to change ( <CR> to Exit) > ~
  1129. ______________________________________________________________
  1130.  
  1131. Ronald Rock
  1132. 316 N. Michigan Ave. #400
  1133. Chicago, IL 60601
  1134.  
  1135.                   FANFOLD Registered User Application
  1136.  
  1137. Enclosed is my $15.00 donation. I understand that as a registered user
  1138. I am supporting the use and development of FANFOLD and qualify for direct mail
  1139. and/or phone assistance, notification of significant enhancements and
  1140. posible customization for my particular application. A nominal fee may be
  1141. required for extensive customization.
  1142.  
  1143. Name:__________________________________________
  1144. Address:_______________________________________
  1145. City:___________________ State:__ Zip:_________
  1146.  
  1147. The following is optional information:
  1148.  
  1149. My computer is a ___________________________________;screen width___/lines___.
  1150. My printer is  a ___________________________________
  1151. I do not have TurboPascal ___
  1152. I have Borland's CP/M TurboPascal version #_________
  1153. I have a TPA of _______k as I normally run, with a maximum available ____k TPA.
  1154.  
  1155. If sufficient interest develops to create a FANFOLD BBS, I understand that as a
  1156. Registered User I will have pre-arranged private access to the FANFOLD BBS .
  1157. [E]
  1158.  
  1159. <end of FANFLD21.DOC>
  1160. erstand that as a
  1161. Registered User I will have pre-arranged private ac