


NOWEB(7)                                                 NOWEB(7)


NNAAMMEE
       nowebfilters - filters and parsers for use with noweb

SSYYNNOOPPSSIISS
       [nnoowweeaavvee|nnoottaannggllee|nnoowweebb]  [--ffiilltteerr  _f_i_l_t_e_r|--mmaarrkkuupp _p_a_r_s_e_r]
       ...

DDEESSCCRRIIPPTTIIOONN
       This man page documents the various  filters  and  parsers
       that  are  supplied with _n_o_w_e_b_(_1_)_.  A filter, which trans-
       forms the pipeline representation, is used with the  --ffiill--
       tteerr option.  A parser, which reads a source file and emits
       the pipeline representation,  is  used  with  the  --mmaarrkkuupp
       option.   Not all filters and parsers are available at all
       installations.

FFIILLTTEERRSS
       aauuttooddeeffss..**
              _n_o_w_e_a_v_e_'_s --aauuttooddeeffss and --sshhoowwaauuttooddeeffss  options  use
              these  filters,  which  automatically  find defined
              identifiers.  The ** stands for the name of  a  pro-
              gramming language.

       ddiissaammbbiigguuaattee
              The ddiissaammbbiigguuaattee filter makes it possible to abbre-
              viate chunk names using a trailing ellipsis  (three
              periods), in the style of WEB and _n_u_w_e_b_(_1_)_.

       eelliiddee _p_a_t_t_e_r_n_s
              The  eelliiddee  filter removes from the stream any code
              chunk matching any of the arguments.  Each argument
              is a pattern in which ??  matches any single charac-
              ter and ** mmaattcchheess aannyy sseeqquueennccee ooff cchhaarraacctteerrss..

       eemmppttyyddeeffnn
              The eemmppttyyddeeffnn  filter  makes  an  empty  definition
              (<<<<>>>>==)  an  abbreviation for a continuation of the
              previous definition.

       ll22hh [--sshhooww--uunnkknnoowwnnss]
              The ll22hh filter converts LaTeX to HTML in documenta-
              tion  chunks.   If  the  --sshhooww--uunnkknnoowwnnss  options is
              given, unrecognized LaTeX control sequences  appear
              in  bold  in the output.  ll22hh uses the LaTeX-gener-
              ated .toc and .bbl files to help  create  table  of
              contents and bibliography.

PPAARRSSEERRSS
       A parser converts a source file to the noweb pipeline for-
       mat,  interpreting  the  ``markup''  in  that  file.    By
       default, the tools use the standard noweb markup, but some
       installations may support nuweb markup as  well.   Parsers
       include




                          local 4/17/97                         1





NOWEB(7)                                                 NOWEB(7)


       mmaarrkkuupp Converts  standard _n_o_w_e_b_(_1_) markup to pipeline for-
              mat.

       nnuummaarrkkuupp
              Converts _n_u_w_e_b_(_1_) markup to noweb pipeline  format.
              It is not part of the standard installation, but it
              can be found in _n_o_w_e_b's ccoonnttrriibb//nnoorrmmaann directory.

FFIILLEESS
       All filters and parsers are stored in ||LLIIBBDDIIRR||

BBUUGGSS
       It is possible to tell ll22hh about new control sequences  by
       putting   special  TeX  comments  in  one's  documentation
       chunks, but there's no  documentation.   Use  the  source,
       Luke.

       nnuummaarrkkuupp  loses information, e.g., about the proper treat-
       ment of tabs.  It also doesn't compensate  for  _n_o_t_a_n_g_l_e's
       newline-removal  heuristic,  which  means results on _n_u_w_e_b
       files may differ subtly from those produced by _n_u_w_e_b_.

SSEEEE AALLSSOO
       _n_o_w_e_a_v_e_(_1_)_, _n_o_t_a_n_g_l_e_(_1_)_, _n_o_w_e_b_(_1_)
       The _N_o_w_e_b _H_a_c_k_e_r_'_s _G_u_i_d_e

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


