home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 3 / CDPDIII.bin / pd / programming / utils / cweb / amiga / cweb.man < prev    next >
Text File  |  1993-01-21  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. CWEB(1L)                                                 CWEB(1L)
  5.  
  6.  
  7. NNAAMMEE
  8.        ctangle, cweave - translate CWEB to C and/or TeX
  9.  
  10. SSYYNNOOPPSSIISS
  11.        ccttaannggllee  [  --bbhhpp  ]  [  ++ss ] webfile[.w] [changefile[.ch]]
  12.        [outputfile[.c]]
  13.        ccwweeaavvee [ --bbffhhiippxx ] [ ++aaggss ] webfile[.w]  [changefile[.ch]]
  14.        [outputfile[.tex]]
  15.  
  16.  
  17. DDEESSCCRRIIPPTTIIOONN
  18.        The _c_t_a_n_g_l_e program converts a CWEB source document into a
  19.        C program that may be compiled in the usual way.  The out-
  20.        put  file  includes #line specifications so that debugging
  21.        can be done in terms of the CWEB source file.
  22.  
  23.        The _c_w_e_a_v_e program converts the same CWEB file into a  TeX
  24.        file  that  may be formatted and printed in the usual way.
  25.        It takes appropriate care of typographic details like page
  26.        layout  and  the  use  of  indentation, italics, boldface,
  27.        etc., and it supplies  extensive  cross-index  information
  28.        that it gathers automatically.
  29.  
  30.        CWEB  allows  you  to prepare a single document containing
  31.        all the information that is needed both to produce a  com-
  32.        pilable C program and to produce a well-formatted document
  33.        describing the program in as much detail as the writer may
  34.        desire.  The user of CWEB ought to be familiar with TeX as
  35.        well as C.
  36.  
  37.        The command line should have one, two, or three  names  on
  38.        it.   The first is taken as the CWEB file (and .w is added
  39.        if there is no extension). If that file cannot be  opened,
  40.        the  extension  .web  is  tried instead. (But .w is recom-
  41.        mended, since .web usually implies Pascal.)  If there is a
  42.        second  name,  it  is  a  change file (and .ch is added if
  43.        there is no extension).  The change file  overrides  parts
  44.        of  the  WEB  file,  as described in the documentation. If
  45.        there is a third name, it overrides the  default  name  of
  46.        the  output file, which is ordinarily the same as the name
  47.        of the input file (but on the current directory) with  the
  48.        extension .c or .tex.
  49.  
  50.        Options  in the command line may be either turned off with
  51.        - (if they are on by default) or turned on with + (if they
  52.        are  off  by  default). In fact, the options are processed
  53.        from left to right, so a sequence like -f  +f  corresponds
  54.        to +f (which is the default).
  55.  
  56.        The  --bb  option  suppresses  the banner line that normally
  57.        appears on your terminal when ctangle  or  cweave  begins.
  58.        The  --hh  option suppresses the happy message that normally
  59.        appears if the processing was successful.  The  --pp  option
  60.        suppresses  progress  reports  (starred module numbers) as
  61.  
  62.  
  63.  
  64.                              6/15/92                            1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CWEB(1L)                                                 CWEB(1L)
  71.  
  72.  
  73.        the processing takes place. If you say -bhp, you get noth-
  74.        ing but error messages.
  75.  
  76.        The  ++ss option prints statistics about memory usage at the
  77.        end of a run (assuming that the programs  have  been  com-
  78.        piled with the -DSTAT switch).
  79.  
  80.        There  are two other options applicable to _c_w_e_a_v_e only: --ff
  81.        means do not force a newline after every statement in  the
  82.        formatted  output.   --xx  means omit the index and table of
  83.        contents.
  84.  
  85.        In addition to these options the Amiga version  of  _c_w_e_a_v_e
  86.        has  three  more  options:  ++aa  causes Amiga-specific type
  87.        identifiers to be recognized as keywords (e.g. UWORD).  ++gg
  88.        means  that  the German CWEB macros should be used instead
  89.        of the English ones.  --ii causes parameter declarations  at
  90.        function heads not to be indented.
  91.  
  92.  
  93. FFIILLEESS
  94.        cweb/cwebmac.tex    TeX macros used by cweave output.
  95.        amiga/cwebmacg.tex: German TeX macros for cweave output.
  96.        cweb/cwebman.tex    The user manual.
  97.        cweb/examples/wc.w  An introductory example.
  98.  
  99. SSEEEE AALLSSOO
  100.        _L_i_t_e_r_a_t_e _P_r_o_g_r_a_m_m_i_n_g by D.E. Knuth.
  101.        _W_e_a_v_i_n_g _a _P_r_o_g_r_a_m by Wayne Sewell
  102.        tex(1), cc(1)
  103.  
  104. AAUUTTHHOORRSS
  105.        Don  Knuth  wrote  WEB  for  TeX  and  Pascal. Silvio Levy
  106.        designed and developed CWEB by adapting  the  WEB  conven-
  107.        tions  to  C  and  by  recoding everything in CWEB.  Knuth
  108.        began using CWEB and made further refinements.
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                              6/15/92                            2
  131.  
  132.  
  133.