1 03/11/76   list, lis; listnh, lisn
  2 
  3 The list command displays information contained in the current file
  4 alone, the alter file alone, or of the current file after merging with
  5 the alter file.  In the latter case, the list command causes the merge
  6 to take place thereby clearing the alter file.  The output from list is
  7 preceded by a header giving the file name and the time and date.  To
  8 suppress this header, the user may use listnh with the same type of
  9 arguments.
 10 
 11 
 12 Syntax:  list {file} {line_number}
 13 
 14 
 15 where:
 16 
 17 1.   file           identifies the file to be listed (current or
 18                     alter).
 19 
 20 2.   line_number    is any valid line number.
 21 
 22 
 23 The effects of the various uses of list are shown below:
 24 
 25 
 26      FORM                EFFECT
 27 
 28      list                prints the current file (after merging with
 29                          alter file).
 30 
 31      list line_number    prints the current file beginning at the line
 32                          number given; if no such line number exists,
 33                          the next higher line number is used; if the
 34                          line number is greater than any line number in
 35                          the file, the last line of the file is
 36                          printed.
 37 
 38      list current,       prints the current file (without  merging
 39      list cur            contents of alter file).
 40 
 41      list alter,         prints  contents  of  alter  file  after
 42      list alt            sorting into numerical order by line number
 43                          (lines containing only line numbers are
 44                          retained in this case).
 45 
 46 
 47 A line number may be specified with either current or alter (e.g., list
 48 alt 40).  The printout adheres to the rule given for the list
 49 line_number form above but is restricted to the file specified.
 50 
 51 
 52 Example:
 53 
 54 The output of the listings below assumes the following contents for the
 55 current and alter files.
 56 
 57 
 58      CURRENT FILE   ALTER FILE
 59 
 60      100 text       120 new text
 61      110 to be      150 may also
 62      120 listed     160 be
 63      130 next       170 listed
 64 
 65 
 66 
 67 !    list current
 68 
 69      current     11/07/75   1214.6 mst Fri
 70 
 71      100 text
 72      110 to be
 73      120 listed
 74      130 next
 75      ready  1214
 76 
 77 
 78 !    list alters 200
 79 
 80      alter       11/07/75   1215.2 mst Fri
 81 
 82      170 listed
 83      ready  1215
 84 
 85 
 86 !    list
 87 
 88      no name     11/07/75   1216.1 mst Fri
 89 
 90      100 text
 91      110 to be
 92      120 new text
 93      130 next
 94      150 may also
 95      160 be
 96      170 listed
 97      ready  1216
 98 
 99 
100 !    list alter
101      list:  alter segment is empty