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,, nnooxxrreeff
              Choose  a  style  for  chunk cross-reference.  Long
              style uses  small paragraphs after each  chunk,  as
              in  Knuth.  Short style uses symbols on the defini-
              tion line, as in Hanson.  nnooxxrreeff provides no  chunk
              cross-reference.  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
              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id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.

       eenngglliisshh,, ffrreenncchh,, ggeerrmmaann,, ppoorrttuuggeess
              Write cross-reference information in  the  language
              specified.  Defaults to eenngglliisshh..

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

AAUUTTHHOORR
       Norman  Ramsey,  Harvard  University.   Internet   address
       nnrr@@eeeeccss..hhaarrvvaarrdd..eedduu.
       Noweb  home page at hhttttpp::////wwwwww..eeeeccss..hhaarrvvaarrdd..eedduu//~~nnrr//nnoowweebb.




                         local 3/28/2001                 NOWEB(7)
