home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d1xx / d167 / mrprint.lha / MRPrint / MRPrint.DOC < prev    next >
Text File  |  1988-11-22  |  3KB  |  76 lines
  1.  
  2. MRPrint -     A detabbing print utility for the Amiga
  3.  
  4. Author:        Mark Rinfret
  5.  
  6. Requires the ARP library, V1.1 or later.
  7.  
  8. ---------------------------------------------------
  9.  
  10. MRPRint prints Amiga text files to the printer device or standard
  11. output.  MRPrint provides several processing options which afford
  12. the user some flexibility in determining the output format.  Perhaps
  13. the most important feature is tab expansion.  MRPrint expands embedded
  14. tabs to blanks, according to the user's tab spacing specification 
  15. (default=4).  MRPrint also will optionally generate page headers, line
  16. numbers and new margins.  Input lines that are too long for the current
  17. margin settings will be split across multiple lines, maintaining correct
  18. pagination.  A form feed character detected at the beginning of an input 
  19. line will be recognized and cause a page eject.
  20.  
  21. MRPrint is invoked from the CLI with Un*x style command line parameters.  
  22. Wildcarding of file names is supported, allowing either AmigaDOS or Un*x
  23. style wildcard specifications.  All parameters, including the file name(s)
  24. to be printed are optional.  In the case of formatting options, defaults
  25. are used if no option is explicity given.  All options must precede file 
  26. names on the command line.  To see a list of options, invoke MRPrint with:
  27.  
  28.         MRPrint -?
  29.  
  30. Of special note is the fact that MRPrint will automatically detect and
  31. reject files which have binary (non-printable) content.  You can therefore
  32. invoke MRPrint in the following form
  33.  
  34.     MRPrint *
  35.  
  36. to print all files in the current directory without having to worry about 
  37. object, program data, or directory files being printed.  
  38.  
  39.  
  40. If no file names are passed on the command line, MRPrint will put up a
  41. file name requester.  Multiple files may be printed in this fashion,
  42. terminating MRPrint by pressing the CANCEL gadget on the requester.
  43.  
  44.  
  45. The current default values for MRPrint are:
  46.  
  47.     left margin:        5
  48.     right margin:        85
  49.     tab spaces:            4
  50.     headers:            enabled
  51.     line numbers:        disabled
  52.  
  53. Of course, having the source (nice rhyme, eh?), you can change these so
  54. that you don't have to constantly type in your favorite options.  One
  55. thing - be sure that your margin settings in preferences don't interfere
  56. with MRPrint's behavior.  It expects that the left margin is set to 1 and
  57. the right margin is at least as wide as what you specify.  I usually
  58. set my preferences to 1, 255. Of course, if you're ambitious, you'll add
  59. the code to get the Preferences settings and adapt.  
  60.  
  61. There are lots of things that can be done to improve this program. A 
  62. 'copies' option would be nice as well as options to support letter quality, 
  63. draft, characters per inch, etc.  The Amiga supports these things in a fairly
  64. nice, generic way if you have the right printer driver. I hope you find this
  65. to be a useful addition to your tool box.  By the way, I love ARP.  It's
  66. a good example of the way things should be done.  My hat is off to Charlie
  67. Heath and his crew for developing such a fine product and making it freely
  68. available to the public.
  69.  
  70.                                             Mark Rinfret
  71.                                             mark@amanpt1.zone1.com
  72.                                             work: 401-849-9930 x301
  73.                                             home: 401-846-7639
  74.  
  75.  
  76.