home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / programming / b137_1 / !Formatter_!Help < prev    next >
Encoding:
Text File  |  1993-12-06  |  2.8 KB  |  97 lines

  1. *************************************************** 
  2. *                     Formatter                   *
  3. *          A C Source code printing utility       *
  4. ***************************************************
  5.  
  6. Note: This program was written by Richard Millican
  7.       and is (c) 1993 Richard Millican. You may not
  8.       freely distribute it without prior written
  9.       permission from the author.
  10.  
  11. ***************************************************
  12.  
  13. Introduction
  14.  
  15. When writing a program it is often useful to be
  16. able to obtain a hard-copy of the source files.
  17. This can easily be done with C files as they are
  18. just standard text files. Just dragging them to the
  19. printer icon can produce some pretty dull results
  20. and if there are lots of comments everywhere it
  21. can get rather confusing. To solve this situation
  22. I wrote 'Formatter'. This simply takes a C source
  23. file and produces an Impression DDF file which can
  24. then be loaded into Impression and printed. In
  25. addition to this you can specify which fonts to
  26. use for the standard C parts and which fonts for
  27. the comment sections.
  28.  
  29. ***************************************************
  30.  
  31. Instructions
  32.  
  33. To convert a source file simply drag the source
  34. file to the application and click the 'run' icon.
  35.  
  36. The fonts used can be changed using the icons in
  37. the dialogue box. The defaults (when the option
  38. icons are not selected) are to use Corpus.Bold.
  39. Oblique at 9pt for the comments and Corpus.Medium
  40. at 9pt for the code. This looks good as Corpus is
  41. not a proportional font so text lines-up ok on
  42. each line.
  43.  
  44. The 'Formatter' program can also be run from the
  45. command line. The syntax used by the program is as
  46. follows:
  47.  
  48.  Formatter [switches] <source file> <object file>
  49.  
  50.  switches (names may be abbreviated to 1 letter):
  51.    
  52.    -help                       display help text
  53.    
  54.    -code    <fontname> <size>  main code's font
  55.                                          and size
  56.    -remarks <fontname> <size>  comment's font
  57.                                          and size
  58.  
  59. ***************************************************
  60.  
  61. History
  62.  
  63. Version 1.02 (7/12/93)
  64.  
  65. Fixed a small bug for strings with /* or */ in, now
  66. seems to work ok. The code's got a bit more complex
  67. though ! Needed to check for \' \" \\ etc...
  68.  
  69.  
  70. Version 1.01 (19/10/93)
  71.  
  72. Added a snazzy DDE front end. It took ages as the
  73. DDE modules didn't seem to like what I was doing.
  74.  
  75.  
  76. Version 1.00 (27/4/93)
  77.  
  78. First version. No front end. Works OK though.
  79.  
  80. ***************************************************
  81.  
  82. If you find the proggy useful please let me know.
  83. Here's my address if you fancy sending me money,
  84. blank disks or pizza vouchers...
  85.  
  86.               Richard Millican,
  87.               10 Stokesay,
  88.               Bidston,
  89.               Birkenhead,
  90.               Merseyside,
  91.               ENGLAND.
  92.               L43 7PU
  93.  
  94.               (e-mail: millinr@cs.man.ac.uk)
  95.  
  96. ***************************************************
  97.