home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 2: PC / frozenfish_august_1995.bin / bbs / d09xx / d0978.lha / MiserPrint / MiserPrint.doc < prev    next >
Text File  |  1994-04-03  |  13KB  |  402 lines
  1.  
  2.                            MiserPrint V1.11
  3.                            ================
  4.  
  5.                    Written by Heinz-Guenter Boettger
  6.                   GUI created with GadToolsBox V2.0c
  7.  
  8.               Comments, suggestions, bug reports etc. to
  9.                   hgb@pool.informatik.rwth-aachen.de
  10.  
  11.  
  12. 0. Important
  13. ============
  14.  
  15.   *********************************************************************
  16.   *       Starting with release V1.11, MiserPrint is 'Giftware'       *
  17.   *                                                                   *
  18.   * If  you like this program and will use it, you should consider to *
  19.   * send  me  a  litte (or big ;-) donation for my work (please don't *
  20.   * send cheques or money orders). If you can't afford to send me any * 
  21.   * donation you can write a picture postcard to                      *
  22.   *                                                                   *
  23.   *                      Heinz-Guenter Boettger                       *
  24.   *                         Roermonder Bahn 5                         *
  25.   *                           41844 Wegberg                           *
  26.   *                              Germany                              *
  27.   *********************************************************************
  28.  
  29. 0.1. Disclaimer
  30. ===============
  31. This  software comes with no warranty, either expressed or implied. The
  32. author  is  in no way responsible for any damage or loss that may occur
  33. due  to  direct  or  indirect usage of this software. Use this software
  34. entirely at your own risk.
  35.  
  36. 0.2. Copyright
  37. ==============
  38. This   software   is   freely   distributable,  BUT  all  programs  and
  39. documentation are copyright by Heinz-Guenter Boettger.
  40.  
  41. 0.3. Distribution
  42. =================
  43. Permission is given to include this program in a public archive (such as
  44. a BBS, FTP site or PD library (disk and CD-ROM versions)) providing that
  45. all  parts  of  the  original distribution are kept intact. These are as
  46. follows:
  47.  
  48.     MiserPrint.info
  49.     MiserPrint/MiserPrint
  50.     MiserPrint/MiserPrint.info
  51.     MiserPrint/MiserPrint.doc
  52.     MiserPrint/MiserPrint.doc.info
  53.     MiserPrint/MiserPrint.guide
  54.     MiserPrint/MiserPrint.guide.info
  55.     MiserPrint/Install
  56.     MiserPrint/Install.info
  57.     MiserPrint/env-archive/MiserPrint/MiserPrint.prefs
  58.     MiserPrint/env-archive/MiserPrint/Manual.prefs
  59.     MiserPrint/env-archive/MiserPrint/Listing.prefs
  60.     MiserPrint/OtherIcon/MiserPrint.info
  61.  
  62. No charge may be made for this program, other than a reasonable copying
  63. fee,  and/or  the  price of the media. This fee _must not_ be more than
  64. USá$5 or 5 DM for floppy disks.
  65.  
  66. This  program may not be included or used in commercial programs unless
  67. by written permission from the author.
  68.  
  69. 1. Requirements
  70. ===============
  71. MiserPrint requires
  72.  
  73. - an Amiga with Kickstart V37 or higher
  74. - a HP-Deskjet 500
  75.  
  76. The  program  should work fine with the Hewlett-Packard 500C, 550C, 510
  77. and compatible printers too (e.g. PCL-printers or other ink-jets).
  78.  
  79. 2. Installation
  80. ===============
  81. To  install  MiserPrint, simply copy it to your utilities directory and
  82. the  directory of the preferences files to envarc: or click the Install
  83. icon.
  84.  
  85. Denis Galiana sent me another icon that you can find in the 'OtherIcon'
  86. drawer.
  87.  
  88. 3. Introduction
  89. ===============
  90. MiserPrint is a print utility that puts up to 8 normal pages of text on
  91. one  sheet  of  paper.  You are able to save paper and time. MiserPrint
  92. uses  the  small  built-in  fonts  (Courier  and  Letter Gothic) of the
  93. HP-Deskjet printers.
  94.  
  95. 4. Using MiserPrint
  96. ===================
  97. MiserPrint  can  be  started  from a CLI or from the Workbench. When the
  98. program  starts  up,  the default values are set and MiserPrint.prefs is
  99. read.  After  that  the  commandline  arguments  or  the  tool types are
  100. evaluated and the main window is opened.
  101.  
  102. 4.1. CLI
  103. --------
  104. To  start  MiserPrint  from CLI simply type its name and the parameters
  105. you  need.  You  can  use '?' to get the template. The program uses the
  106. defaults and the command line options override them.
  107.  
  108. Template:   FILE,USLEGAL/S,USLETTER/S,BLOCK/K/N,COURIER/S,LPI/K/N,
  109.             PFF=PERMITFF/S,PESC=PERMITESC/S,DRAFT/S,LQB=LQBOLD/S,
  110.             DOUBLE/K,HEADER/K,FOOTER/K,SEPERATE/K,BN=BLOCKNUMBER/K,
  111.             TAB/K/N,TO/K,PREFS/K
  112.  
  113. Most  of  them  are  switches,  which  are  explained  in the `Gadgets'
  114. section.
  115.  
  116.     FILE
  117.         The file that you want to print.
  118.  
  119.     BLOCK <n>
  120.         n must be 1, 2 or 4.
  121.  
  122.     LPI <n>
  123.         n must be a number between 8 and 16.
  124.  
  125.     DOUBLE (ON|OFF)
  126.     HEADER (ON|OFF)
  127.     FOOTER (ON|OFF)
  128.     SEPERATE (ON|OFF)
  129.     BLOCKNUMBER (ON|OFF)
  130.         These  flags must be set to ON or OFF. The format of the header
  131.         and the footer can be changed in the string gadget of the GUI.
  132.  
  133.     TAB <n>
  134.         n must be a number between 1 and 10.
  135.  
  136.     TO <filename>
  137.         The filename must be a valid AmigaDOS one.
  138.  
  139.     PREFS <filename>
  140.         The filename must include the full path.
  141.  
  142. 4.2. Workbench
  143. --------------
  144. The  Workbench tool types for Miserprint are:
  145.  
  146.     USLEGAL, USLETTER, BLOCK=<n>, COURIER, LPI=<n>, PERMITFF,
  147.     PERMITESC, DRAFT, LQBOLD, DOUBLE=(ON|OFF), HEADER=(ON|OFF),
  148.     FOOTER=(ON|OFF), SEPERATE=(ON|OFF), BLOCKNUMBER=(ON|OFF),
  149.     TAB=<n>, TO=<filename>, PREFS=<filename>
  150.  
  151. To start MiserPrint from Workbench
  152. - doubleclick its icon.
  153. - click the text file you wish to print and shift-doubleclick MiserPrint.
  154. - set the project icon of a text to MiserPrint and doubleclick it.
  155.  
  156. More details are in the `CLI' section.
  157.  
  158. 4.3. Gadgets
  159. ------------
  160.  
  161. The Option Gadgets
  162. ------------------
  163.  
  164.     'Papersize'
  165.         With  this  gadget  you  can select the papersize that is used.
  166.         (DIN  A4  is  the  default,  because it is the standard size in
  167.         Germany.)
  168.  
  169.     'Block'
  170.         You can choose between three text arrangements:
  171.         - 1x1: one big block
  172.         - 1x2: two blocks, which are formatted in two columns
  173.         - 2x2: four little blocks, normally four normal pages on one sheet
  174.  
  175.     'Font'
  176.         The HP-Deskjet 500 has two built-in nonproportional fonts:
  177.         - Courier (6 point, 20 cpi)
  178.         - LetterGothic (6 point, 24 cpi)
  179.  
  180.     'LPI'
  181.         A slider gadget allows you to select the lines per inch between
  182.         8 and 16.
  183.  
  184.     The  two text gadgets 'Lines' and 'Cols' show you the dimensions of
  185.     one block.
  186.     
  187.     'Select Pages'
  188.         After  a  file  scan  you are able to select the first and last
  189.         page  that  you  want to print. The text gadget below shows the
  190.         first  and last page (you can't see the last digit, if you want
  191.         to print the pages 1000 - 9999 :-).
  192.  
  193.     'Formfeed'
  194.         If this option is enabled, the text after a formfeed is printed
  195.         on a new block.
  196.  
  197.     'ESC'
  198.         With  this option you can print some ANSI-ESC-sequences. I have
  199.         implemented  italics,  underline  and  boldface. The others are
  200.         filtered out.
  201.  
  202.     'Quality'
  203.         Three qualities can be selected:
  204.         - Draft: the fastest print
  205.         - LQ: my favourite mode
  206.         - LQBold: perhaps somebody will use it
  207.  
  208.     'Double'
  209.         This  option  enables the printing on both sides of the sheets,
  210.         so  that you can print 8 normal pages on one sheet (if block is
  211.         set  to  4).  First  the  even  pagenumbers are printed, then a
  212.         requester invites you to rotate the sheets before the odd pages
  213.         are   printed.  If  your  printout  is  redirected  to  a  file
  214.         MiserPrint  saves  the even pagenumbers to <filename>.1 and the
  215.         odd  ones  to  <filename>.2,  you  must  copy the files in this
  216.         sequence  to par: or ser: for a later printout. Don't copy them
  217.         to prt:!!!
  218.  
  219.     'Tab'
  220.         The  'getline'  function  of MiserPrint exchanges the tabs with
  221.         the  number  of  spaces  you entered in the tab gadget, because
  222.         MiserPrint  can't  use the tabulators of the printer. Otherwise
  223.         you get a wrong formatted printout.
  224.  
  225.     'Header'
  226.     'Footer'
  227.         A  header  or  footer  will  be printed on every sheet. You can
  228.         define  the  look of them. It supports some printf- or tex-like
  229.         expressions:
  230.  
  231.         %f      the filename without the path
  232.         %d1     the current date (15-Sep-93)
  233.         %d2     the current date (15.09.93)
  234.         %d3     the current date (09/15/93)
  235.         %t1     the current time (17:25)
  236.         %t2     the current time (05:25 PM)
  237.         %n      the pagenumber
  238.         \hfill  fills  a  line  with spaces until the line has the full
  239.                 length
  240.  
  241.         Examples:
  242.         
  243.         "%f \hfill %n"
  244.         "%f \hfill %d1 \hfill %t1 \hfill %n"
  245.         "\hfill - %n - \hfill"
  246.         "\hfill %n"
  247.  
  248.     'Seperate'
  249.         You  can  print a thin horizontal line between the blocks. This
  250.         option can only be used with the 2x2 blocks.
  251.  
  252.     'Block #'
  253.         On  the  bottom  of each block the number of this block will be
  254.         printed.
  255.  
  256. The String Gadgets
  257. ------------------
  258.  
  259.     'Filename'
  260.         You  can  select  a  file  by  clicking  the  getfile  image (a
  261.         filerequester  appears)  or  by  entering  the  filename in the
  262.         string gadget.
  263.  
  264.     'Port'
  265.         The  cycle  gadget allows you to print directly to your printer
  266.         (your  printer  preferences are used) or to a file. The getfile
  267.         image  and  the  string gadget are only activ when the printout
  268.         to a file is selected.
  269.  
  270. The Action Gadgets
  271. ------------------
  272.  
  273.     'Edit'
  274.         To  edit  the  file  you  can click this button and the command
  275.         'c:ed <filename>' is executed. You can also set the environment
  276.         variable  EDITOR to your preferable editor. I have done this by
  277.         'setenv EDITOR tools:ed -sticky' to use CygnusEd.
  278.     
  279.     'FileInfo'
  280.         The  file  is  scanned  and a requester shows some informations
  281.         about it.
  282.     
  283.     'Preview'
  284.         A  preview window is opened and the last page is displayed. You
  285.         can  move through the document with the four buttons on the top
  286.         or  with  the  cursor keys. Click the closing gadget or use the
  287.         ESC key to exit the preview.
  288.     
  289.     'Print'
  290.         If this button is clicked, the file will be printed.
  291.  
  292.     The  'FileInfo'  and 'Print' command can be aborted by clicking the
  293.     closing gadget.
  294.  
  295.     MiserPrint  doesn't  copy  the  whole file to memory but stores the
  296.     file  positions of the pages in a list. I chose this method to save
  297.     memory.
  298.  
  299. 4.4. Menu
  300. ---------
  301.  
  302. Project
  303. -------
  304.  
  305.     'Open...'
  306.         This command is used to load an old configuration.
  307.  
  308.     'Save As...'
  309.         You can save your actual configuration with this command.
  310.  
  311.     'About'
  312.         Just try it.
  313.  
  314.     'Quit'
  315.         If  you want to exit the program, execute this command or click
  316.         the closing gadget.
  317.  
  318. Edit
  319. ----
  320.  
  321.     'Reset to defaults'
  322.         My defaults are used.
  323.  
  324.     'Last Saved'
  325.         Resets the configuration to the last saved one.
  326.  
  327.     'Restore'
  328.         MiserPrint uses the configuration on startup.
  329.  
  330. 5. Acknowledgments
  331. ==================
  332. Thanks to the following people:
  333.  
  334. - Matt Dillon for DICE.
  335.  
  336. - Jan  van  den  Baard  for  GadToolsBox,  which  was  used  to  design
  337.   MiserPrint's GUI.
  338.  
  339. - The  users  of MiserPrint who send me bug reports or suggestions.
  340.   Thanks for your picture postcards or letters.
  341.  
  342. - Alexander Aulbach for beta testing and some good ideas.
  343.  
  344. - Denis Galiana for beta testing, some ideas and the nice icon ;-)
  345.  
  346. - Peter Simons for mailing me some mungwall and enforcer hits.
  347.  
  348. 6. History
  349. ==========
  350.  
  351. V1.0    First release.
  352.  
  353. V1.01   There was a bug in the requester of the doublesided printout.
  354.         (bug report: Alexander Aulbach and Ulrich Zukowski)
  355.  
  356. V1.10   NOT RELEASED!
  357.  
  358.         Removed the 'Really quit MiserPrint???' requester.
  359.     
  360.         I  forgot  to  take an empty page of paper, if you selected the
  361.         double  mode  and  there  was  an odd number of pages. For this
  362.         reason the sequence of the printout was wrong.
  363.         (bug report: Ulrich Zukowski)
  364.         
  365.         If  you  click  the  formfeed or double gadget the file will be
  366.         scanned the next time again.
  367.         (bug report and suggestion: Ulrich Zukowski)
  368.         
  369.         MiserPrint  uses the 'printer.device'. There is a timeout, e.g.
  370.         if your printer is offline or out of paper. You are able to use
  371.         a printer spooler.
  372.         (suggestion: Alexander Aulbach)
  373.         
  374.         I  changed  the  print  functions,  so  that  you  can abort it
  375.         quicker.
  376.         
  377.         The ANSI-ESC-sequence "<esc>[0m" selects the normal font.
  378.         (suggestion: Ulrich Zukowski)
  379.         
  380.         Have  you ever tried to print some underlined lines? The result
  381.         wasn't nice. I corrected these functions.
  382.         
  383.         Now you can print a footer.
  384.         (suggestion: Denis Galiana)
  385.         
  386.         MiserPrint stores its data in an IFF file, but it reads the old
  387.         configuration files too.
  388.         
  389.         You are able to choose the pages you want to (re)print.
  390.         (suggestion: Denis Galiana)
  391.  
  392.         A  horizontal  seperation line and the number of each block can
  393.         be printed.
  394.         (suggestion: Marcel DuruflΘ)
  395.  
  396. V1.11   Removed the 'NOGUI' switch in the CLI. Has anybody used it???
  397.         
  398.         I found a bug in the IFF read function and removed it.
  399.  
  400.         There were one mungwall and two enforcer hits in a beta version.
  401.         (bug report: Peter Simons)
  402.