


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..  Similar options  exist  for  all  the  _L_a_T_e_X
              size-changing commands.

       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.

       ssuubbssccrriippttiiddeennttss,, nnoossuubbssccrriippttiiddeennttss,, hhyyppeerriiddeennttss,, nnoohhyyppeerrii--
              ddeennttss
              Controls  subscripting  of  identifiers  in   code,
              including  quoted  code.  Selecting ssuubbssccrriippttiiddeennttss
              means an identifier appearing in a code  chunk  (or



                         local 2/16/1998                        1





NOWEB(7)                                                 NOWEB(7)


              in  quoted  code within a documentation chunk) will
              be subscripted with the chunk number of its defini-
              tion.   hhyyppeerriiddeennttss  means such identifiers will be
              hyperlinked  to  their  definitions,  provided   of
              course  that  a  hypertext package like hhyyppeerrrreeff is
              loaded.  nnoossuubbssccrriippttiiddeennttss  and  nnoohhyyppeerriiddeennttss  are
              equivalent,  and  they turn off such markings.  The
              default is hhyyppeerriiddeennttss..

       ssuubbssccrriippttqquuootteeddiiddeennttss,,   nnoossuubbssccrriippttqquuootteeddiiddeennttss,,   hhyyppeerr--
              qquuootteeddii-- ddeennttss,, nnoohhyyppeerrqquuootteeddiiddeennttss
              Controls  linking  of  identifiers  as  above,  but
              applies only to uses of identifiers in quoted code.

       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
              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.



                         local 2/16/1998                        2





NOWEB(7)                                                 NOWEB(7)


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.9a.

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 2/16/1998                        3


