home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / new / text / print / miserprint / miserprint.doc < prev    next >
Text File  |  1995-01-12  |  17KB  |  499 lines
  1.  
  2.                            MiserPrint V1.14
  3.                            ================
  4.  
  5.                      ****************************
  6.                      * This program is GIFTWARE *
  7.                      ****************************
  8.  
  9.                    Written by Heinz-Guenter Boettger
  10.                   GUI created with GadToolsBox V2.0c
  11.  
  12.               Comments, suggestions, bug reports etc. to
  13.                   hgb@pool.informatik.rwth-aachen.de
  14.  
  15.  
  16. 0. Important
  17. ============
  18.  
  19.   *********************************************************************
  20.   *       Starting with release V1.11, MiserPrint is 'Giftware'       *
  21.   *                                                                   *
  22.   * If  you like this program and will use it, you should consider to *
  23.   * send  me  a  litte (or big ;-) donation for my work (please don't *
  24.   * send cheques or money orders). If you can't afford to send me any * 
  25.   * donation you can write a picture postcard to                      *
  26.   *                                                                   *
  27.   *                      Heinz-Guenter Boettger                       *
  28.   *                         Roermonder Bahn 5                         *
  29.   *                           41844 Wegberg                           *
  30.   *                              Germany                              *
  31.   *********************************************************************
  32.  
  33. 0.1. Disclaimer
  34. ===============
  35. This  software comes with no warranty, either expressed or implied. The
  36. author  is  in no way responsible for any damage or loss that may occur
  37. due  to  direct  or  indirect usage of this software. Use this software
  38. entirely at your own risk.
  39.  
  40. 0.2. Copyright
  41. ==============
  42. This   software   is   freely   distributable,  BUT  all  programs  and
  43. documentation are copyright by Heinz-Guenter Boettger.
  44.  
  45. 0.3. Distribution
  46. =================
  47. Permission is given to include this program in a public archive (such as
  48. a BBS, FTP site or PD library (disk and CD-ROM versions)) providing that
  49. all  parts  of  the  original distribution are kept intact. These are as
  50. follows:
  51.  
  52.     MiserPrint.info
  53.     MiserPrint/MiserPrint
  54.     MiserPrint/MiserPrint.info
  55.     MiserPrint/MiserPrint.doc
  56.     MiserPrint/MiserPrint.doc.info
  57.     MiserPrint/MiserPrint.guide
  58.     MiserPrint/MiserPrint.guide.info
  59.     MiserPrint/Install
  60.     MiserPrint/Install.info
  61.     MiserPrint/env-archive/MiserPrint/MiserPrint.prefs
  62.     MiserPrint/env-archive/MiserPrint/Manual.prefs
  63.     MiserPrint/env-archive/MiserPrint/Listing.prefs
  64.     MiserPrint/Icons.info
  65.     MiserPrint/Icons/MiserPrint_DG.info
  66.     MiserPrint/Icons/MiserPrint_PP.info
  67.  
  68. No charge may be made for this program, other than a reasonable copying
  69. fee,  and/or  the  price of the media. This fee _must not_ be more than
  70. US $3 or DM 4 for floppy disks and US 35$ or DM 50 for CD-ROMs.
  71.  
  72. Finally  if  you  wish to include MiserPrint on a disk magazine you are
  73. REQUIRED  to  get  the  author's  permission  FIRST.  Usually this will
  74. require  you  to  just  send  me  a  copy  of  the issue which contains
  75. MiserPrint free of charge.
  76.  
  77. This program may not be included or used in commercial programs unless
  78. by written permission from the author.
  79.  
  80. 1. Requirements
  81. ===============
  82. MiserPrint requires
  83.  
  84. - an Amiga with Kickstart V37 or higher
  85. - any printer that is _compatible_ to a Hewlett-Packard Deskjet 500
  86.  
  87. The  program  should work fine with the Hewlett-Packard Deskjet series
  88. and compatible printers too (e.g. PCL-printers or other ink-jets).
  89.  
  90. I have tested MiserPrint with a HP Deskjet 500.
  91.  
  92. 2. Installation
  93. ===============
  94. To  install  MiserPrint, simply copy it to your utilities directory and
  95. the  directory of the preferences files to envarc: or click the Install
  96. icon.
  97.  
  98. Denis  Galiana  and Peter Popanda sent me some icons. You can find them
  99. in the 'Icons' drawer.
  100.  
  101. 3. Introduction
  102. ===============
  103. MiserPrint is a print utility that puts up to 8 normal pages of text on
  104. one  sheet  of  paper.  You are able to save paper and time. MiserPrint
  105. uses  the  small  built-in  fonts  (Courier  and  Letter Gothic) of the
  106. HP-Deskjet or compatible printers.
  107.  
  108. 4. Using MiserPrint
  109. ===================
  110. MiserPrint  can  be  started  from a CLI or from the Workbench. When the
  111. program  starts  up,  the default values are set and MiserPrint.prefs is
  112. read.  After  that  the  commandline  arguments  or  the  tool types are
  113. evaluated and the main window is opened.
  114.  
  115. MiserPrint  tries to add an AppWindow if you are running the Workbench.
  116. An  AppIcon  is  also  available (see ICONIFY in the CLI section or the
  117. 'Iconify' command in the project menu).
  118.  
  119. 4.1. CLI
  120. --------
  121. To  start  MiserPrint  from CLI simply type its name and the parameters
  122. you  need.  You  can  use '?' to get the template. The program uses the
  123. defaults and the command line options override them.
  124.  
  125. Template:   FILE,ICONIFY/S,USLEGAL/S,USLETTER/S,BLOCK/K/N,COURIER/S,
  126.             LPI/K/N,PFF=PERMITFF/S,PESC=PERMITESC/S,DRAFT/S,
  127.             LQB=LQBOLD/S,DOUBLE/K,HEADER/K,FOOTER/K,SEPERATE/K,
  128.             BN=BLOCKNUMBER/K,TAB/K/N,TO/K,PREFS/K,PT=PRINTERTYPE/K,
  129.             ICONX/K/N,ICONY/K/N,WINDOWX/K/N,WINDOWY/K/N
  130.  
  131. Most  of  them  are  switches,  which  are  explained  in the `Gadgets'
  132. section.
  133.  
  134.     FILE
  135.         The file that you want to print.
  136.  
  137.     ICONIFY
  138.         The  main window is not opened, only an appicon is displayed on
  139.         the  workbench.  Doubleclick  it and the main window is opened.
  140.         Drop  another  icon  on top of it, the window is opened and you
  141.         get the new filename in the string gadget.
  142.  
  143.     BLOCK <n>
  144.         n must be 1, 2 or 4.
  145.  
  146.     LPI <n>
  147.         n must be a number between 8 and 16.
  148.  
  149.     DOUBLE (ON|OFF)
  150.     HEADER (ON|OFF)
  151.     FOOTER (ON|OFF)
  152.     SEPERATE (ON|OFF)
  153.     BLOCKNUMBER (ON|OFF)
  154.         These  flags must be set to ON or OFF. The format of the header
  155.         and the footer can be changed in the string gadget of the GUI.
  156.  
  157.     TAB <n>
  158.         n must be a number between 1 and 10.
  159.  
  160.     TO <filename>
  161.         The filename must be a valid AmigaDOS one.
  162.  
  163.     PREFS <filename>
  164.         The filename must include the full path.
  165.     
  166.     PRINTERTYPE (HP_DESKJET|OTHER_INKJET)
  167.         Set the printer type to HP_DESKJET if your printer is a Hewlett
  168.         Packard. The printer takes the sheets from the bottom.
  169.         Other inkjets have a different paper feeding from the top side.
  170.         For  this reason the sequence of printing is wrong and you have
  171.         to change the type to OTHER_INKJET.
  172.  
  173.     ICONX <ix>
  174.     ICONY <iy>
  175.     WINDOWX <wx>
  176.     WINDOWY <wy>
  177.         The  position  of the the appicon and the main window. The icon
  178.         coordinates  of the commandline or tooltypes parameters and the
  179.         actual position of the window is saved to your prefs file.
  180.  
  181. 4.2. Workbench
  182. --------------
  183. The  Workbench tool types for Miserprint are:
  184.  
  185.     ICONIFY, USLEGAL, USLETTER, BLOCK=<n>, COURIER, LPI=<n>,
  186.     PERMITFF, PERMITESC, DRAFT, LQBOLD, DOUBLE=(ON|OFF),
  187.     HEADER=(ON|OFF), FOOTER=(ON|OFF), SEPERATE=(ON|OFF),
  188.     BLOCKNUMBER=(ON|OFF), TAB=<n>, TO=<filename>, PREFS=<filename>,
  189.     PRINTERTYPE=(HP_DESKJET|OTHER_INKJET), ICONX=<ix>, ICONY=<iy>,
  190.     WINDOWX=<wx>, WINDOWY=<wy>
  191.  
  192. To start MiserPrint from Workbench
  193. - doubleclick its icon.
  194. - click the text file you wish to print and shift-doubleclick MiserPrint.
  195. - set the project icon of a text to MiserPrint and doubleclick it.
  196.  
  197. More details are in the `CLI' section.
  198.  
  199. 4.3. Gadgets
  200. ------------
  201.  
  202. The Option Gadgets
  203. ------------------
  204.  
  205.     'Papersize'
  206.         With  this  gadget  you  can select the papersize that is used.
  207.         (DIN  A4  is  the  default,  because it is the standard size in
  208.         Germany.)
  209.  
  210.     'Block'
  211.         You can choose between three text arrangements:
  212.         - 1x1: one big block
  213.         - 1x2: two blocks, which are formatted in two columns
  214.         - 2x2: four little blocks, normally four normal pages on one sheet
  215.  
  216.     'Font'
  217.         The HP-Deskjet 500 has two built-in nonproportional fonts:
  218.         - Courier (6 point, 20 cpi)
  219.         - LetterGothic (6 point, 24 cpi)
  220.  
  221.     'LPI'
  222.         A slider gadget allows you to select the lines per inch between
  223.         8 and 16.
  224.  
  225.     The  two text gadgets 'Lines' a