home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / d / dvips551.zip / DVIPS.ZIP / INSTALLA < prev    next >
Text File  |  1993-02-11  |  10KB  |  226 lines
  1. Installation
  2.  
  3. If dvips has not already been installed on your system, the 
  4. following steps are all that is needed for installation of the program.
  5. After untaring, all installation files are found in this subdirectory.
  6.  
  7. 1. Update Makefile---in particular, the paths.  Everything
  8. concerning dvips can be adjusted in the Makefile.  Make sure
  9. you set key parameters such as the default resolution, and make sure
  10. that the path given for packed pixel files is correct.
  11.  
  12. 2.  Check the file name definitions in MakeTeXPK.  If you don't
  13. have METAFONT installed, you cannot use MakeTeXPK to automatically
  14. generate the fonts; you can, however, modify it to generate pk
  15. fonts from gf fonts if you don't have a full set of pk fonts
  16. but do have a set of gf fonts.  If you don't have that, you should
  17. probably not install MakeTeXPK at all; this will disable automatic
  18. font generation.
  19.  
  20. 3.  Check the configuration parameters in config.ps.  You should
  21. also update the default resolution here (default is set to 400 - this
  22. is found in line 13).  This file is the system-wide configuration 
  23. file that will be automatically installed.  If you are unsure how 
  24. much memory your PostScript printer has, print the following file:
  25.  
  26. %! Hey, we're PostScript
  27. /Times-Roman findfont 30 scalefont setfont 144 432 moveto
  28. vmstatus exch sub 40 string cvs show pop showpage
  29.  
  30. Note that the number returned by this file is the total memory free;
  31. it is often a good idea to tell dvips that the printer has somewhat
  32. less memory.  This is because many programs download permanent macros
  33. that can reduce the memory in the printer.  In general, a memory size
  34. of about 300000 is plenty, since dvips can automatically split
  35. a document if required.  It is unfortunate that PostScript printers with
  36. much less virtual memory still exist.
  37.  
  38. Some systems or printers can dynamically increase the memory available
  39. to a PostScript interpreter; for these systems, a value of one million
  40. works well.
  41.  
  42. 4.  Run make ("make dvips").  Everything should compile smoothly.  
  43. You may need to adjust the compiler options in the Makefile if something 
  44. goes amiss.
  45.  
  46. 5.  Once everything is compiled, make install ("make install").  After 
  47. this is done, you may want to create a configuration file for each 
  48. PostScript printer at your site.
  49.  
  50. 6.  If the font caching is considered a security hole, make the `cache'
  51. directory be something like /tmp/pks, and cron a job to move the
  52. good pk files into the real directory.  Or simply disable this
  53. feature by not installing MakeTeXPK.
  54.  
  55. 7.  Don't forget to install the new vf files and tfm files.  Note
  56. that the tfm files distributed with earlier (pre-5.471) versions
  57. of dvips, and all versions of other PostScript drivers, are different.
  58.  
  59. Diagnosing Problems
  60.  
  61. You've gone through all the trouble of installing dvips, carefully
  62. read all the instructions in this manual, and still can't get something
  63. to work.  This is all too common, and is usually caused by some broken
  64. PostScript application out there.  The following sections provide some
  65. helpful hints if you find yourself in such a situation.
  66.  
  67. In all cases, you should attempt to find the smallest file that causes
  68. the problem.  This will not only make debugging easier, it will also
  69. reduce the number of possible interactions among different parts of the
  70. system.
  71.  
  72. Debug Options
  73.  
  74. The -d flag to dvips is very useful for helping to track down
  75. certain errors.  The parameter to this flag is an integer that tells
  76. what errors are currently being tracked.  To track a certain class of
  77. debug messages, simply provide the appropriate number given below;
  78. if you wish to track multiple classes, sum the numbers of the classes
  79. you wish to track.  The classes are:
  80.  
  81. 1   specials
  82. 2   paths
  83. 4   fonts
  84. 8   pages
  85. 16  headers
  86. 32  font compression
  87. 64  files
  88. 128 memory
  89.  
  90. No Output At All
  91.  
  92. If you are not getting any output at all, even from the simplest
  93. one-character file (for instance, \ \bye),
  94. then something is very wrong.  Practically any file sent to a
  95. PostScript laser printer should generate some output, at the very
  96. least a page detailing what error occurred, if any.  Talk to your
  97. system administrator about downloading a PostScript error handler.
  98. (Adobe distributes a good one called ehandler.ps.)
  99.  
  100. It is possible, especially if you are using non-Adobe PostScript,
  101. that your PostScript interpreter is broken.  Even then it should
  102. generate an error message.  I've tried to work around as many bugs
  103. as possible in common non-Adobe PostScript interpreters, but I'm
  104. sure I've missed a few.
  105.  
  106. If dvips gives any strange error messages, or compilation on your
  107. machine generated a lot of warnings, perhaps the dvips program
  108. itself is broken.  Carefully check the types in dvips.h and
  109. the declarations in the Makefile, and try using the debug options
  110. to determine where the error occurred.
  111.  
  112. It is possible your spooler is broken and is misinterpreting the
  113. structured comments.  Try the -N flag to turn off
  114. structured comments and see what happens.
  115.  
  116. Output Too Small or Inverted
  117.  
  118. If some documents come out inverted or too small, your spooler is not
  119. supplying an end of job indicator at the end of each file.  (This happens
  120. a lot on small machines that don't have spoolers.)  You can
  121. force dvips to do this with the -F flag, but note that this
  122. generates files with a binary character (control-D) in them.  You can
  123. also try using the -s flag to enclose the entire job in a save/restore
  124. pair.
  125.  
  126. Error Messages From Printer
  127.  
  128. If your printer returns error messages, the error message gives very
  129. good information on what might be going wrong.  One of the most common
  130. error messages is bop undefined.  This is caused by old versions
  131. of Transcript and other spoolers that do not properly parse the
  132. setup section of the PostScript.  To fix this, turn off structured
  133. comments with the -N option, but make sure you get your spooling
  134. software updated.
  135.  
  136. Another error message is VM exhausted.  (Some printers indicate
  137. this error by locking up; others quietly reset.)  This is caused by telling
  138. dvips that the printer has more memory than it actually does, and
  139. then printing a complicated document.  To fix this, try lowering the
  140. parameter to m in the configuration file; use the debug option
  141. to make sure you adjust the correct file.
  142.  
  143. Other errors may indicate that the graphics you are trying to include
  144. don't nest properly in other PostScript documents, or any of a number of
  145. other possibilities.  Try the output on a QMS PS-810 or other Adobe
  146. PostScript printer; it might be a problem with the printer itself.
  147.  
  148. 400 DPI Is Used Instead Of 300 DPI
  149.  
  150. This common error is caused by not editing the config.ps file to
  151. reflect the correct resolution for your site.  You can use the debug flags
  152. (-d64) to see what files are actually being read.
  153.  
  154. Long Documents Fail To Print
  155.  
  156. This is usually caused by incorrectly specifying the amount of memory
  157. the printer has in config.ps; see the description above.
  158.  
  159. Including Graphics Fails
  160.  
  161. The reasons why graphics inclusions fail are too numerous to mention.
  162. The most common problem is an incorrect bounding box; read the section
  163. on bounding boxes and check your PostScript file.  Complain very loudly
  164. to whoever wrote the software that generated the file if the bounding
  165. box is indeed incorrect.
  166.  
  167. Another possible problem is that the figure you are trying to include
  168. does not nest properly; there are certain rules PostScript applications
  169. should follow when generating files to be included.  The dvips
  170. program includes work-arounds for such errors in Adobe Illustrator and
  171. other programs, but there are certainly applications that haven't
  172. been tested.
  173.  
  174. One possible thing to try is the -K flag, to strip the comments from
  175. an included figure.  This might be necessary if the PostScript spooling
  176. software does not read the structuring comments correctly.  Use of this
  177. flag will break graphics from some applications, though, since some
  178. applications read the PostScript file from the input stream looking for
  179. a particular comment.
  180.  
  181. Any application which generates graphics output containing raw binary
  182. (not hex) will probably fail with dvips.
  183.  
  184. Can't Find Font Files
  185.  
  186. If dvips complains that it cannot find certain font files, it is
  187. possible that the paths haven't been set up correctly for your system.
  188. Use the debug flags to determine precisely what fonts are being looked
  189. for and make sure these match where the fonts are located on your system.
  190.  
  191. Can't Generate Fonts
  192.  
  193. This happens a lot if either MakeTeXPK hasn't been properly edited
  194. and installed, or if the local installation of METAFONT isn't correct.
  195. If MakeTeXPK isn't properly edited or isn't installed, an error
  196. such as MakeTeXPK not found will be printed on the console.  The
  197. fix is to talk to the person who installed dvips and have them fix
  198. this.
  199.  
  200. If METAFONT isn't found when MakeTeXPK is running, make sure it is installed
  201. on your system.  The person who installed TeX should be able to install
  202. METAFONT easily.
  203.  
  204. If METAFONT runs but generates fonts that are too large (and prints out the
  205. name of each character as well as just a character number), then your
  206. METAFONT base file probably hasn't been made properly.  To make a proper
  207. plain.base, assuming the local mode definitions are contained in
  208. local.mf (on the NeXT, next.mf; on the Amiga, amiga.mf),
  209. type the following command (assuming csh under UNIX):
  210.  
  211. localhost> inimf "plain; input local; dump"
  212.  
  213. Now, copy the plain.base file from the current directory to where
  214. the base files are stored on your system.
  215.  
  216. Note that a preloaded cmbase.base should never be used when creating
  217. fonts, and a program such as cmmf should never exist on the system.
  218. The macros defined in cmbase will break fonts that do not use
  219. cmbase; such fonts include the LaTeX fonts.  Loading the cmbase
  220. macros when they are needed is done automatically and takes less than a
  221. second---an insignificant fraction of the total run time of METAFONT for a
  222. font, especially when the possibility of generating incorrect fonts is
  223. taken into account.  If you create the LaTeX font {\tt circle10,
  224. for instance, with the cmbase macros loaded, the characters will
  225. have incorrect widths.
  226.