


NOWEB(7)                                                 NOWEB(7)


NNAAMMEE
       nowebstyle - _L_a_T_e_X package for _n_o_w_e_b

SSYYNNOOPPSSIISS
       \\uusseeppaacckkaaggee{{nnoowweebb}}

DDEESSCCRRIIPPTTIIOONN
       When  _n_o_w_e_a_v_e  generates code for _L_a_T_e_X_, the nnoowweebb package
       is required.  In addition  to  the  necessary  arcana,  it
       defines a wweebbccooddee environment in which you can place frag-
       ments of code, and  in  which  only  backslash  and  curly
       braces  have  their special meanings; all other characters
       are taken literally.  It also defines a  nnoowweebb  pagestyle.
       Finally,  it defines a \\nnoowweebbooppttiioonnss{{......}} command that can
       be used to tinker  with  the  appearance  of  the  output.
       Options are separated by commas and include:

       mmaarrggiinnttaagg
              Put  the  sub-page  number (tag) of each code-chunk
              definition in the left margin. (Default)

       nnoommaarrggiinnttaagg
              Don't use margin tags.

       sshhiifftt  Shift text to the left  so  that  long  code  lines
              won't extend off the right-hand side of the page.

       ssmmaallllccooddee
              Set  code  in _L_a_T_e_X \\ssmmaallll font instead of \\nnoorrmmaall--
              ssiizzee..

       lloonnggxxrreeff,, sshhoorrttxxrreeff
              Use either long, Knuth-style chunk cross-reference,
              or  short, Hanson-style chunk cross-reference.  The
              former uses small paragraphs after the  chunk;  the
              latter   uses   symbols  on  the  definition  line.
              Defaults to sshhoorrttxxrreeff..

       aallpphhaassuubbppaaggee,, nnuummssuubbppaaggee,, nnoossuubbppaaggee
              Number chunks by the number of the  page  on  which
              they  appear,  followed  by an alphabetic (numeric,
              not  used)  ``sub-page''  indicator.   Defaults  to
              aallpphhaassuubbppaaggee..  nnoossuubbppaaggee implies nnoommaarrggiinnttaagg..

       wweebbnnuummbbeerriinngg
              Number  chunks consecutively, in _W_E_B style, instead
              of using sub-page numbers.

       hhiiddeeuunnuusseeddddeeffss
              Omit defined but unused identifiers from the  local
              identifier cross-reference (Preston Briggs).

       nnooiiddeennttxxrreeff
              Omit  the  local  identifier  cross-reference which



                          local 4/17/97                         1





NOWEB(7)                                                 NOWEB(7)


              follows each code chunk.

       eexxtteerrnnaalliinnddeexx
              Use an index generated with _n_o_i_n_d_e_x_(_1_) (q.v.).

       lloonnggcchhuunnkkss
              When expanding \\nnoowweebbcchhuunnkkss,, show page  numbers  of
              definitions and uses of each chunk.

CCOONNTTRROOLL SSEEQQUUEENNCCEESS
       The  noweb  package  describes a gazillion special control
       sequences.  Only a few are listed here.

       \\nneexxttcchhuunnkkllaabbeell{{ll}}
              Associates label ll with the sub-page  reference  of
              the  next  code  chunk.  Can be used in for concise
              chunk  cross-reference  with,   e.g.,   cchhuunnkk~~\\ssuubb--
              ppaaggeerreeff{{ll}}.

       \\nnwwaanncchhoorrttoo{{UURRLL}}{{aanncchhoorr tteexxtt}}
              Creates  a  link  to  the  given URL with the given
              anchor text.  Implemented in _l_a_t_e_x_(_1_)  using  foot-
              notes,   but   _s_l_2_h_(_1_)   translates   this   to  <<aa
              hhrreeff==UURRLL>>aanncchhoorr tteexxtt<<//aa>>

       \\nnwwaanncchhoorrnnaammee{{nnaammee}}{{aanncchhoorr tteexxtt}}
              Creates an anchor point for  a  hyperlink.   Imple-
              mented  in  _l_a_t_e_x_(_1_)  using  \\llaabbeell  ,,  but _s_l_2_h_(_1_)
              translates this to <<aa nnaammee==nnaammee>>aanncchhoorr tteexxtt<<//aa>>

       \\iiffhhttmmll ...... \\ffii
              Text  between  \\iiffhhttmmll  and  \\ffii  is   ignored   by
              _l_a_t_e_x_(_1_)_,  but  _s_l_2_h_(_1_)  and  the  _l_2_h noweb filter
              translate the text into HTML.

SSEEEE AALLSSOO
       _n_o_w_e_a_v_e_(_1_)_, _n_o_w_e_b_(_1_)

VVEERRSSIIOONN
       This man page is from _n_o_w_e_b version 2.8a.

AAUUTTHHOORR
       Norman Ramsey, University of Virginia.   Internet  address
       nnrr@@ccss..vviirrggiinniiaa..eedduu.
       Noweb home page at hhttttpp::////wwwwww..ccss..vviirrggiinniiaa..eedduu//~~nnrr//nnoowweebb.












                          local 4/17/97                         2


