home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 2: PC / frozenfish_august_1995.bin / bbs / d03xx / d0368.lha / Lila / Lila.doc < prev    next >
Text File  |  1990-08-15  |  4KB  |  107 lines
  1. #      #  ##
  2. #          #      
  3. #     ##   #   ###    Postscript Utility
  4. #      #   #      #
  5. #      #   #   ####   Version 8912a
  6. #      #   #  #   #
  7. ##### ### ###  ####   Written by Bertrand Gros
  8.  
  9. Lila is a shareware utility that allows you to print listings or 
  10. other text files on Postscript printers.
  11.  
  12. Before I wrote that program, each time I wanted to make a listing 
  13. of an assembler or C source on an Apple Postscript Laserwriter, I 
  14. needed to import the file in a desktop publishing program or a word 
  15. processor that support Postscript printers. Now with Lila all goes 
  16. easier. You just call it from your favorite shell and you get your 
  17. listing with header, page numbers and multicolumn pages.
  18.  
  19. * Hardware required :
  20. A standard Amiga with Kickstart 1.2 or greater
  21. A standard Postscript printer with the font named "Courier" (almost 
  22. all printers have it in ROM)
  23.  
  24. * Installation :
  25. The only thing to do is to copy the file named "Lila.prologue" to 
  26. your "s:" directory and the file named "Lila" to your "c:" 
  27. directory.
  28.  
  29. * Using Lila :
  30. Lila can only be called from CLI, not from Workbench. Command line 
  31. format is :
  32. Lila file out divisions orient title
  33. Where : file       is the text file to be printed
  34.         out        is where to send the Postscript code
  35.         divisions  is the number of columns per page
  36.         orient     is the page orientation (portrait or landscape)
  37.         title      is an optional page title.
  38.  
  39. * For example :
  40. Lila test.c ram:out 2 p Test
  41. Will print the file named "test.c" horizontally on the page with 
  42. two columns. The page title will be "Test" and the Postscript code 
  43. will be put in the file named "ram:out".
  44.  
  45. * Lila's output lines are 96 characters wide. If the text file 
  46. contains lines with more than 96 characters, end of line will be 
  47. skipped. All control characters (escape, form feed, etc) are 
  48. removed. Tabulators positions are each 8 characters. Text can be 
  49. placed horizontally on the page (Portrait orientation) or 
  50. vertically (Landscape orientation).
  51.  
  52. * Big source files :
  53. Due to the resolution of Postscript devices, it is possible to use 
  54. little font sizes and so to print more than one column per page. 
  55. This will allow you to print long files using very few paper. For 
  56. example if you choose portrait orientation and 2 columns per page, 
  57. Lila will print about the content of four normal pages on one page !
  58.  
  59. * Where to send output ?
  60. The laser printer I use is not connected to my Amiga, but to an 
  61. Apple MacIntosh. So I send the Postscript code to a file and then 
  62. download it to the Mac.
  63. If you have a Postscript laser connected to your Amiga, I think all 
  64. will work fine if you specify SER: or PAR: for the output of the 
  65. Postscript code.
  66.  
  67. * Page dimensions :
  68. Default Lila's paper format is DIN A4 (210 x 297 mm). If your 
  69. Postscript printer uses an other paper format, you must edit the 
  70. file named "lila.prologue" with a text editor. At the beginning of 
  71. the file you will see the following lines :
  72.      /xpage 210 mm def
  73.      /ypage 297 mm def
  74.      /x0 10 mm def
  75.      /y0 10 mm def
  76.      /x1 200 mm def
  77.      /y1 287 mm def
  78. Correct them to match your paper format. xpage and ypage are the 
  79. page size; the other values are the margins position. You can give 
  80. the values in millimeter (mm) or inch.
  81. For example US Letter format :
  82.      /xpage 8.5 inch def
  83.      /ypage 11 inch def
  84.      /x0 0.4 inch def
  85.      /y0 0.4 inch def
  86.      /x1 8.1 inch def
  87.      /y1 10.6 inch def
  88.  
  89. * Distribution :
  90. Lila is a shareware program. It can be freely distributed without 
  91. profit. If you use it you must send me a contribution of 10 US$. If 
  92. you want to receive the latest version of Lila, add 5 US$ if you 
  93. live in Europe or 10 US$ if you live outside Europe. (I'm currently 
  94. working on adding Intuition interface and selectable line width).
  95. My adress is :
  96.                         Bertrand Gros
  97.                         Case Postale 45
  98.                         1015 Lausanne 15
  99.                         Switzerland
  100.  
  101. Please only send cash, as bank taxes on foreign checks are very 
  102. high. Accepted currencies are Swiss Francs, US$ and Deutsche Mark.
  103. Send any remarks, problems and bugs report to the above adress
  104. (Please don't phone).
  105. If you want to use Lila for commercial purposes you need my written
  106. permission.
  107.