home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / misc / volume9 / mpage / part01 / README < prev   
Text File  |  1989-12-26  |  5KB  |  129 lines
  1.  
  2. COPYRIGHT:
  3.  
  4. Mpage and all the files distributed with mpage are covered by copyright:
  5.  
  6.  Copyright (c) 1988 Mark P. Hahn, Herndon, Virginia
  7.   
  8.      Permission is granted to anyone to make or distribute verbatim
  9.      copies of this document as received, in any medium, provided
  10.      that this copyright notice notice is preserved, and that the
  11.      distributor grants the recipient permission for further
  12.      redistribution as permitted by this notice.
  13.  
  14. Mpage was written by:
  15.    ...!uunet!\                       Mark Hahn, Sr Systems Engineer
  16.               >pyrdc!mark            Pyramid Technology Corporation
  17.  ...!pyramid!/                       Vienna, Va    (703)848-2050
  18.  
  19.  
  20.  
  21. ******************** Important Notice ****************************
  22.  
  23. I am moving to Seoul, Korea in about 2 days.  As such any claims
  24. that I might have a couple minutes to spare to work on improvments
  25. or repairs should be reduced accordingly.  While there are still
  26. a number of changes I would like to make, I just don't have the
  27. time.  They will have to wait.  However, I still solicit your input
  28. so that if I have time, I will do what I can.  I don't know my
  29. new net address or postal address, but mail sent to the above will
  30. be forwarded on an irregular schedule.
  31.  
  32. **************** End Of Important Notice *************************
  33.  
  34. DESCRIPTION:
  35.  
  36. Mpage is a program to reduce and print multiple pages of text per
  37. sheet on a PostScript compatible printer.
  38.  
  39. The following are the files you should have for mpage.
  40.  
  41.      MANIFEST               The shipping list
  42.      README                 Notes and descriptions
  43.      CHANGES                Changes since Version 1
  44.      Makefile.mpage         The Makefile
  45.      TODO                   Wish List for changes
  46.      mp_args.c              Command line and options processing
  47.      mp_file.c              Generic file handeling
  48.      mp_glob.c              Global variable setup
  49.      mp_head.h              Definitions
  50.      mp_main.c              Main Control
  51.      mp_page.c              Page layout routines
  52.      mp_post.c              PostScript file processing
  53.      mp_sample.c            Prints sample page layout pages 
  54.      mp_text.c              Text file processing
  55.      mpage.1                Manual page
  56.  
  57.  
  58.  
  59. INSTRUCTIONS:
  60.  
  61. All you should need to do is copy Makefile.mpage to Makefile and run
  62. make.  This will create mpage and a program called msample.  Mpage is
  63. the program to print n-up pages.  Msample prints a sample outline.  I
  64. used it for debugging the placement of the layout.  It is also handy
  65. for other layout purposes.  It accepts all the arguments that mpage
  66. does, but does not print files.
  67.  
  68. As a quick sample try:
  69.  
  70.     "mpage -p mp_args.c"
  71. or
  72.     "mpage -p8 mp_post.c"
  73. or
  74.     "psroff -t -man mpage.1 | mpage -2"
  75.  
  76. The manual page, mpage.1, formats with UCB or ATT manual macros.
  77.  
  78. The spooler interface in mpage only submits to a UCB style spooler.  It
  79. shouldn't take too much work to convert to submission to a ATT style
  80. spooler.
  81.  
  82.  
  83.  
  84. USING MPAGE:
  85.  
  86. You will find that it takes a while on an Apple LW or Apple LW+ to
  87. print 4 pages per sheet, It takes "a good long time" for 8 pages.
  88. Reduced PostScript documents take a while too.  (A rule of thumb might
  89. be 4 times as long for 4-pages-per-sheet reduction :-) On a QMS 8ppm
  90. printer 4 pages per sheet is about the same speed and other forms of
  91. "1-up" output.  mpage prints some timing information back from the
  92. printer so you can measure the time required for full jobs.
  93.  
  94.  
  95.  
  96. ADMINSITRATORS:
  97.  
  98. As a printer administrator you should see the wish list for caveats
  99. and information about future versions.  I still have work to do to
  100. make mpage more "administrator friendly", but figured that I'd better
  101. get what's been done out the door.  The alternative is to constanly
  102. make changes and never release anything.
  103.  
  104.  
  105.  
  106. BUG REPORTS:
  107.  
  108. Mpage is not a supported program.  I do not have the time or resources
  109. to maintain mpage.  I am interested in receiving reports of problems
  110. so that which I get spare time I can try to fix them.  If you have a
  111. problem please send me a complete, succinct description of the
  112. symptoms.  Please include the brand name of your printer, a copy of
  113. the input file (especially if it is with PostScript input), and a
  114. description of what to look for on the output.  If your printer has an
  115. error log, please include as much of it as is revalant.  In general,
  116. the more clearly organized information I have, the easier it will be
  117. for me.
  118.  
  119.  
  120.  
  121. MAKING CHANGES:
  122.  
  123. Please, if you make any improvements, send them back to me so that I
  124. can include them in future versions.  Also I would solicit comments as
  125. to the usefulness, and effectiveness of mpage.  Let me know what you
  126. like or dislike and feel free to ask any questions you have concerning
  127. this mpage distribution.  Thank you, Mark Hahn.
  128.  
  129.