home *** CD-ROM | disk | FTP | other *** search
/ The Pier Shareware 6 / The_Pier_Shareware_Number_6_(The_Pier_Exchange)_(1995).iso / 036 / fold341.zip / FOLDADD.DOC < prev    next >
Text File  |  1994-08-27  |  17KB  |  491 lines
  1.  
  2.                                FOLD-and-PRINT
  3.                                 version 3.41
  4.  
  5.                           Appendix to User's Manual
  6.  
  7.                           (C) Konrad Budych 1989-94
  8.  
  9.  
  10.         This appendix does not contain vital information that you need to run
  11. FOLD-and-PRINT.  It contains information that I always hate reading in other
  12. people's manuals.  Please have a look at FOLD.DOC first, and after you have
  13. done that, you may come back here...
  14.  
  15.  
  16.  
  17.  
  18. HOW TO REGISTER FOLD-and-PRINT?
  19. ===============================
  20.  
  21.         FOLD-and-PRINT is not free. The version you are using is meant for
  22. testing. It is 100% fully functional, so you really know what you buy. You may
  23. test this version for a reasonable period of time and then decide: if you want
  24. to use this program regularly, fully, and legally, please register; if not ---
  25. stop using it and delete it from all your disks.
  26.  
  27.         When you register, you will get:
  28.  
  29.         * the latest version of the program if you used the older one;
  30.  
  31.         * a registration key that will make the program stop beeping at you
  32. and saying that you are using unregistered version; this key will work on
  33. future versions of FOLD-and-PRINT too, so you do not have to register again
  34. when any upgrades come out!
  35.  
  36.         * a right of asking questions and making suggestions concerning this
  37. program and you may be sure that these questions and suggestions will not be
  38. ignored if only they reach me...
  39.  
  40.         The single user registration fee is US$20. If you cannot afford so
  41. much, send less, if you can afford more, send more, if you can afford much
  42. more, send much more, and so on. If you want a disk with the latest version,
  43. send at least $20. Use an international money order, a personal cheque, or
  44. cash folded and hidden in an envelope. Credit cards are not accepted. And send
  45. it to the address given below. Please also tell me:
  46.  
  47.         * when and where you have got FOLD-and-PRINT
  48.  
  49.         * what equipment you are using (CPU, RAM, HD, video, printer)
  50.  
  51.         * the size & format of the disk (if you want a disk)
  52.  
  53.         * your address (E-mail & snail mail)
  54.  
  55. If you would like to register more than a few copies of FOLD-and-PRINT,
  56. contact me first for discount information.
  57.  
  58. My snail mail address follows:
  59.  
  60.         Konrad Budych
  61.         os. Zlotego Wieku 43/26
  62.         31-618 Krakow, Poland
  63.  
  64. Internet address (valid until June 1995, maybe longer?):
  65.  
  66.         kbudych@ii.uj.edu.pl
  67.  
  68.  
  69.  
  70.  
  71. DISTRIBUTING FOLD-and-PRINT
  72. ===========================
  73.  
  74.         You may distribute unregistered copies of this program freely in the
  75. original package. You are not allowed to modify contents of the original
  76. package, modify the program itself, or sell it without my permission.
  77.  
  78.         All shareware distributors are granted a right to charge a small fee
  79. for copying and distributing. Their clients must be aware that they do not pay
  80. for the program itself.
  81.  
  82.         This program may be put in a CD ROM shareware collection.
  83.  
  84.  
  85.  
  86.  
  87. ACKNOWLEDGEMENTS
  88. ================
  89.  
  90.         I would like to thank Janusz, Jerzy, Jerzy, and Krzysztof for testing
  91. FOLD-and-PRINT and suggesting some improvements, Piero, George and Jean for
  92. nice words, Tom for his suggestions and his offer, John, Mark, and Nick for
  93. their suggestions.  Special thanks go to Edgar for his suggestions and
  94. 'debugging' the manual (to the version 3.0, all errors in this manual are my
  95. own invention!). Yet another thanks go to Carlos...
  96.  
  97.         Special thanks go to Sheldon for his patience in bug hunting.
  98.  
  99.         THANKS IN UPPERCASE go to all contributors.
  100.  
  101.  
  102.  
  103.  
  104. REVISION HISTORY
  105. ================
  106.  
  107.         The history of FOLD-and-PRINT is long and interesting.
  108.  
  109.  
  110.  
  111.  
  112. VERSIONS 1.0 thru 1.3
  113. ---------------------
  114.  
  115.         The first version of this program was running under CP/M-80.  It was
  116. written in Turbo Pascal 3.0 (!).  There were two parts: one which reformatted
  117. input file into another file; the second part printed that file.  All
  118. necessary parameters had to be entered each time the program was run.  Printer
  119. control codes were located inside the program and could not be changed without
  120. the recompilation of the source code as I used only one printer.
  121.  
  122.         The first part, which created the reformatted file, could also act on
  123. the WordStar 3.0 document files.
  124.  
  125.  
  126.  
  127.  
  128. VERSIONS 2.0A thru 2.0J
  129. -----------------------
  130.  
  131.         The version 2.0 was written with the use of Turbo Vision library in
  132. Turbo Pascal 6.0.  This program was a 'sum' of the previous two.  All
  133. parameters could be set in the program and the configuration could be saved.
  134. Several sets of control codes were still inside the program and only ESC/P
  135. compatible printers could be used.
  136.  
  137.         There was a possibility of printing selected pages and truncating
  138. lines.  An input file still was first formatted into temporary file which was
  139. then printed.  It sometimes took a while to reformat a long text.
  140.  
  141.         A lot of keys has to be pressed to start printing.
  142.  
  143.  
  144.  
  145.  
  146. VERSIONS 2.91 thru 2.98
  147. -----------------------
  148.  
  149.         As I found that I always use only two print modes, I thought of the
  150. separate configuration files for each of them.  A command line utility was the
  151. next idea.  A word wrap looks great when there are broken lines and the text
  152. is not a source code.  Printing separately odd and even pages was necessary as
  153. I started using a printer with the sheet feeder.  Printing each line few times
  154. was a great idea when I was forced to use printers with the very weak ribbons.
  155.  
  156.         FOLD-and-PRINT only reads now an input file: no temporary file is
  157. created.  This saves a lot of time: the page is reformatted and immediately
  158. printed; the program prepares the next page while the previous one is being
  159. printed.  The text is read once if no analyzis is performed, however if you
  160. want to know how many pages the text will have, it has to be read twice and
  161. the text analysis has to be performed.
  162.  
  163.         All necessary printer information is now in the printer definition
  164. file.  This allows (probably) all line printers to be used.
  165.  
  166.         Version 2.91 thru 2.98 were all pre-release versions of 3.0.  They
  167. were not widely distributed, but were still improved.  The suggestion form a
  168. number of people shaped FOLD-and-PRINT into its final form.
  169.  
  170.  
  171.  
  172.  
  173. VERSION 3.0
  174. -----------
  175.  
  176.         This version was the first to be widely distributed.
  177.  
  178.  
  179.  
  180.  
  181. VERSION 3.1
  182. -----------
  183.  
  184.         Here is a list of changes from version 3.0:
  185.  
  186.         * 'd' and 'q' switches have been added for the easier header/footer
  187. defining and printing.
  188.  
  189.         * 'c' switch has been removed as useless and not used (by me...)
  190.  
  191.         * a string of digits is now 'a word' too.  This changed the way
  192. FOLD-and-PRINT breaks lines.
  193.  
  194.         * when non-printable characters are found in a text, their codes are
  195. displayed now.
  196.  
  197.         * 'x' switch added to speed up printing of texts on printers with a
  198. sheet feeder.
  199.  
  200.         * 'g' switch added (set tab width).
  201.  
  202.         * 'r' parameter added to allow page numbering shifts.
  203.  
  204.         * the space fillers have been added to special header/footer symbols
  205. to create left/right-justified, odd/even-page-dependent headers and footers.
  206.  
  207.         * the printer configuration file now can contain comments.
  208.  
  209.  
  210.  
  211.  
  212. VERSION 3.2
  213. -----------
  214.  
  215.         Here is a list of major changes from version 3.1:
  216.  
  217.         * new syntax of .P files
  218.  
  219.         * user's title in headers and footer
  220.  
  221.         * line of hyphens may be printed below/above headers/footer
  222.  
  223.         * separate headers/footers for odd and even pages
  224.  
  225.         * different command line parsing: no switches, one- and two-letter
  226. options, case sensitive options
  227.  
  228.         * 'df' disables headers/footers on page no. 1
  229.  
  230.         * 'qt' asks for a user's title
  231.  
  232.         * 'oo', 'oe', 'ox', 'oa' instead of 'o', 'e', 'x'
  233.  
  234.         * 'tB' and 'tW' cuts off the ends of lines without any text
  235.  
  236.         * switches to remove/ignore control characters
  237.  
  238.         * left and right margins, width can be defined in command line
  239.  
  240.         * bug fix: headers and footers fit within margins
  241.  
  242.         * many minor changes: they are invisible to the user or described in
  243. the manual.
  244.  
  245.  
  246.  
  247.  
  248. VERSION 3.3
  249. -----------
  250.  
  251.         Here is a list of major changes from version 3.2:
  252.  
  253.         * bug fix: sometimes FOLD-and-PRINT printed some lines twice in a
  254. column instead of printing empty lines.  I have never experienced this but
  255. thanks to Sheldon I have managed to fix this...
  256.  
  257.         * when a line is broken all spaces at the beginning of the remaining
  258. part are now removed and the text is left justified; this makes long lines
  259. look as if they were formatted paragraphs
  260.  
  261.         * new '-cs' option to substitute non-printable characters with a '@'
  262.  
  263.         * new '-P' option to specify directory for .P files
  264.  
  265.         * new set of the header/footer special symbols
  266.  
  267.         * first version of TUNF added to the package
  268.  
  269.  
  270.  
  271.  
  272. VERSION 3.4
  273. -----------
  274.  
  275.         Here is a list of major changes from version 3.3:
  276.  
  277.         * options are now read not only from the FOLD environmental variable
  278. but also from FOLD.CFG file; this file is a text file containing options
  279. preceded by either '-' or '/'; lines beginning with ';' are ignored;
  280. FOLD-and-PRINT searches for FOLD.CFG in current directory, FOLD.EXE directory,
  281. and all directories listed in PATH;
  282.  
  283.         * FOLD-and-PRINT searches for printer definition files in current
  284. directory, specified directory ('P' option), FOLD.EXE directory, and all
  285. directories listed in PATH;
  286.  
  287.         * new 'dA' option to disable headers and footers and print text in
  288. the space regained;
  289.  
  290.         * options 'qa' etc. are ignored when headers and footers are disabled;
  291.  
  292.         * spaces are not added at the end of printed lines. This results in
  293. faster printing and shorter files when printing to a file;
  294.  
  295.         * when help screens are displayed, output is paused after a section or
  296. two and program waits for a key press;
  297.  
  298.         * there is no limit of 9 for 'b' option; you can print each line even
  299. 999 times;
  300.  
  301.         * line editing and default input are available when asking for
  302. headers/footers or a title; pressing [ESC] aborts FOLD-and-PRINT;
  303.  
  304.         * some messages and error messages have been changed;
  305.  
  306.         * few minor changes.
  307.  
  308.  
  309.  
  310.  
  311. VERSION 3.41
  312. ------------
  313.  
  314.         There are two changes between version 3.4 and 3.41:
  315.  
  316.         * FOLD-and-PRINT is no longer 'beggarware' but a regular shareware;
  317.  
  318.         * FOLD.EXE is compressed with LZEXE by Fabrice Bellard and
  319. protected against modifications.
  320.  
  321.  
  322.  
  323.  
  324. FUTURE VERSIONS
  325. ---------------
  326.  
  327.         I think it is not history yet, but this is the best place to inform
  328. you about the future (of FOLD-and-PRINT).
  329.  
  330.         I cannot promise that there ever will be any future version of
  331. FOLD-and-PRINT, but I am afraid that there will. I have improved this program
  332. for a couple of years (for a few days each year...), to add something I need,
  333. remove something I dislike, etc. User suggestions are the second source of
  334. changes and improvements.
  335.  
  336.  
  337.  
  338.  
  339. DISCLAIMER
  340. ==========
  341.  
  342.         FOLD-and-PRINT is supplied as is.  The author disclaims all
  343. warranties, expressed or implied, including, without limitation, the
  344. warranties of merchantability and of fitness for any purpose.  The author
  345. assumes no liability for any damages, direct or consequential, which may
  346. result from the use of, or inability to use FOLD-and-PRINT.
  347.  
  348.  
  349.  
  350.  
  351. EXIT CODES AND ERROR MESSAGES
  352. =============================
  353.  
  354.         If you are interested what exit codes FOLD-and-PRINT returns, here is
  355. the brief list:
  356.  
  357.         0 - everything was okay, the text has been printed
  358.         1 - the help screen has been displayed
  359.         2 - there were problems with command line parameters or FOLD variable
  360.         3 - integrity test failed and program was terminated
  361.         4 - there were problems with the printer or configuration file
  362.         5 - there were problems with the input file
  363.         6 - there were problems with the output file or the printer
  364.         9 - [ESC] has been pressed to break
  365.  
  366.         And here you have the list of all possible error messages and the
  367. short descriptions of them:
  368.  
  369.  
  370. Could not perform integrity test
  371.  
  372.         This warning message appears when FOLD-and-PRINT cannot open and/or
  373.         read FOLD.EXE file to check if it has not been changed. Execution is
  374.         not terminated. This warning is very unlikely to happen.
  375.  
  376. Integrity test failed
  377.  
  378.         Every time you start FOLD.EXE it checks if it has not been changed,
  379.         for example by a virus. If the program file is changed you will see
  380.         this message and FOLD-and-PRINT aborts. Get original FOLD.EXE from
  381.         the distribution package and check your system against viruses.
  382.  
  383. Invalid number: -xxx
  384.  
  385.         The number specified after the switch is not a valid decimal number.
  386.         Only one digit is allowed after 'b'.  Negative numbers are allowed
  387.         only after 'r'.  Zero is never allowed.
  388.  
  389. Invalid data in printer definition file 'FILE.EXT'.
  390. Invalid hex code in printer definition file 'FILE.EXT'.
  391. Invalid number in printer definition file 'FILE.EXT'.
  392. Invalid structure of printer definition file 'FILE.EXT'.
  393.  
  394.         The printer configuration file is invalid: contains invalid number of
  395.         entries or/and invalid entries or/and the heading or/and ending is
  396.         missing.  Please refer to the user's manual for the detailed
  397.         description of this file.
  398.  
  399. Invalid tab width.
  400.  
  401.         The tab width set with 'g' must be within the range from 2 to 32.
  402.  
  403. Invalid switch: '-Z'.
  404.  
  405.         The switch ('Z' in the example) is unknown and has no meaning.
  406.  
  407. Margin too large.
  408.  
  409.         The width of the margin is too big in comparison to page width.
  410.  
  411. Missing file name in command line.
  412.  
  413.         You have not given any file name in the command line.  If the name of
  414.         the file you want to print begins with '-', use '-' before.
  415.  
  416. No pages to print.
  417.  
  418.         You have specified an invalid range of pages to print.  For example:
  419.         '-f10 -l5' or '-s1 -oe'.
  420.  
  421. No printable text in input file 'FILE.EXT'.
  422.  
  423.         The file to be printed is empty.  This is detected only in the text
  424.         analysis mode.
  425.  
  426. Non-printable character (ASCII nnn, HEX nn).
  427.  
  428.         The text to print cannot contain control characters. Use 'cs' or 'ci'
  429.         options.
  430.  
  431. Not enough memory to allocate page buffer.
  432.  
  433.         There is not enough memory for FOLD-and-PRINT to work in the specified
  434.         mode. Remove some TSRs and retry.
  435.  
  436. Too long printer control sequence.
  437.  
  438.         The printer control sequences must not be longer than 128 characters.
  439.  
  440. Too many columns specified for this paper width.
  441.  
  442.         The page is too narrow or/and the number of columns is too big.
  443.  
  444. Too many files specified in command line.
  445.  
  446.         You can specify only one file to print in the command line.
  447.  
  448. Too many TABs in line.
  449.  
  450.         Some line contains too many TAB characters to fit in the internal line
  451.         buffer.  Line is too long.
  452.  
  453. Unable to find printer file 'FILE.EXT'.
  454. Unable to open printer file 'FILE.EXT'.
  455.  
  456.         The printer configuration file should be located in the current
  457.         directory, in the FOLD.EXE home directory, in the directory specified
  458.         with 'P' option, or somewhere in your PATH.
  459.  
  460. Unable to open configuration file 'FILE.EXT'.
  461.  
  462.         The FOLD.CFG file has been found but cannot be opened. This error
  463.         should never occur...
  464.  
  465. Unable to open input file 'FILE.EXT'.
  466.  
  467.         The file to be printed is missing or/and has another name.
  468.  
  469. Unable to open output file 'FILE.EXT'.
  470.  
  471.         The output file cannot be opened / created.  This can happen only if
  472.         you tell FOLD-and-PRINT to print to the file.
  473.  
  474. Unable to print.
  475.  
  476.         FOLD-and-PRINT encountered problems with a printer while printing.
  477.  
  478. Abnormal program termination
  479. Divide error
  480. Null pointer assignment
  481.  
  482.         These messages come from the run-time library and should *never*
  483.         appear.  Let me know if they do...  Describe in detail what have you
  484.         done to FOLD-and-PRINT that it stopped this way.
  485.  
  486.  
  487.  
  488.                        End of Appendix to User's Manual
  489.                        ********************************
  490. 
  491.