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     ! 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.