home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / compress / pptype.lzh / PPType / PPType.doc < prev    next >
Text File  |  1990-10-08  |  10KB  |  213 lines
  1.  
  2.  
  3.                             PPType 1.1 User Manual
  4.  
  5.                                  Jul 22, 1990
  6.  
  7.  
  8.  
  9. Preface
  10. =======
  11.  
  12.      This program is freeware, this means that you can copy it freely as long
  13. as you don't ask any more money for it than a nominal fee for copying.  If
  14. you want to distribute this program you should keep this document with it.
  15. This program cannot be used for commercial purposes without written permission
  16. from the author.
  17.      If you have suggestions or remarks about this program, or if you find
  18. any bugs, please let me know.
  19.  
  20.      Write to the following address:
  21.  
  22.                                 Nico François
  23.                                 Corbielaan 13
  24.                              3060 Bertem BELGIUM
  25.  
  26.  
  27. Contents
  28. ========
  29.  
  30. 1. An introduction
  31.  
  32. 2. Usage
  33.  
  34.  
  35. 1. An introduction
  36. ==================
  37.  
  38.      Hmmm, PPPrint... yeeeez, enough Ps to make soup out of !  Let's call it
  39. PPType, yeah, that's better :^D
  40.      I have never been able to figure out why I have been unable to find a
  41. simple, yet useful printing program for the Amiga.  Sure, you have all these
  42. powerful text formatters, but they are way too complicated to quickly print
  43. out something.  Almost all the other programs print by dumping everything to
  44. the printer, printing straight over paper perforation instead of sending a
  45. formfeed (euh... including PPMore :-).
  46.      Therefore I thought it was about time somebody wrote a utility to print
  47. out a file that would first of all divide the file up in pages before
  48. printing and maybe even, if at all possibe, print the filename and page
  49. number at the top of each page.  The program should get the pagelength from
  50. preferences, because not everybody has the same type of paper and the tab
  51. size should be user definable (never understood why the ANSI tab is set every
  52. whopping 8 characters, I prefer a much smaller tabsize).  Since nobody else
  53. seems to wanna write this, I decided to do it myself.  Probably needless to
  54. say PPType also loads and prints files crunched with PowerPacker :^)
  55.      If you haven't got PowerPacker you are of course missing one of the main
  56. features of this program.  PowerPacker is available as shareware (up to
  57. version 2.3b) or as a commercial program (version 3.0a).  Order a copy for
  58. $17.50 (Europe) or $20 (outside Europe) from UGA, P.O.Box 881, 3700 AW Zeist,
  59. The Netherlands (only Eurochecks in Dutch Guilders or cash).  The commercial
  60. version offers several enhancements like 40 to 50 times faster crunching and
  61. overlay crunching.
  62.  
  63.  
  64. 2. Usage
  65. ========
  66.  
  67.      PPType will print a file (or files) to the printer or a file, it will
  68. decrunch files crunched with PowerPacker before printing them.  A header can
  69. be printed at the top of each page.  The tabsize is set to 8 by default, but
  70. can be changed.  The filename in the header will not include the path nor will
  71. it have the '.pp' suffix of crunched data files.
  72.      PPType will check the current preferences for pagewidth and pagelength,
  73. so check that these are correct.  Also make sure all the other printer
  74. preferences are set correctly (e.g. correct printer driver) and that the
  75. 'printer.device' and the 'parallel.device' or 'serial.device' (depending on
  76. your printer) are in DEVS:.  If you want to make use of the filerequester you
  77. should also put the 'arp.library' in LIBS:.
  78.  
  79.      PPType can be used in four different ways.
  80.  
  81. - First of all via the CLI or Shell:
  82.  
  83.      If you enter 'PPType ?' you will get a usage template.
  84. You use PPType like this:
  85.  
  86.      PPType [<opts>] [<file|dir>] [[<opts>] <file>...]
  87.  
  88.      With <opts> = [-o<out>] [-c#] [-l#] [-t#] [-a|h|p|n] 
  89.  
  90.      As you can see, PPType accepts multiple filenames on its command line,
  91. you can also use the options between two filenames.  PPType does NOT support
  92. wildcards yet :-(, these will probably be supported in the next version.
  93.      PPType can be made resident so it doesn't have to be loaded every time
  94. you use it, use the ARP ARes command or the AmigaDOS Resident command for
  95. this.  You CAN'T make PPType resident when it is crunched !!  The file is
  96. supplied as an uncrunched command file with the pure bit set.
  97.      If you omit the filename, you will be presented with either a file
  98. prompt or a filerequester (if asl.library or arp.library is available).
  99. Entering PPType with a directory instead of a file as an argument will also
  100. get you a requester, but it will be positioned in the directory you specified.
  101.      If you 'Run' PPType the output will go to a small window PPType will
  102. open.  This way the CLI is free to be used for other things and you won't be
  103. bothered by the output from PPType.  If you are using ConMan or Kickstart 2.0
  104. the window will not be activated and will have no sizing gadget.
  105.  
  106.      Options: (# means a number)
  107.  
  108.      -o<out>   Use this to redirect the output to a file instead of the
  109.                printer.
  110.      -l#       Use this to override the preferences page length.
  111.      -c#       Use this to override the width.
  112.      -t#       Set tabsize used to print. (default 8, max. 16)
  113.  
  114.      The following options are switches that can be toggled:
  115.  
  116.      -h   Switch header on/off, if on, the top two lines of each page are
  117.           used for a header and a blank line.  The header can hold both
  118.           the filename (without the path and the .pp) and the pagenumber.
  119.           When the header is switched off the top two lines will be used
  120.           for text.
  121.      -p   Switch page numbering in the header on/off.
  122.      -n   Switch filename in the header on/off.
  123.      -a   Switch the use of ANSI escape codes to print the header in bold
  124.           on/off.  A header in bold gives a nice effect, but you may want to
  125.           switch this off when output is redirected to a file.
  126.  
  127.      Examples:
  128.  
  129.        o  PPType -h text.doc
  130.  
  131.        Print the file 'text.doc' but do not print a header at the top of each
  132.        page.
  133.  
  134.        o  PPType -o ram:file -l50 -a docs:test.doc -a -t3 ansititle.doc
  135.  
  136.        This will print to 'ram:file' instead of the printer, pages with a
  137.        length of 50 lines will be used.  The first document will have a plain
  138.        header without ansi escape codes, the second file WILL have a bold
  139.        header.  The tabs will be set every 3 characters in the second file.
  140.  
  141.  
  142. - Via the WorkBench:
  143.  
  144.      There are three different ways of using PPType via the workbench:  you
  145. can single click the PPType icon, press the shift key and select multiple
  146. text file icons ending by double clicking the last text file icon (files will
  147. be printed in the same order as they were selected), you can double-click the
  148. PPType icon and enter a filename in the string gadget (or the ARP file
  149. requester) you will be presented with, or if you are using Workbench 2.0 you
  150. can drop an icon on top of the PPType icon.
  151.      There are some preferences you can set with the aid of the WorkBench
  152. tooltypes.  PPType will look for five tooltypes, they should equal ON or OFF
  153. and they are all set to ON by default (except TABSIZE, which should equal a
  154. number).  These tooltypes should be set in the PPType icon, NOT the text file
  155. icons !  (Use 'Info' from the Workbench menu, or 'Information' from the Icons
  156. menu if you are using Workbench 2.0)
  157.  
  158.      o HEADER   Equivalent to the '-h' option above. (e.g. use 'HEADER=OFF')
  159.      o PAGES                      '-p'
  160.      o NAME                       '-n'
  161.      o ANSI                       '-a'
  162.      o TABSIZE  Use this to change the tabsize. (e.g. use 'TABSIZE=3')
  163.  
  164.  
  165. NOTE: - PPType will add '.pp' to the filename when the file wasn't found.
  166.         This is very useful in the WorkBench enviroment: you can make an
  167.         icon for 'text.doc' but name the file 'text.doc.pp'.  Now the
  168.         WorkBench will show an icon with 'text.doc' as name, but if you
  169.         doubleclick it 'text.doc.pp' will be displayed.  (As long as there
  170.         is no 'text.doc' file in the directory !)
  171.       - When PPType makes the pages too long or too short check the PageLength
  172.         in preferences.  Also set the margins as wide as possible (e.g. Left
  173.         Margin 1 and Right Margin 80).
  174.       - A tip: put something like this in your startup-sequence:
  175.           'Alias PPType Run PPType -t3 []'
  176.         This way PPType will always be run as a background task and use tab
  177.         size of 3.  This is the best way to use PPType as a semi-detachable
  178.         program.  The reason I didn't make PPType detach automatically from
  179.         the CLI is that it then could no longer be made resident, and I
  180.         thought it was more useful if it could.
  181.  
  182.  
  183.                       As always, I hope you find this program useful !
  184.  
  185.  
  186.                               PROGRAM HISTORY:
  187.  
  188. *****************************************************************************
  189. VERSION 1.0
  190.  
  191.      First release.
  192.  
  193. *****************************************************************************
  194. VERSION 1.1
  195.  
  196.      No wildcards yet, sorry :(
  197.      Uses the all new powerpacker.library => shorter code :^D
  198.      Starting PPType from the CLI with a directory as an argument now puts
  199.        up the requester positioned in that directory. Extremely useful once
  200.        you get used to this :^)
  201.      If you are running Workbench 2.0 PPType will use the asl.library
  202.        instead of the arp.library (for the filerequester).
  203.  
  204. *****************************************************************************
  205.  
  206. PPType 1.1 written by Nico François (Yes, Nico is my first name :-)
  207.  
  208. (c) 1990 Nico François / PowerPeak
  209.  
  210.                                    //
  211.                        Thanks to \X/ Amiga for being the best computer ever !
  212.  
  213.