

            guide (1) --- Software Tools Subsystem User's Guides     08/27/84


          | _U_s_a_g_e

                 guide  { <option> | <item> }
                    <option> ::=  -p
                    <item> ::= <guide_name>


            _D_e_s_c_r_i_p_t_i_o_n

          |      Several of the more complicated or more frequently used Sub-
          |      system  commands and libraries have additional documentation
          |      beyond that which is available from  the  reference  manual.
          |      This  documentation  is  in  the form of a separate paper on
          |      each command or library, but these papers may be combined to
          |      form the _S_o_f_t_w_a_r_e _T_o_o_l_s _S_u_b_s_y_s_t_e_m _U_s_e_r_'_s _G_u_i_d_e.

                 The command

                      guide <guide name>

                 prints the named guide in a format suitable for reading on a
                 fast CRT terminal.

                 The command

                      guide -p <guide name>

                 prints the named guide in a format  suitable  for  the  line
                 printer.

                 Copies  of individual documents may be printed on one of the
                 on-site line printers by giving the following command:

                      guide -p <guide name> | os >/dev/lps/f

                 where "<guide name>" is one of the following guide names:


          |      cc

          |           A copy of the _U_s_e_r_'_s  _G_u_i_d_e  _f_o_r  _t_h_e  _G_e_o_r_g_i_a  _T_e_c_h  _C
          |           _C_o_m_p_i_l_e_r.    This   guide   describes   the   necessary
          |           requirements for compiling programs written in  C  from
          |           the  Subsystem.  Refer to _T_h_e _C _P_r_o_g_r_a_m_m_i_n_g _L_a_n_g_u_a_g_e by
          |           Brian Kernighan and Dennis Ritchie for specific details
          |           about the C programming language.  TTThhhiiisss ggguuuiiidddeee  iiisss  ooonnnlllyyy
          |           aaavvvaaaiiilllaaabbbllleee  tttooo  cccuuussstttooommmeeerrrsss  wwwhhhooo  hhhaaavvveee aaalllsssooo llliiiccceeennnssseeeddd ttthhheee CCC
          |           lllaaannnggguuuaaagggeee cccooommmpppiiillleeerrr pppaaaccckkkaaagggeee...


          |      ed

          |           A copy of  _I_n_t_r_o_d_u_c_t_i_o_n  _t_o  _t_h_e  _S_o_f_t_w_a_r_e  _T_o_o_l_s  _T_e_x_t
          |           _E_d_i_t_o_r  is  printed.  This paper includes a tutorial on
          |           the Subsystem's text editor that is highly  recommended
          |           for beginning users, as well as a command summary and a


            guide (1)                     - 1 -                     guide (1)




            guide (1) --- Software Tools Subsystem User's Guides     08/27/84


          |           special section on the Subsystem screen editor.


          |      fmt

          |           A  copy  of the _S_o_f_t_w_a_r_e _T_o_o_l_s _S_u_b_s_y_s_t_e_m _T_e_x_t _F_o_r_m_a_t_t_e_r
          |           _U_s_e_r_'_s  _G_u_i_d_e  is  printed.   This  includes  tutorial,
          |           reference,  and  applications  information.   One  very
          |           useful appendix contains all text formatting  commands,
          |           arranged alphabetically.


          |      fs

          |           A  copy  of  _U_s_e_r_'_s  _G_u_i_d_e _t_o _t_h_e _P_r_i_m_o_s _F_i_l_e _S_y_s_t_e_m is
          |           printed.  This paper gives a brief introduction to  the
          |           Primos file system as it applies to the use of the Sub-
          |           system.   It explains the structure of the file system,
          |           provisions for security, and how users access files  by
          |           name.


          |      math

          |           A copy of the _S_W_T _M_a_t_h _L_i_b_r_a_r_y _U_s_e_r_'_s _G_u_i_d_e is printed.
          |           This  includes descriptions of the Prime floating point
          |           hardware, the SWT math library, and the tests  used  to
          |           validate  the  SWT  library.  Appendices contain useful
          |           programs  to  help  determine  where  the  exponent  is
          |           located  on  your  particular  machine,  determine  the
          |           amount of loss of bits in  a  multiply  operation,  and
          |           calculate hexadecimal constants for use in mathematical
          |           routines.   The  addendum  documents the routines which
          |           used to be in the old, locally supported, math  library
          |           "vswtml."


          |      mgr

          |           A  copy of the _S_o_f_t_w_a_r_e _T_o_o_l_s _S_u_b_s_y_s_t_e_m _M_a_n_a_g_e_r_'_s _G_u_i_d_e
          |           is printed.  This guide is  useful  for  all  Subsystem
          |           managers  and  anyone  else  interested  in the instal-
          |           lation, maintenance, and daily operation  of  the  Sub-
          |           system.


          |      ring

          |           A  copy of _R_i_n_g _-_- _T_h_e _S_o_f_t_w_a_r_e _T_o_o_l_s _S_u_b_s_y_s_t_e_m _N_e_t_w_o_r_k
          |           _U_t_i_l_i_t_y is printed.  This paper documents the structure
          |           and use of 'ring', a utility which makes it easier  for
          |           the end user to deal with Primenet.






            guide (1)                     - 2 -                     guide (1)




            guide (1) --- Software Tools Subsystem User's Guides     08/27/84


          |      rp

          |           Prints  the  _R_a_t_f_o_r  _P_r_o_g_r_a_m_m_e_r_'_s _G_u_i_d_e.  This document
          |           includes a detailed description of the Ratfor  program-
          |           ming language as well as instructions for its use under
          |           the Subsystem.  It is essential for anyone hoping to do
          |           any   significant   amount  of  programming  using  the
          |           capabilities supplied by the Subsystem.


          |      sh

          |           A copy of _U_s_e_r_'_s _G_u_i_d_e _f_o_r _t_h_e _S_o_f_t_w_a_r_e _T_o_o_l_s _S_u_b_s_y_s_t_e_m
          |           _C_o_m_m_a_n_d _I_n_t_e_r_p_r_e_t_e_r is printed.  This  paper  discusses
          |           the features of the Subsystem command interpreter, cal-
          |           led the 'shell', on three levels:  a tutorial introduc-
          |           tion,  a  syntax  and semantics reference, and a set of
          |           applications notes.


          |      tutorial

          |           A copy of _T_h_e  _S_o_f_t_w_a_r_e  _T_o_o_l_s  _S_u_b_s_y_s_t_e_m  _T_u_t_o_r_i_a_l  is
          |           printed.   This  tutorial is intended as a user's first
          |           introduction  to  the   Subsystem   and   covers   such
          |           essentials  as logging in and out, features of the com-
          |           mand language, editing,  online  documentation  and  so
          |           forth.  NEW USERS SHOULD READ THIS DOCUMENT FIRST.


          |      v8.1

          |           A  copy  of  the  _S_o_f_t_w_a_r_e _T_o_o_l_s _S_u_b_s_y_s_t_e_m _V_e_r_s_i_o_n _8 _t_o
          |           _V_e_r_s_i_o_n _8._1 _C_o_n_v_e_r_s_i_o_n _G_u_i_d_e is  printed.   This  guide
          |           summarizes all user-visible changes that have been made
          |           between the Version 8 and Version 8.1 Subsystems.


          |      v9

          |           A  copy  of the _S_o_f_t_w_a_r_e _T_o_o_l_s _S_u_b_s_y_s_t_e_m _V_e_r_s_i_o_n _8._1 _t_o
          |           _V_e_r_s_i_o_n _9 _C_o_n_v_e_r_s_i_o_n _G_u_i_d_e is printed.  This guide sum-
          |           marizes all user-visible changes that  have  been  made
          |           between the Version 8.1 and Version 9 Subsystems.


                 vcg

                      A  copy  of  _A  _R_e_-_U_s_a_b_l_e  _C_o_d_e _G_e_n_e_r_a_t_o_r _f_o_r _P_r_i_m_e _5_0_-
                      _S_e_r_i_e_s _C_o_m_p_u_t_e_r_s _U_s_e_r_'_s _G_u_i_d_e.   'Vcg'  is  a  reusable
          |           general-purpose   code   generator   that   accepts  an
          |           "intermediate form" and produces  64V-mode  relocatable
          |           object  code,  or  optionally,  PMA.   The  V-mode code
                      generator is the back-end for the Georgia Tech  C  Com-
          |           piler.   TTThhhiiisss  ggguuuiiidddeee iiisss ooonnnlllyyy aaavvvaaaiiilllaaabbbllleee tttooo cccuuussstttooommmeeerrrsss wwwhhhooo
          |           hhhaaavvveee aaalllsssooo llliiiccceeennnssseeeddd ttthhheee CCC lllaaannnggguuuaaagggeee cccooommmpppiiillleeerrr pppaaaccckkkaaagggeee...


            guide (1)                     - 3 -                     guide (1)




            guide (1) --- Software Tools Subsystem User's Guides     08/27/84


            _E_x_a_m_p_l_e_s

                 guide tutorial
                 guide -p rp | os >/dev/lps/f


            _F_i_l_e_s

                 Most of those contained in =doc=/fguide.


            _S_e_e _A_l_s_o

                 _S_o_f_t_w_a_r_e _T_o_o_l_s _S_u_b_s_y_s_t_e_m _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l












































            guide (1)                     - 4 -                     guide (1)


