home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Interactive Guide / c-cplusplus-interactive-guide.iso / c_ref / csource4 / 264_01 / nro.doc < prev    next >
Text File  |  1979-12-31  |  16KB  |  331 lines
  1.  
  2.      NRO (1)                   MS-DOS Version 3.2                   NRO (1)
  3.  
  4.  
  5.  
  6.      NAME        NAME 
  7.           nro - text processor 
  8.  
  9.      SYNOPSIS        SYNOPSIS 
  10.           nro   n    n    pxx    v    b    mmfile  ifile       ofile              nro [-n] [+n] [-pxx] [-v] [-b] [-mmfile] ifile ... [>ofile] 
  11.  
  12.      DESCRIPTION        DESCRIPTION 
  13.           ___                                                                     NRO  is  a  text processor and formatter based on the design
  14.                         Software Tools                                             provided in  "Software Tools" by Kernighan and Plauger.  The 
  15.                                           ________                                text and commands found in the  ifile(s)  are  processed  to
  16.           generate formatted  text.  The output may be directed into a
  17.                                     _____                                         file or to the printer if ofile is present  in  the  command
  18.           line;   otherwise,  the  output  will  appear  at  the  user
  19.                                                                     P             console.  Directing the output to the special filename,  $P,
  20.           will cause the output to be sent to the printer.  
  21.  
  22.                _                                               _                  The +n  option  causes the output to start with page n.  The
  23.            _                                             _               -n option causes the output to stop after page n.  
  24.  
  25.                _                                                               The -v option prints the version number to the console.  
  26.  
  27.                _                                                                  The -p option causes the output to be shifted to  the  right
  28.              __                                           po                       by xx spaces.  This has the same effect as the .po command.  
  29.  
  30.                _                                                                   The -b option allows backspaces to appear in the output text 
  31.           when underlining  or overstriking.  This has the same effect
  32.                   bs                                                as the .bs command with a non-zero argument.  
  33.  
  34.                 _                                  _____                          The  -m  option  processes  the   file   mfile   for   macro
  35.           definitions.   Note  that files processed in this way should
  36.           contain only macro definitions, no immediate  output  should
  37.           be generated from this file.  
  38.  
  39.           Commands  typically  are distinguished by a period in column
  40.           one of the input followed by a  two  character  abbreviation
  41.           for the  command  funtion.    The  abbreviation  may then be
  42.           followed by an optional numeric or character argument.   The
  43.           numeric  argument  may  be an absolute value such as setting
  44.           the right margin to a particular column, or the argument may 
  45.           be preceded by a plus sign or a minus sign to indicate  that
  46.           the  parameter  should  be  modified  relative to a previous
  47.           setting.  The following commands are recognized: 
  48.  
  49.           .bo - causes the following lines of text to appear in 
  50.                 boldface.  The optional argument specifies the number 
  51.                 of lines to be typed in boldface.  Boldface and 
  52.                 underlining are mutually exclusive features.  The 
  53.                 appearance of a boldface command will cause any 
  54.                 underlining to cease.  
  55.  
  56.           .bp - causes succeeding text to appear at the top of a new 
  57.                 page.  The optional argument specifies the page number 
  58.                 for the new page.  The initial value is one and the 
  59.                 default value is one more than the previous page 
  60.                 number.  
  61.  
  62.           .br - causes succeeding text to start on a new line at the 
  63.  
  64.  
  65.                                       -1-
  66.  
  67.  
  68.      NRO (1)                   MS-DOS Version 3.2                   NRO (1)
  69.  
  70.  
  71.                 current left margin.  There is no numeric argument for 
  72.                 this command.  
  73.  
  74.           .bs - enables or disables the appearance of backspaces in 
  75.                 the output text.  Underlining and boldface options are 
  76.                 implemented by inserting character - backspace - 
  77.                 character combinations into the output buffer.  This 
  78.                 is fine for devices which properly recognize the 
  79.                 backspace character.  Some printers, however, do not 
  80.                 recognize backspaces, so the option is provided to 
  81.                 overprint one line buffer with another.  The first 
  82.                 line buffer is terminated with just a carriage return 
  83.                 rather than the carriage return - linefeed 
  84.                 combination.  A zero argument or no argument to the 
  85.                 backspace command removes backspaces from the output.  
  86.                 A non-zero argument leaves them in the output.  The 
  87.                 default is to remove backspaces.  
  88.  
  89.                             ___                                                    .cc - changes the NRO command character to that specified by 
  90.                 the character argument.  If no argument is provided, 
  91.                 the default is a period.  
  92.  
  93.           .ce - causes the next line of text to appear centered on the 
  94.                 output.  The optional argument specifies if more than 
  95.                 one line is to be centered.  
  96.  
  97.           .de - causes all text and commands following to be used to 
  98.                                                                     en                   define a macro.  The definition is terminated by a .en 
  99.                 command.  The first two characters of the argument 
  100.                                de                                                      following the .de command become the name of the new 
  101.                 command.  It should be noted that upper and lower case 
  102.                 arguments are considered different.  Thus, the 
  103.                           PP      pp                                              commands .PP and .pp could define two different 
  104.                 macros.  Care should be exercised since existing 
  105.                 commands may be redefined.  
  106.  
  107.                 A macro may contain up to ten arguments.  In the macro 
  108.                 definition, the placement of arguments is designated 
  109.                 by the two character sequences, $0, $1, ... $9.  When 
  110.                 the macro is invoked, each argument of the macro 
  111.                 command line is substituted for its corresponding 
  112.                 designator in the expansion.  The first argument of 
  113.                 the macro command is substituted for the $0 in the 
  114.                 expansion, the second argument for the $1, and so 
  115.                 forth.  Arguments are typically strings which do not 
  116.                 contain blanks or tabs.  If an argument is to contain 
  117.                 blanks, then it should be surrounded by either single 
  118.                 or double quotes.  
  119.  
  120.           .cu - causes the next line(s) of text to be continuously 
  121.                                                                 ul                    underlined.  Unlike the underline command (see .ul) 
  122.                 which underlines only alphanumerics, continuous 
  123.                 underlining underlines all printable characters.  The 
  124.                 optional argument specifies the number of lines of 
  125.                 text to underlined.  Any normal underlining or 
  126.                 boldface commands currently in effect will be 
  127.                 terminated.  
  128.  
  129.  
  130.  
  131.                                       -2-
  132.  
  133.  
  134.      NRO (1)                   MS-DOS Version 3.2                   N