home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / oct93 / printer / dvihp.lha / DviHp / DviHp.doc < prev    next >
Text File  |  1993-07-18  |  9KB  |  242 lines
  1.  
  2.             +-------------------------------------------------+
  3.             | DviHp V 1.1, (C) Copyright by Ales Pecnik, 1993 |
  4.             +-------------------------------------------------+
  5.  
  6.  
  7.  
  8.                                  ABSTRACT
  9.                                 ----------
  10.  
  11. DviHp is a printer driver for HP LaserJet (trademark of the Hewlett Packard
  12. Company)  and  compatibile  printers.   It  translates  DVI  files, usually
  13. generated  by  TeX,  to  a code, understood by HP-LJ (PCL - printer control
  14. language).   DviHp  supports  downloading  fonts, which gives you extremely
  15. fast output. It allows you to include IFF ILBM files into your documents.
  16.  
  17.  
  18.                                  COPYRIGHT
  19.                                 -----------
  20.  
  21. DviHp is copyrighted software. All rights reserved.
  22.  
  23.  
  24.                                  SHAREWARE
  25.                                 -----------
  26.  
  27. This  program  is  made available to you through the concept of "Shareware"
  28. which  is  a form of distribution different from the traditional commercial
  29. method.  With shareware, you are able to "try before you buy".
  30.  
  31.  
  32.                                   LICENSE
  33.                                  ---------
  34.  
  35. A  limited,  30 day license is granted to anyone for the express purpose of
  36. program  evaluation only.  Commercial or governmental use is limited to one
  37. person  during this period.  Registration is required for any use after the
  38. expiration of this license.
  39.  
  40.  
  41.                                 DISCLAIMER
  42.                                ------------
  43.  
  44. No  warranties  are  implied  or  expressed  with  regard to the fitness or
  45. merchantability  of  DviHp  for  any  particular  purpose.   All  risks and
  46. damages,  incidental  or  otherwise,  arising  through the use or misuse of
  47. DviHp are entirely at the responsibility of the user.
  48.  
  49. While  considerable  effort  has  been  made to provide you with a reliable
  50. product,  there  is no guarantee that this program is 100% "bug-free".  Any
  51. problems that do arise will be corrected when and if feasible.  Maintenance
  52. releases  will  be made available in order to correct potentially hazardous
  53. malfunctions  within  the  program.   Fixes  for  benign  problems, usually
  54. cosmetic  in  nature,  will  most  likely  be deferred until the next major
  55. release.
  56.  
  57. This  disclaimer does not guarantee future versions of this product.
  58.  
  59.  
  60.                                DISTRIBUTION
  61.                               --------------
  62.  
  63. Distribution is limited to the original shareware distribution archive file
  64. only.   None of the member files may be omitted.  Furthermore, no profit or
  65. other  material  gain  may be realized for distributing DviHp with the sole
  66. exception  of recovery for media, postage and copying fee (not more than 10
  67. US$).   Bundling  DviHp, the distribution archive or any member files, with
  68. any  commercial  product is expressly prohibited, but it may be included in
  69. so  called  disk  libraries with public domain, shareware or otherwise free
  70. programs.
  71.  
  72.  
  73.                              TABLE OF CONTENTS
  74.                             -------------------
  75.  
  76. 1. Installation
  77.  
  78. 2. Running DviHp
  79.  
  80. 3. Special commands
  81.  
  82. 4. Known problems and information about testing
  83.  
  84. 5. Registration
  85.  
  86. 6. Contact address
  87.  
  88.  
  89.  
  90.                               1. INSTALLATION
  91.                              -----------------
  92.  
  93. Put DviHp and its icon in a suitable directory.  Then copy file HP_LJ_DviHp
  94. to   DEVS:Printers  directory  and  select  this  driver  via  Preferences.
  95. HP_LJ_DviHp  is  a  driver  for HP LaserJet and compatibile printers, which
  96. checks  SPECIAL_TRUSTME  flag  (this  flag  is ignored in other 1.3 printer
  97. drivers),  which  is used for printing IFF ILBM files.  If you don't intend
  98. to print IFF files, you may use any other printer driver.
  99.  
  100. DviHp  requires  three  public  domain - shareware packages to run.  Two of
  101. them are libraries (req library version 2 or higher and arp library version
  102. 39  or  higher),  the  third  is a program called "FLIB" and is distributed
  103. within PasTeX (shareware package) by Georg Hessman.
  104.  
  105. If  you  don't  have  these  files,  connect to your nearest Bulletin Board
  106. System  or try to get them from someone who spreads PD software.  Libraries
  107. shouldn't  be  difficult to get at all.  FLIB is included in PasTeX package
  108. and  probably  in  other  TeX packages too, but I haven't tested DviHp with
  109. others.
  110.  
  111.  
  112.                              2. RUNNING DviHp
  113.                             ------------------
  114.  
  115. From CLI / Shell:
  116. ~~~~~~~~~~~~~~~~~
  117. Just type "DviHp". There are no options to be used in a command line.
  118.  
  119. From Workbench:
  120. ~~~~~~~~~~~~~~~
  121. Double click on DviHp's icon.
  122. ---
  123. Then answer the requesters appropriately.
  124.  
  125. Note  for  Shareware  version  users:  Requesters are completely ignored in
  126. shareware  version  of this program.  You can't select which pages to print
  127. (DviHp  will print all of them), you can't choose only even/odd pages (even
  128. and odd pages will be printed), you can't choose number of copies (only one
  129. copy  will  be  printed)  and  you can't select whether DviHp should remove
  130. fonts from memory after it has finished or not (DviHp will remove them).
  131.  
  132. Note:  Fonts used with DviHp should be PK fonts, packed into libraries with
  133. FLIB.   DviHp  is  unable  to  find  or  use fonts in any other form.  Font
  134. libraries should be placed in directory TeX:FontLib, their filenames should
  135. be in form PKxxxx, where xxxx is size (e.g. PK0300, PK0746, PK0329).
  136.  
  137. If  DviHp is unable to find one or more fonts, it will output font name and
  138. size and abort execution.
  139.  
  140.  
  141.                             3. SPECIAL COMMANDS
  142.                            ---------------------
  143.  
  144. DviHp  currently  understands  only one \special command.  This command has
  145. the form:
  146.  
  147.   \special{ifffile=pic.file hsize=300 vsize=300 hoffset=300 voffset=300}
  148.  
  149. This  command  allows  you  to  include  IFF  ILBM  files in your document.
  150. Special  command  MUST start with the "ifffile=" keyword, sequence of other
  151. keywords  may  be  altered.  All keywords except "ifffile=" may be omitted;
  152. default values for hoffset and voffset are 300, for hsize and vsize:
  153. - if hsize and vsize are set to 0 or if these keywords are omitted, default
  154.   values for both are 300,
  155. - if only hsize  or vsize is set to 0  or ommited,  program will  calculate
  156.   the other value so that aspect ratio will be correct.
  157. Values (hsize, vsize, hoffset and voffset) are in dots (1 dot = 1/300").
  158.  
  159. Notices:   hoffset  is  absolute  offset  from  the left edge of the paper,
  160. voffset is relative offset from the current point (it may be negative).
  161.  
  162. If you intend to use IFF ILMB files, you'll need iff library too.
  163.  
  164.  
  165.  
  166.               4. KNOWN PROBLEMS AND INFORMATION ABOUT TESTING
  167.              -------------------------------------------------
  168.  
  169. DviHp was tested on Amiga 2000 with 1 MB RAM and on HP-LaserJet compatibile
  170. printer Epson GQ-3500 with 2 MB RAM.
  171.  
  172. Known  problems:   DVI  files  with  a lot of set/put rule commands may not
  173. print  well (e.g.  some files created with PicTeX) if you have 2 MB or less
  174. of  printer  memory.  You should print these files (pages) with DVIprint, a
  175. part  of  PasTeX  package  by  Georg  Hessman.   If you have problems using
  176. DVIprint with your LaserJet/compatibile printer, use HPLJ-Handler, which is
  177. freeware  (written  by me).  HPLJ-Handler is included in registered version
  178. of DviHp.
  179.  
  180.  
  181.  
  182.                               5. REGISTRATION
  183.                              -----------------
  184.  
  185. 1. Why register?
  186.  
  187. You will be able to select:
  188.       - which pages you want to print,
  189.       - only even/odd pages,
  190.       - number of copies,
  191.       - whether DviHp should remove fonts from memory after it has finished
  192.         or not.
  193.  
  194.  
  195. 2. Payment
  196.  
  197. Please  remit  via  international  or  postal  money  order.   Cheques  are
  198. accepted,  but  if  you're  not from Slovenia please make sure at your bank
  199. FIRST  that  your  cheque  will  be  accepted  by a foreign (Slovene) bank.
  200. Sending cash is allowed, but at your own risk!
  201.  
  202.  
  203. 3. Registration form
  204.  
  205. Registration  form  is  located  in  a  separate  file, "Registration.txt".
  206. Answering  ALL  the questions in that form is required, except those marked
  207. with "opt" (optional).
  208.  
  209.  
  210. 4. Rejected registrations
  211.  
  212. Registrations which:
  213.  
  214. - lack  your signature, 
  215. - don't have a complete list of users enclosed with them (only if you are
  216.   ordering more than one copy, but not for an organization),
  217. - don't have the correct sum written in the "TOTAL" field of registration
  218.   form
  219.  
  220. will  be  returned.   If  you  remit  via  cheque that is not accepted by a
  221. Slovene bank, the cheque and registration will be both returned.
  222.  
  223.  
  224. 5. Registration fee
  225.  
  226. Registration  fee  is  50 US$.  Details about discount rates are printed in
  227. registration  form.  Discounts are available if you are ordering registered
  228. copy for private or non-commercial use.
  229.  
  230.  
  231.                             6. CONTACT ADDRESS
  232.                            --------------------
  233.  
  234. If you wish to register or obtain further information, please write to:
  235.  
  236.               ALES PECNIK
  237.               SKOPSKA 6
  238.               61000 LJUBLJANA
  239.               SLOVENIA
  240.  
  241.      FidoNet: ALES PECNIK, 2:380/102
  242.