Return to man.c CVS log

Up to [MW Coherent from dump] / coherent / a / usr / man / COHERENT

Annotation of coherent/a/usr/man/COHERENT/man.c, revision 1.1.1.1

1.1       root        1: 
                      2: 
                      3: man                          Command                          man
                      4: 
                      5: 
                      6: 
                      7: 
                      8: Print online manual sections
                      9: 
                     10: mmaann [-ww] [_t_o_p_i_c ...]
                     11: 
                     12: man prints the  COHERENT lexicon entries for each specified topic
                     13: on the  standard output.  It uses scat to  display text (with the
                     14: -s  option to  suppress  blank lines).   With  no arguments,  man
                     15: prints a list of each available topic.
                     16: 
                     17: When used with the -w option, it prints the path name of the file
                     18: instead of printing the document itself.
                     19: 
                     20: If environmental variable PAGER is defined, man will ``pipe'' its
                     21: output through the  command specified in PAGER.  For example, the
                     22: .pprrooffiillee command line:
                     23: 
                     24: 
                     25:         export PAGER="exec /bin/scat -1"
                     26: 
                     27: 
                     28: would  invoke /bin/scat  with the command  line argument  -1 (the
                     29: digit one).
                     30: 
                     31: ***** Manual-Page Control Files *****
                     32: 
                     33: The man  command uses two  control files when  processing manual-
                     34: page  requests.  File /usr/man/man.help  contains the  man's help
                     35: message.   This includes  a  list of  valid topics  and some  ex-
                     36: planatory  text.  The  second  control file,  /usr/man/man.index,
                     37: contains index entries for all manual pages on the system.  Lines
                     38: in this text file are of the form:
                     39: 
                     40: 
                     41:              _r_e_l_a_t_i_v_e-_p_a_t_h-_n_a_m_e _t_o_p_i_c
                     42: 
                     43: 
                     44: where  relative-path-name  gives  the  subdirectory and  file  in
                     45: /usr/man  that hold  the  manual-page entry,  and  topic gives  a
                     46: manual-page  topic  associated  with  this  file.   For  example,
                     47: entries
                     48: 
                     49: 
                     50:         COHERENT/ascii  ascii
                     51:         COHERENT/ascii  ASCII
                     52:         local/chess  chess
                     53: 
                     54: 
                     55: associate system  manual-page /usr/man/COHERENT/ascii with either
                     56: upper- or lower-case  spellings of topic ascii.  Similarly, rules
                     57: for   a    user-written   chess   game   are    found   in   file
                     58: /usr/man/local/chess and are retrieved using topic chess.
                     59: 
                     60: 
                     61: 
                     62: 
                     63: 
                     64: COHERENT Lexicon                                           Page 1
                     65: 
                     66: 
                     67: 
                     68: 
                     69: man                          Command                          man
                     70: 
                     71: 
                     72: 
                     73: ***** Adding Manual-Page Entries *****
                     74: 
                     75: When writing  new manual-page entries for  COHERENT, we recommend
                     76: that you  place them in  subdirectories of /usr/man.   These sub-
                     77: directories should be uniquely named to avoid possible name-space
                     78: collisions.   A good  rule-of-thumb is  to name  the subdirectory
                     79: after  the application  with which it  is associated.   This also
                     80: allows them to  be updated easily, as all manual-pages associated
                     81: with a given application reside in a specific subdirectory.
                     82: 
                     83: When you  add manual-page entries to the  system, you should also
                     84: append a  list of topics to  /usr/man/man.help.  In addition, you
                     85: must append a line to the end of file /usr/man/man.index for each
                     86: newly added topic.
                     87: 
                     88: ***** Files *****
                     89: 
                     90: /uussrr/mmaann/* -- Directories that hold manual pages
                     91: 
                     92: ***** See Also *****
                     93: 
                     94: commands, help, install, PAGER, scat
                     95: 
                     96: 
                     97: 
                     98: 
                     99: 
                    100: 
                    101: 
                    102: 
                    103: 
                    104: 
                    105: 
                    106: 
                    107: 
                    108: 
                    109: 
                    110: 
                    111: 
                    112: 
                    113: 
                    114: 
                    115: 
                    116: 
                    117: 
                    118: 
                    119: 
                    120: 
                    121: 
                    122: 
                    123: 
                    124: 
                    125: 
                    126: 
                    127: 
                    128: 
                    129: 
                    130: COHERENT Lexicon                                           Page 2
                    131: 
                    132: 

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.