


      TTTTOOOOCCCC((((1111))))                      ((((UUUUNNNNIIIIXXXX 5555....2222))))                     TTTTOOOOCCCC((((1111))))



      NNNNAAAAMMMMEEEE
           toc - graphical table of contents routines

      SSSSYYYYNNNNTTTTAAAAXXXX
           ddddttttoooocccc [directory]
           ttttttttoooocccc mm-file
           vvvvttttoooocccc [----ccccddddhhhhniiiimmmmssssvvvvn] [TTOC file]

      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
           All of the commands listed below reside in ////uuuussssrrrr////bbbbiiiinnnn////ggggrrrraaaaffff
           (see _g_r_a_p_h_i_c_s(1G)).

           ddddttttoooocccc      Dtoc makes a textual table of contents, TTOC, of
                     all subdirectories beginning at _d_i_r_e_c_t_o_r_y
                     (_d_i_r_e_c_t_o_r_y defaults to ....).  The list has one entry
                     per directory.  The entry fields from left to
                     right are level number, directory name, and the
                     number of ordinary readable files in the
                     directory.  _D_t_o_c is useful in making a visual
                     display of all or parts of a file system.  The
                     following will make a visual display of all the
                     readable directories under ////:
                          ddddttttoooocccc //// |||| vvvvttttoooocccc |||| ttttdddd

           ttttttttoooocccc      Output is the table of contents generated by the
                     .TC macro of _m_m(1) translated to TTOC format. The
                     input is assumed to be an _m_m file that uses the .H
                     family of macros for section headers.  If no _f_i_l_e
                     is given, the standard input is assumed.

           vvvvttttoooocccc      _V_t_o_c produces a GPS describing a hierarchy chart
                     from a TTOC.  The output drawing consists of boxes
                     containing text connected in a tree structure.  If
                     no _f_i_l_e is given, the standard input is assumed.
                     Each TTOC entry describes one box and has the
                     form:
                          _i_d [_l_i_n_e-_w_e_i_g_h_t,_l_i_n_e-_s_t_y_l_e] "_t_e_x_t" [_m_a_r_k]
                     where:

                     _i_d          is an alternating sequence of numbers
                                 and dots.  The _i_d specifies the
                                 position of the entry in the
                                 hierarchy.  The _i_d 0000.... is the root of
                                 the tree.

                     _l_i_n_e-_w_e_i_g_h_t is either:
                                           nnnn, normal-weight; or
                                           mmmm, medium-weight; or
                                           bbbb, bold-weight.

                     _l_i_n_e-_s_t_y_l_e  is either:
                                           ssssoooo, solid-line;



      Page 1                                                   (9010-E)






      TTTTOOOOCCCC((((1111))))                      ((((UUUUNNNNIIIIXXXX 5555....2222))))                     TTTTOOOOCCCC((((1111))))



                                           ddddoooo, dotted-line;
                                           dddddddd, dot-dash line;
                                           ddddaaaa, dashed-line; or
                                           lllldddd, long-dashed

                     _t_e_x_t        is a character string surrounded by
                                 quotes.  The characters between the
                                 quotes become the contents of the box.
                                 To include a quote within a box, it
                                 must be escaped (\\\\"""").

                     _m_a_r_k        is a character string (surrounded by
                                 quotes if it contains spaces), with
                                 included dots being escaped.  The
                                 string is put above the top right
                                 corner of the box.  To include either
                                 a quote or a dot within a _m_a_r_k, it
                                 must be escaped.

                     Entry example:  1.1 b,da "ABC" DEF
                     Entries may span more than one line by escaping
                     the new-line (\\\\nnnneeeewwww----lllliiiinnnneeee).

                     Comments are surrounded by the ////****,****//// pair.  They
                     may appear anywhere in a TTOC.

                     Options:

                     cccc    Use text as entered (default is all upper
                          case).

                     dddd    Connect the boxes with diagonal lines.

                     hhhh_n   Horizontal interbox space is _n% of box width.

                     iiii    Suppress the box _i_d.

                     mmmm    Suppress the box _m_a_r_k.

                     ssss    Do not compact boxes horizontally.

                     vvvv_n   Vertical interbox space is _n% of box height.



      SSSSEEEEEEEE AAAALLLLSSSSOOOO
           graphics(1G).
           gps(4) in the _R_O_S _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l.







      Page 2                                                   (9010-E)



