


TANGLE(1)                                               TANGLE(1)


NNAAMMEE
       tangle - translate WEB to Pascal

SSYYNNOOPPSSIISS
       ttaannggllee _w_e_b_f_i_l_e_[_._w_e_b_] [ _c_h_a_n_g_e_f_i_l_e_[_._c_h_] ]

DDEESSCCRRIIPPTTIIOONN
       This  manual page is not meant to be exhaustive.  The com-
       plete documentation for this version of TeX can  be  found
       in the info file or manual _W_e_b_2_C_: _A _T_e_X _i_m_p_l_e_m_e_n_t_a_t_i_o_n.

       The  ttaannggllee  program converts a Web source document into a
       Pascal program that may be compiled in the usual way  with
       the  on-line  Pascal  compiler  (e.g., ppcc(1)).  The output
       file is all in lower case and  packed  into  lines  of  72
       characters  or less, with the only concession to readabil-
       ity being the termination of lines at semicolons when this
       can be done conveniently.

       The  Web  language allows you to prepare a single document
       containing all the information that is needed both to pro-
       duce  a  compilable  Pascal program and to produce a well-
       formatted document  describing  the  program  in  as  much
       detail  as the writer may desire.  The user of Web must be
       familiar with both TeX and Pascal.  Web  also  provides  a
       relatively  simple, although adequate, macro facility that
       permits a Pascal program to be written  in  small  easily-
       understood modules.

       The  command  line  should have either one or two names on
       it.  The first is taken as the Web file (and _._w_e_b is added
       if  there  is no extension).  If there is another name, it
       is a change file (and _._c_h is added if there is  no  exten-
       sion).   The  change file overrides parts of the Web file,
       as described in the Web system documentation.

       The output files are a Pascal file and a string pool file,
       whose names are formed by adding _._p and _._p_o_o_l respectively
       to the root of the Web file name.

SSEEEE AALLSSOO
       ppcc(1), ppxxpp(1) (for formatting ttaannggllee  output  when  debug-
       ging), tteexx(1).

       Donald  E.  Knuth, _T_h_e _W_e_b _S_y_s_t_e_m _o_f _S_t_r_u_c_t_u_r_e_d _D_o_c_u_m_e_n_t_a_-
       _t_i_o_n.

       Donald E. Knuth, _L_i_t_e_r_a_t_e  _P_r_o_g_r_a_m_m_i_n_g,  Computer  Journal
       2277, 97-111, 1984.

       Wayne  Sewell,  _W_e_a_v_i_n_g  _a _P_r_o_g_r_a_m, Van Nostrand Reinhold,
       1989, ISBN 0-442-31946-0.

       Donald E. Knuth, _T_e_X_: _T_h_e _P_r_o_g_r_a_m (Volume B  of  _C_o_m_p_u_t_e_r_s



Web2C 7.2                12 February 1993                       1





TANGLE(1)                                               TANGLE(1)


       _a_n_d     _T_y_p_e_s_e_t_t_i_n_g),     Addison-Wesley,    1986,    ISBN
       0-201-13437-3.

       Donald E. Knuth, _M_e_t_a_f_o_n_t_: _T_h_e _P_r_o_g_r_a_m (Volume D  of  _C_o_m_-
       _p_u_t_e_r_s   _a_n_d   _T_y_p_e_s_e_t_t_i_n_g),  Addison-Wesley,  1986,  ISBN
       0-201-13438-1.

       These last two are by far the largest extant  examples  of
       Web programs.

       There  is  an  active  Internet electronic mail discussion
       list on the subject of literate programming; send  a  sub-
       scription request to _l_i_t_p_r_o_g_-_r_e_q_u_e_s_t_@_s_h_s_u_._e_d_u to join.

AAUUTTHHOORRSS
       Web  was  designed by Donald E. Knuth, based on an earlier
       system called DOC (implemented by  Ignacio  Zabala).   The
       ttaannggllee  and  wweeaavvee programs are themselves written in Web.
       The system was originally ported to Unix  at  Stanford  by
       Howard Trickey, and at Cornell by Pavel Curtis.





































Web2C 7.2                12 February 1993                       2


