home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 2: PC / frozenfish_august_1995.bin / bbs / d09xx / d0928.lha / MiserPrint / MiserPrint.doc < prev    next >
Text File  |  1993-10-07  |  9KB  |  293 lines
  1.  
  2.                             MiserPrint V1.0
  3.  
  4.                    Written by Heinz-Guenter Boettger
  5.                   GUI created with GadToolsBox V2.0c
  6.  
  7.               Comments, suggestions, bug reports etc. to
  8.                   hgb@pool.informatik.rwth-aachen.de
  9.  
  10.     If you like this program and will use it, please send a picture
  11.       postcard from your country or your town with nice stamps to
  12.  
  13.                         Heinz-Guenter Boettger
  14.                            Roermonder Bahn 5
  15.                              41844 Wegberg
  16.                                 Germany
  17.  
  18.  
  19. Disclaimer
  20. ==========
  21. This  software comes with no warranty, either expressed or implied. The
  22. author  is  in no way responsible for any damage or loss that may occur
  23. due  to  direct  or  indirect usage of this software. Use this software
  24. entirely at your own risk.
  25.  
  26. Copyright
  27. =========
  28. This   software   is   freely   distributable,  BUT  all  programs  and
  29. documentation are copyright by Heinz-Guenter Boettger.
  30.  
  31. Distribution
  32. ============
  33. Permission  is  given to include this program in a public archive (such
  34. as  a  BBS,  FTP  site  or  PD library) providing that all parts of the
  35. original distribution are kept intact. These are as follows:
  36.  
  37.     MiserPrint.info
  38.     MiserPrint/MiserPrint
  39.     MiserPrint/MiserPrint.info
  40.     MiserPrint/MiserPrint.doc
  41.     MiserPrint/MiserPrint.doc.info
  42.     MiserPrint/MiserPrint.guide
  43.     MiserPrint/MiserPrint.guide.info
  44.     MiserPrint/Install
  45.     MiserPrint/Install.info
  46.     MiserPrint/env-archive/MiserPrint/MiserPrint.prefs
  47.     MiserPrint/env-archive/MiserPrint/Manual.prefs
  48.     MiserPrint/env-archive/MiserPrint/Listing.prefs
  49.  
  50. No charge may be made for this program, other than a reasonable copying
  51. fee,  and/or  the  price of the media. This fee _must not_ be more than
  52. USá$5 or 5 DM.
  53.  
  54. This  program may not be included or used in commercial programs unless
  55. by written permission from the author.
  56.  
  57. Requirements
  58. ============
  59. MiserPrint requires
  60.  
  61. - an Amiga with Kickstart V37 or higher
  62. - a HP-Deskjet 500
  63.  
  64. I  have  not  tested it but I think that the program will work with the
  65. Hewlett-Packard  500C, 550C, 510 and compatible printers too (e.g. pcl-
  66. printers or other ink-jets).
  67.  
  68. Installation
  69. ============
  70. To  install  MiserPrint, simply copy it to your utilities directory and
  71. the  directory of the preferences files to envarc: or click the Install
  72. icon.
  73.  
  74. Introduction
  75. ============
  76. MiserPrint is a print utility that puts up to 8 normal pages of text on
  77. one  sheet  of  paper.  You are able to save paper and time. MiserPrint
  78. uses  the  small  built-in  fonts  (Courier  and  Letter Gothic) of the
  79. HP-Deskjet printers.
  80.  
  81. Using MiserPrint
  82. ================
  83. MiserPrint  can  be  started from a CLI or from the Workbench. When the
  84. program   starts   up,  the  default  values  will  be  set,  then  the
  85. MiserPrint.prefs  will be read. After that the commandline arguments or
  86. the tool types will be evaluated and the main window will be opened.
  87.  
  88. CLI
  89. ---
  90. To  start  MiserPrint  from CLI simply type its name and the parameters
  91. you  need.  You  can  use '?' to get the template. The program uses the
  92. defaults and the command line options override them.
  93.  
  94. Template:   FILE,USLEGAL/S,USLETTER/S,BLOCK/K/N,COURIER/S,LPI/K/N,
  95.             PFF=PERMITFF/S,PESC=PERMITESC/S,DRAFT/S,LQB=LQBOLD/S,
  96.             DOUBLE/K,HEADER/K,TAB/K/N,SER:/S,TO/K,PREFS/K,NOGUI/S
  97.  
  98. Most of them are switches, who are explained in the `Gadgets' section.
  99.  
  100.     FILE
  101.         The file that you want to print.
  102.  
  103.     BLOCK <n>
  104.         n must be 1, 2 or 4.
  105.  
  106.     LPI <n>
  107.         n must be a number between 8 and 16.
  108.  
  109.     DOUBLE (ON|OFF)
  110.     HEADER (ON|OFF)
  111.         These  flags must be set to ON or OFF. The format of the header
  112.         can be changed in the string gadget of the GUI.
  113.  
  114.     TAB <n>
  115.         n must be a number between 1 and 10.
  116.  
  117.     TO <filename>
  118.         The filename must be a valid AmigaDOS one.
  119.  
  120.     PREFS <filename>
  121.         The filename must include the full path.
  122.  
  123.     NOGUI
  124.         No  window  with  the GUI is opened, only a requester shows you
  125.         the results of the file scan.
  126.  
  127. Workbench
  128. ---------
  129. The  Workbench tool types for Miserprint are:
  130.  
  131.     USLEGAL, USLETTER, BLOCK=<n>, COURIER/S, LPI=<n>, PERMITFF,
  132.     PERMITESC, DRAFT, LQBOLD, DOUBLE=(ON|OFF), HEADER=(ON|OFF),
  133.     TAB=<n>, SER:, TO=<filename>, PREFS=<filename>
  134.  
  135. To start MiserPrint from Workbench
  136. - doubleclick its icon.
  137. - click the text file you wish to print and shift-doubleclick MiserPrint.
  138. - set the project icon of a text to MiserPrint and doubleclick it.
  139.  
  140. More details are in the `CLI' section.
  141.  
  142. Gadgets
  143. -------
  144.  
  145. The Option Gadgets
  146. ------------------
  147.  
  148.     'Papersize'
  149.         With  this  gadget  you  can select the papersize that is used.
  150.         (DIN  A4  is  the  default,  because it is the standard size in
  151.         Germany.)
  152.  
  153.     'Block'
  154.         You can choose between three text arrangements:
  155.         - 1x1: one big block
  156.         - 1x2: two blocks, which are formatted in two columns
  157.         - 2x2: four little blocks, normally four normal pages on one sheet
  158.  
  159.     'Font'
  160.         The HP-Deskjet 500 has two built-in nonproportional fonts:
  161.         - Courier (6 point, 20 cpi)
  162.         - LetterGothic (6 point, 24 cpi)
  163.  
  164.     'LPI'
  165.         A slider gadget allows you to select the lines per inch between
  166.         8 and 16.
  167.  
  168.     The two text gadgets show you the dimensions of one block.
  169.  
  170.     'Formfeed'
  171.         If  this  option  is enabled, the text after a formfeed will be
  172.         printed on a new block.
  173.  
  174.     'ESC'
  175.         With  this option you can print some ANSI-ESC-sequences. I have
  176.         implemented  italics,  underline  and  boldface. The others are
  177.         filtered out.
  178.  
  179.     'Quality'
  180.         Three qualities can be selected:
  181.         - Draft: the fastest print
  182.         - LQ: my favourite mode
  183.         - LQBold: perhaps somebody will use it
  184.  
  185.     'Double'
  186.         This  option  enables the printing on both sides of the sheets,
  187.         so  that you can print 8 normal pages on one sheet (if block is
  188.         set  to  4).  First  the  even  pagenumbers are printed, then a
  189.         requester invites you to rotate the sheets before the odd pages
  190.         are   printed.  If  your  printout  is  redirected  to  a  file
  191.         MiserPrint  saves  the even pagenumbers to <filename>.1 and the
  192.         odd  ones  to  <filename>.2,  you  must  copy the files in this
  193.         sequence to par: or ser: for a later printout.
  194.  
  195.     'Header'
  196.         A  header  will  be  printed on every sheet. You can define the
  197.         look  of  the  header.  It  supports  some  printf- or tex-like
  198.         expressions:
  199.  
  200.         %f      the filename without the path
  201.         %d1     the current date (15-Sep-93)
  202.         %d2     the current date (15.09.93)
  203.         %d3     the current date (09/15/93)
  204.         %t1     the current time (17:25)
  205.         %t2     the current time (05:25 PM)
  206.         %n      the pagenumber
  207.         \hfill  fills  a  line  with spaces until the line has the full
  208.                 length
  209.  
  210.     'Tabsize'
  211.         In this integer gadget you must enter the tabsize of your text,
  212.         otherwise you get a wrong formatted printout.
  213.  
  214. The String Gadgets
  215. ------------------
  216.  
  217.     'Filename'
  218.         You  can  select  a  file  by  clicking  the  getfile  image (a
  219.         filerequester  appears)  or  by  entering  the  filename in the
  220.         string gadget.
  221.  
  222.     'Port'
  223.         The  cycle  gadget  allows  you  to choose between the parallel
  224.         port,  the  serial  port  or  a file. The getfile image and the
  225.         string  gadget  are  only  activ  when  the  printout to a file
  226.         is selected.
  227.  
  228. The Action Gadgets
  229. ------------------
  230.  
  231.     'Edit'
  232.         To  edit  the  file  you  can click this button and the command
  233.         'c:ed <filename>' is executed. You can also set the environment
  234.         variable  EDITOR to your preferable editor. I have done this by
  235.         'setenv EDITOR tools:ed -sticky' to use CygnusEd.
  236.     
  237.     'Info'
  238.         The  file  is  scanned  and a requester shows some informations
  239.         about it.
  240.     
  241.     'Preview'
  242.         A preview window is opened and the last page will be displayed.
  243.         You  can move through the document with the four buttons on the
  244.         top  or  with  the cursor keys. Click the closing gadget or use
  245.         the ESC key to exit the preview.
  246.     
  247.     'Print'
  248.         If this button is clicked, the file will be printed.
  249.  
  250.     The  Info and Print command can be aborted by clicking the closing
  251.     gadget.
  252.  
  253. Menu
  254. ----
  255.  
  256. Project
  257. -------
  258.  
  259.     'Open...'
  260.         This command is used to load an old configuration.
  261.  
  262.     'Save As...'
  263.         You can save your actual configuration with this command.
  264.  
  265.     'About'
  266.         Just try it.
  267.  
  268.     'Quit'
  269.         If  you want to exit the program, execute this command or click
  270.         the closing gadget.
  271.  
  272. Edit
  273. ----
  274.  
  275.     'Reset to defaults'
  276.         My defaults will be used.
  277.  
  278.     'Last Saved'
  279.         Resets the configuration to the last saved one.
  280.  
  281.     'Restore'
  282.         MiserPrint uses the configuration on startup.
  283.  
  284.  
  285. Acknowledgments
  286. ===============
  287. Thanks to the following people:
  288.  
  289. - Matt Dillon for DICE.
  290.  
  291. - Jan  van  den  Baard  for  GadToolsBox,  which  was  used  to design
  292.   MiserPrint's GUI.
  293.