home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / CPM / TURBOPAS / RNF-PAS.LBR / RNFDOC.RQF / RNFDOC.RNF
Text File  |  2000-06-30  |  4KB  |  92 lines
  1. .REM the entire line after .REM is a comment
  2. .REM set paragraphs: 5 space indent, single space, page if not two lines
  3. .P +5 1 2
  4. .REM  .AP gives auto paragraphing via leading blanks or tab
  5. .AP
  6.  
  7. .C Quick Introduction to RNF
  8.  
  9. .C Willett Kempton
  10. .C 7 June 1986
  11.  
  12.  
  13.    RNF is a program for producing documents such as user manuals,
  14. reports, or term papers.  This is a short introduction to RNF; more
  15. details can be found in the complete manual.
  16.   RNF is a text formatter,
  17. like nroff or troff on UNIX or RUNOFF on the DEC-10.  It expects an input file
  18. containing
  19. text and commands, and it produces a final-format document.  The input file
  20. is just a standard ASCII file, and can be prepared with any editor.
  21. Most commands are a dot and a name, such as _.BOLD to print bold letters.
  22. The output is typically sent directly to the printer, but it can be
  23. sent to a file or to the console (CON:) first for checking if desired.
  24.   RNF is unlike most word processors in that it does not format on-screen
  25. and it has no built-in editor.
  26. On the other hand,
  27. it has more powerful capabilities than most commercial word processors, it
  28. is written in very standard Pascal, and it is in the public domain.  Therefore,
  29. RNF is good for people who are in one or more of the following categories,
  30. people who:
  31. .LIST 1
  32. .LE Want a good word processor but don't want
  33. to spend a lot of money for it, or
  34. .LE Like the editor they are already using for programming better than
  35. the editor embedded in their word processor, or
  36. .LE Want to use more of the special features of their printer, which
  37. their current word processor does not allow, or
  38. .LE  Cannot stand relying on tools (such as word processors) for which
  39. they do not have the source code, because they cannot fix those annoying little
  40. bugs and limitations, or
  41. .LE Want to
  42. learn about programming by examining well-written, moderately large
  43. programs, or
  44. .LE Need a word processor which can run on many different
  45. computer systems, while using the same document files.  You have a PC
  46. and the coauthors of your book have a VAX and a Cyber?  No problem!
  47. .ENDLIST
  48.    To prepare text for RNF, user your favorite editor.
  49. Paragraphs can be separated by a blank line, or, if
  50. the _.AP (autoparagraph) command is given, by leading
  51. spaces or a tab.
  52. Thus, you can start using RNF by just creating a file which
  53. starts with _.AP and then typing normal text--RNF will fill lines, divide into
  54. paragraphs, and number pages for you.
  55.    Even though RNF is very powerful, you can learn only a useful subset
  56. if you want.  It works fine on normal text with just an _.AP.
  57. You will soon be using simple things like underlining, centering, automatic
  58. list numbering, hanging paragraphs, and "ASIS" mode.
  59. Some people will then want to try variables,
  60. conditionals, include files, saving environments, and macros.
  61.   Notice that three characters are used for special
  62. purposes:  "__"  "_#"  "_\"   (underline, sharp,
  63. and backslash).  In addition, two
  64. characters are special only when they have
  65. letters immediately after them:  "_."  and  "$"  (period and dollar sign),
  66. and two more are special only when flags are set:  "_<"  "_^"  (less than
  67. and uparrow).  To make special
  68. characters show on the output, proceed them with an underline "__" which
  69. quotes the special character.  Finally, control characters will not
  70. appear except through the _.FMT command.
  71.  
  72.   TO COMPILE:  First, check that PAGE is appropriate for your printer;
  73. as distributed, RNF assumes that control-L does a page eject.
  74. Using Turbo Pascal version 3 on MS-DOS, PC-DOS and CP/M-86,
  75. just read RNF.PAS as the Main file,
  76. set the option to compile to disk, and compile it.  It will include
  77. several RNF?.PAS files.  For CP/M-80,
  78. un-comment the three overlays as marked in RNF.PAS before compiling.
  79. On Turbo Pascal versions before ver 3, and on Prospero ProPascal
  80. or VAX/VMS Pascal, a few
  81. changes will have to be made before compiling, as marked in the comments.
  82.  
  83.   TO PRINT THE MANUAL:  You must compile RNF before printing the manual.
  84. Try a test printing of this small document; print
  85. it with the command:
  86. "RNF#RNFDOC.RNF".  To print the entire manual,
  87. type "RNF#RNFMAN.RNF".  Ignore the 20 or so warning messages about ASIS
  88. lines extending past the right margin, and the two warnings of an empty
  89. token.  The manual is about 50 pages.
  90.  
  91.   Good luck!
  92.