Running tangle on the web file would produce a complete Pascal program, ready for compilation by an ordinary Pascal compiler. The primary function of tangle is to allow the programmer to present elements of the program in any desired order, regardless of the restrictions imposed by the programming language. Thus, the programmer is free to present his program in a top-down fashion, bottom-up fashion, or whatever seems best in terms of promoting understanding and maintenance.
Running weave on the web file would produce a TeX file, ready to be processed by TeX. The resulting document included a variety of automatically generated indices and cross-references that made it much easier to navigate the code. Additionally, all of the code sections were automatically pretty printed, resulting in a quite impressive document.
Knuth also wrote the programs for TeX and METAFONT entirely in WEB, eventually publishing them in book form [cite tex:program,metafont:program]. These are probably the largest programs ever published in a readable form.
Inspired by Knuth's example, many people have experimented with WEB. Some people have even built web-like tools for their own favorite combinations of programming language and typesetting language. For example, CWEB, Knuth's current system of choice, works with a combination of C (or C++) and TeX [cite levy:90]. Another system, FunnelWeb, is independent of any programming language and only mildly dependent on TeX [cite funnelweb]. Inspired by the versatility of FunnelWeb and by the daunting size of its documentation, I decided to write my own, very simple, tool for literate programming. [There is another system similar to mine, written by Norman Ramsey, called noweb [cite noweb]. It perhaps suffers from being overly Unix-dependent and requiring several programs to use. On the other hand, its command syntax is very nice. In any case, nuweb certainly owes its name and a number of features to his inspiration.]
A further reduction in compilation time is achieved by first writing each output file to a temporary location, then comparing the temporary file with the old version of the file. If there is no difference, the temporary file can be deleted. If the files differ, the old version is deleted and the temporary file renamed. This approach works well in combination with make (or similar tools), since make will avoid recompiling untouched output files.
@d Check for terminating at-sequence and return name if foundTherefore, we provide a mechanism (stolen from Knuth) of indicating abbreviated names.
@d Check for terminating...Basically, the programmer need only type enough characters to uniquely identify the macro name, followed by three periods. An abbreviation may even occur before the full version; nuweb simply preserves the longest version of a macro name. Note also that blanks and tabs are insignificant in a macro name; any string of them are replaced by a single blank.
When scraps are written to a program file or a documentation file, tabs are expanded into spaces by default. Currently, I assume tab stops are set every eight characters. Furthermore, when a macro is expanded in a scrap, the body of the macro is indented to match the indentation of the macro invocation. Therefore, care must be taken with languages (e.g., Fortran) that are sensitive to indentation. These default behaviors may be changed for each output file (see below).
Identifiers must be explicitly specified for inclusion in the @u index. By convention, each identifier is marked at the point of its definition; all references to each identifier (inside scraps) will be discovered automatically. To ``mark'' an identifier for inclusion in the index, we must mention it at the end of a scrap. For example,
I've used alphabetic identifiers in this example, but any string of characters (not including whitespace or @ characters) will do. Therefore, it's possible to add index entries for things like <<= if desired. An identifier may be declared in more than one scrap.@d a scrap @{ Let's pretend we're declaring the variables FOO and BAR inside this scrap. @| FOO BAR @}
In the generated index, each identifier appears with a list of all the scraps using and defining it, where the defining scraps are distinguished by underlining. Note that the identifier doesn't actually have to appear in the defining scrap; it just has to be in the list of definitions at the end of a scrap.
nuweb flags file-name...One or more files may be processed at a time. If a file name has no extension, .w will be appended. LaTeX suitable for translation into HTML by LaTeX2HTML will be produced from files whose name ends with .hw, otherwise, ordinary LaTeX will be produced. While a file name may specify a file in another directory, the resulting documentation file will always be created in the current directory. For example,
nuweb /foo/bar/quuxwill take as input the file /foo/bar/quux.w and will create the file quux.tex in the current directory.
By default, nuweb performs both tangling and weaving at the same time. Normally, this is not a bottleneck in the compilation process; however, it's possible to achieve slightly faster throughput by avoiding one or another of the default functions using command-line flags. There are currently three possible flags:
nuweb -to /foo/bar/quuxwould simply scan the input and produce no output at all.
There are two additional command-line flags:
While preparing a web, you may want to view the program's scraps without taking the time to run LaTeX2HTML. Simply rename the generated LaTeX source so that its file name ends with .html, and view that file. The documentations section will be jumbled, but the scraps will be clear.
<global.h>= <Include files> <Type declarations> <Global variable declarations> <Function prototypes>
This code is written to a file (or else not used).
We'll need at least three of the standard system include files.
<Include files>= #include <stdlib.h> #include <stdio.h> #include <string.h> #include <ctype.h>
Definesexit
,fclose
,FILE
,fopen
,fprintf
,fputs
,getc
,isgraph
,islower
,isspace
,isupper
,malloc
,putc
,remove
,size_t
,stderr
,strlen
,tempnam
,toupper
(links are to index).Used above.
I also like to use TRUE and FALSE in my code.
I'd use an enum here, except that some systems seem to provide
definitions of TRUE and FALSE be default. The following
code seems to work on all the local systems.
<Type declarations>= #ifndef FALSE #define FALSE 0 #endif #ifndef TRUE #define TRUE 1 #endif
DefinesFALSE
,TRUE
(links are to index).
T
he Main Files
The code is divided into four main files (introduced here) and five
support files (introduced in the next section).
The file main.c will contain the driver for the whole program
(see Section [->]).
<main.c>= #include "global.h"
This code is written to a file (or else not used).Next definition.
The first pass over the source file is contained in pass1.c. It handles collection of all the file names, macros names, and scraps (see Section [->]).
<pass1.c>= #include "global.h"
This code is written to a file (or else not used).Next definition.
The .tex file is created during a second pass over the source file. The file latex.c contains the code controlling the construction of the .tex file (see Section [->]).
<latex.c>= #include "global.h"
This code is written to a file (or else not used).Next definition.
The file html.c contains the code controlling the construction of the .tex file appropriate for use with LaTeX2HTML (see Section [->]).
<html.c>= #include "global.h"
This code is written to a file (or else not used).Next definition.
The code controlling the creation of the output files is in output.c (see Section [->]).
<output.c>= #include "global.h"
This code is written to a file (or else not used).Next definition.
<input.c>= #include "global.h"
This code is written to a file (or else not used).Next definition.
Creation and lookup of scraps is handled by routines in scraps.c (see Section [->]).
<scraps.c>= #include "global.h"
This code is written to a file (or else not used).Next definition.
The handling of file names and macro names is detailed in names.c (see Section [->]).
<names.c>= #include "global.h"
This code is written to a file (or else not used).Next definition.
Memory allocation and deallocation is handled by routines in arena.c (see Section [->]).
<arena.c>= #include "global.h"
This code is written to a file (or else not used).Next definition.
Finally, for best portability, I seem to need a file containing (useless!) definitions of all the global variables.
<global.c>= #include "global.h" <Global variable definitions>
This code is written to a file (or else not used).
T
he Main Routine [*]
The main routine is quite simple in structure.
It wades through the optional command-line arguments,
then handles any files listed on the command line.
<main.c>+= int main(argc, argv) int argc; char **argv; { int arg = 1; <Interpret command-line arguments> <Process the remaining arguments (file names)> exit(0); }
Definesmain
(links are to index).Previous definition.
Global flags are declared for each of the arguments.
<Global variable declarations>= extern int tex_flag; /* if FALSE, don't emit the documentation file */ extern int html_flag; /* if TRUE, emit HTML instead of LaTeX scraps. */ extern int output_flag; /* if FALSE, don't emit the output files */ extern int compare_flag; /* if FALSE, overwrite without comparison */ extern int verbose_flag; /* if TRUE, write progress information */ extern int number_flag; /* if TRUE, use a sequential numbering scheme */
Definescompare_flag
,html_flag
,number_flag
,output_flag
,tex_flag
,verbose_flag
(links are to index).
The flags are all initialized for correct default behavior.
<Global variable definitions>= int tex_flag = TRUE; int html_flag = FALSE; int output_flag = TRUE; int compare_flag = TRUE; int verbose_flag = FALSE; int number_flag = FALSE;
Used above; next definition.
We save the invocation name of the command in a global variable command_name for use in error messages.
<Global variable declarations>+= extern char *command_name;
Definescommand_name
(links are to index).Used above; previous and next definitions.
<Global variable definitions>+= char *command_name = NULL;
Used above; previous and next definitions.
The invocation name is conventionally passed in argv[0].
<Interpret command-line arguments>= command_name = argv[0];
Used above; next definition.
We need to examine the remaining entries in argv, looking for command-line arguments.
<Interpret command-line arguments>+= while (arg < argc) { char *s = argv[arg]; if (*s++ == '-') { <Interpret the argument string s> arg++; } else break; }
Used above; previous definition.
Several flags can be stacked behind a single minus sign; therefore, we've got to loop through the string, handling them all.
<Interpret the argument string s>= { char c = *s++; while (c) { switch (c) { case 'c': compare_flag = FALSE; break; case 'n': number_flag = TRUE; break; case 'o': output_flag = FALSE; break; case 't': tex_flag = FALSE; break; case 'v': verbose_flag = TRUE; break; default: fprintf(stderr, "%s: unexpected argument ignored. ", command_name); fprintf(stderr, "Usage is: %s [-cnotv] file...\n", command_name); break; } c = *s++; } }
Used above.
F
ile Names
We expect at least one file name. While a missing file name might be
ignored without causing any problems, we take the opportunity to report
the usage convention.
<Process the remaining arguments (file names)>= { if (arg >= argc) { fprintf(stderr, "%s: expected a file name. ", command_name); fprintf(stderr, "Usage is: %s [-cnotv] file-name...\n", command_name); exit(-1); } do { <Handle the file name in argv[arg]> arg++; } while (arg < argc); }
Used above.
The code to handle a particular file name is rather more tedious than
the actual processing of the file. A file name may be an arbitrarily
complicated path name, with an optional extension. If no extension is
present, we add .w as a default. The extended path name will be
kept in a local variable source_name. The resulting documentation
file will be written in the current directory; its name will be kept
in the variable tex_name.
<Handle the file name in argv[arg]>= { char source_name[100]; char tex_name[100]; char aux_name[100]; <Build source_name and tex_name> <Process a file> }
Used above.
I bump the pointer p through all the characters in argv[arg], copying all the characters into source_name (via the pointer q).
At each slash, I update trim to point just past the slash in source_name. The effect is that trim will point at the file name without any leading directory specifications.
The pointer dot is made to point at the file name extension, if present. If there is no extension, we add .w to the source name. In any case, we create the tex_name from trim, taking care to get the correct extension. The html_flag is set in this scrap.
<Build source_name and tex_name>= { char *p = argv[arg]; char *q = source_name; char *trim = q; char *dot = NULL; char c = *p++; while (c) { *q++ = c; if (c == '/') { trim = q; dot = NULL; } else if (c == '.') dot = q - 1; c = *p++; } *q = '\0'; if (dot) { *dot = '\0'; /* produce HTML when the file extension is ".hw" */ html_flag = dot[1] == 'h' && dot[2] == 'w' && dot[3] == '\0'; sprintf(tex_name, "%s.tex", trim); sprintf(aux_name, "%s.aux", trim); *dot = '.'; } else { sprintf(tex_name, "%s.tex", trim); sprintf(aux_name, "%s.aux", trim); *q++ = '.'; *q++ = 'w'; *q = '\0'; } }
Used above.
Now that we're finally ready to process a file, it's not really too complex. We bundle most of the work into four routines pass1 (see Section [->]), write_tex (see Section [->]), write_html (see Section [->]), and write_files (see Section [->]). After we're finished with a particular file, we must remember to release its storage (see Section [->]). The sequential numbering of scraps is forced when generating HTML.
<Process a file>= { pass1(source_name); if (tex_flag) { if (html_flag) { int saved_number_flag = number_flag; number_flag = TRUE; collect_numbers(aux_name); write_html(source_name, tex_name); number_flag = saved_number_flag; } else { collect_numbers(aux_name); write_tex(source_name, tex_name); } } if (output_flag) write_files(file_names); arena_free(); }
Used above.
<Function prototypes>= extern void pass1();
Used above; next definition.
The routine pass1 takes a single argument, the name of the source file. It opens the file, then initializes the scrap structures (see Section [->]) and the roots of the file-name tree, the macro-name tree, and the tree of user-specified index entries (see Section [->]). After completing all the necessary preparation, we make a pass over the file, filling in all our data structures. Next, we seach all the scraps for references to the user-specified index entries. Finally, we must reverse all the cross-reference lists accumulated while scanning the scraps.
<pass1.c>+= void pass1(file_name) char *file_name; { if (verbose_flag) fprintf(stderr, "reading %s\n", file_name); source_open(file_name); init_scraps(); macro_names = NULL; file_names = NULL; user_names = NULL; <Scan the source file, looking for at-sequences> if (tex_flag) search(); <Reverse cross-reference lists> }
Definespass1
(links are to index).Previous definition.
The only thing we look for in the first pass are the command sequences. All ordinary text is skipped entirely.
<Scan the source file, looking for at-sequences>= { int c = source_get(); while (c != EOF) { if (c == '@') <Scan at-sequence> c = source_get(); } }
Used above.
Only four of the at-sequences are interesting during the first pass. We skip past others immediately; warning if unexpected sequences are discovered.
<Scan at-sequence>= { c = source_get(); switch (c) { case 'O': case 'o': <Build output file definition> break; case 'D': case 'd': <Build macro definition> break; case '@': case 'u': case 'm': case 'f': /* ignore during this pass */ break; default: fprintf(stderr, "%s: unexpected @ sequence ignored (%s, line %d)\n", command_name, source_name, source_line); break; } }
Used above.
A
ccumulating Definitions
There are three steps required to handle a definition:
<Build output file definition>= { Name *name = collect_file_name(); /* returns a pointer to the name entry */ int scrap = collect_scrap(); /* returns an index to the scrap */ <Add scrap to name's definition list> }
Used above.
<Build macro definition>= { Name *name = collect_macro_name(); int scrap = collect_scrap(); <Add scrap to name's definition list> }
Used above.
Since a file or macro may be defined by many scraps, we maintain them in a simple linked list. The list is actually built in reverse order, with each new definition being added to the head of the list.
<Add scrap to name's definition list>= { Scrap_Node *def = (Scrap_Node *) arena_getmem(sizeof(Scrap_Node)); def->scrap = scrap; def->next = name->defs; name->defs = def; }
Used above (1), above (2).
F
ixing the Cross References
Since the definition and reference lists for each name are accumulated
in reverse order, we take the time at the end of pass1 to
reverse them all so they'll be simpler to print out prettily.
The code for reverse_lists appears in Section [->].
<Reverse cross-reference lists>= { reverse_lists(file_names); reverse_lists(macro_names); reverse_lists(user_names); }
Used above.
Note that all the formatting is handled in this section. If you don't like the format of definitions or indices or whatever, it'll be in this section somewhere. Similarly, if someone wanted to modify nuweb to work with a different typesetting system, this would be the place to look.
<Function prototypes>+= extern void write_tex();
Used above; previous and next definitions.
We need a few local function declarations before we get into the body of write_tex.
<latex.c>+= static void copy_scrap(); /* formats the body of a scrap */ static void print_scrap_numbers(); /* formats a list of scrap numbers */ static void format_entry(); /* formats an index entry */ static void format_user_entry();
Previous and next definitions.
The routine write_tex takes two file names as parameters: the name of the web source file and the name of the .tex output file.
<latex.c>+= void write_tex(file_name, tex_name) char *file_name; char *tex_name; { FILE *tex_file = fopen(tex_name, "w"); if (tex_file) { if (verbose_flag) fprintf(stderr, "writing %s\n", tex_name); source_open(file_name); <Copy source_file into tex_file> fclose(tex_file); } else fprintf(stderr, "%s: can't open %s\n", command_name, tex_name); }
Defineswrite_tex
(links are to index).Previous and next definitions.
We make our second (and final) pass through the source web, this time copying characters straight into the .tex file. However, we keep an eye peeled for @ characters, which signal a command sequence.
<Copy source_file into tex_file>= { int scraps = 1; int c = source_get(); while (c != EOF) { if (c == '@') <Interpret at-sequence> else { putc(c, tex_file); c = source_get(); } } }
Used above.
<Interpret at-sequence>= { int big_definition = FALSE; c = source_get(); switch (c) { case 'O': big_definition = TRUE; case 'o': <Write output file definition> break; case 'D': big_definition = TRUE; case 'd': <Write macro definition> break; case 'f': <Write index of file names> break; case 'm': <Write index of macro names> break; case 'u': <Write index of user-specified names> break; case '@': putc(c, tex_file); default: c = source_get(); break; } }
Used above.
\begin{flushleft} \small \begin{minipage}{\linewidth} \label{scrap37} $\langle$Interpret at-sequence {\footnotesize 18}$\rangle\equiv$ \vspace{-1ex} \begin{list}{}{} \item \mbox{}\verb@{@\\ \mbox{}\verb@ int big_definition = FALSE;@\\ \mbox{}\verb@ c = source_get();@\\ \mbox{}\verb@ switch (c) {@\\ \mbox{}\verb@ case 'O': big_definition = TRUE;@\\ \mbox{}\verb@ case 'o': @$\langle$Write output file definition {\footnotesize 19a}$\rangle$\verb@@\\...
\mbox{}\verb@ case '@{\tt @}\verb@': putc(c, tex_file);@\\ \mbox{}\verb@ default: c = source_get();@\\ \mbox{}\verb@ break;@\\ \mbox{}\verb@ }@\\ \mbox{}\verb@}@$\Diamond$ \end{list} \vspace{-1ex} \footnotesize\addtolength{\baselineskip}{-1ex} \begin{list}{}{\setlength{\itemsep}{-\parsep}\setlength{\itemindent}{-\leftmargin}} \item Macro referenced in scrap 17b. \end{list} \end{minipage}\\[4ex] \end{flushleft}
The flushleft environment is used to avoid LaTeX warnings about underful lines. The minipage environment is used to avoid page breaks in the middle of scraps. The verb command allows arbitrary characters to be printed (however, note the special handling of the @ case in the switch statement).
Macro and file definitions are formatted nearly identically. I've factored the common parts out into separate scraps.
<Write output file definition>= { Name *name = collect_file_name(); <Begin the scrap environment> fprintf(tex_file, "\\verb@\"%s\"@ {\\footnotesize ", name->spelling); write_single_scrap_ref(tex_file, scraps++); fputs(" }$\\equiv$\n", tex_file); <Fill in the middle of the scrap environment> <Write file defs> <Finish the scrap environment> }
Used above.
I don't format a macro name at all specially, figuring the programmer might want to use italics or bold face in the midst of the name.
<Write macro definition>= { Name *name = collect_macro_name(); <Begin the scrap environment> fprintf(tex_file, "$\\langle$%s {\\footnotesize ", name->spelling); write_single_scrap_ref(tex_file, scraps++); fputs("}$\\rangle\\equiv$\n", tex_file); <Fill in the middle of the scrap environment> <Write macro defs> <Write macro refs> <Finish the scrap environment> }
Used above.
<Begin the scrap environment>= { fputs("\\begin{flushleft} \\small", tex_file); if (!big_definition) fputs("\n\\begin{minipage}{\\linewidth}", tex_file); fprintf(tex_file, " \\label{scrap%d}\n", scraps); }
Used above (1), above (2).
The interesting things here are the <> inserted at the end of each scrap and the various spacing commands. The diamond helps to clearly indicate the end of a scrap. The spacing commands were derived empirically; they may be adjusted to taste.
<Fill in the middle of the scrap environment>= { fputs("\\vspace{-1ex}\n\\begin{list}{}{} \\item\n", tex_file); copy_scrap(tex_file); fputs("$\\Diamond$\n\\end{list}\n", tex_file); }
Used above (1), above (2).
We've got one last spacing command, controlling the amount of white
space after a scrap.
Note also the whitespace eater. I use it to remove any blank lines that appear after a scrap in the source file. This way, text following a scrap will not be indented. Again, this is a matter of personal taste.
<Finish the scrap environment>= { if (!big_definition) fputs("\\end{minipage}\\\\[4ex]\n", tex_file); fputs("\\end{flushleft}\n", tex_file); do c = source_get(); while (isspace(c)); }
Used above (1), above (2).
F
ormatting Cross References
<Write file defs>= { if (name->defs->next) { fputs("\\vspace{-1ex}\n", tex_file); fputs("\\footnotesize\\addtolength{\\baselineskip}{-1ex}\n", tex_file); fputs("\\begin{list}{}{\\setlength{\\itemsep}{-\\parsep}", tex_file); fputs("\\setlength{\\itemindent}{-\\leftmargin}}\n", tex_file); fputs("\\item File defined by scraps ", tex_file); print_scrap_numbers(tex_file, name->defs); fputs("\\end{list}\n", tex_file); } else fputs("\\vspace{-2ex}\n", tex_file); }
Used above.
<Write macro defs>= { fputs("\\vspace{-1ex}\n", tex_file); fputs("\\footnotesize\\addtolength{\\baselineskip}{-1ex}\n", tex_file); fputs("\\begin{list}{}{\\setlength{\\itemsep}{-\\parsep}", tex_file); fputs("\\setlength{\\itemindent}{-\\leftmargin}}\n", tex_file); if (name->defs->next) { fputs("\\item Macro defined by scraps ", tex_file); print_scrap_numbers(tex_file, name->defs); } }
Used above.
<Write macro refs>= { if (name->uses) { if (name->uses->next) { fputs("\\item Macro referenced in scraps ", tex_file); print_scrap_numbers(tex_file, name->uses); } else { fputs("\\item Macro referenced in scrap ", tex_file); write_single_scrap_ref(tex_file, name->uses->scrap); fputs(".\n", tex_file); } } else { fputs("\\item Macro never referenced.\n", tex_file); fprintf(stderr, "%s: <%s> never referenced.\n", command_name, name->spelling); } fputs("\\end{list}\n", tex_file); }
Used above.
<latex.c>+= static void print_scrap_numbers(tex_file, scraps) FILE *tex_file; Scrap_Node *scraps; { int page; write_scrap_ref(tex_file, scraps->scrap, TRUE, &page); scraps = scraps->next; while (scraps) { write_scrap_ref(tex_file, scraps->scrap, FALSE, &page); scraps = scraps->next; } fputs(".\n", tex_file); }
Definesprint_scrap_numbers
(links are to index).Previous and next definitions.
F
ormatting a Scrap
We add a \mbox{} at the beginning of each line to avoid
problems with older versions of TeX.
<latex.c>+= static void copy_scrap(file) FILE *file; { int indent = 0; int c = source_get(); fputs("\\mbox{}\\verb@", file); while (1) { switch (c) { case '@': <Check at-sequence for end-of-scrap> break; case '\n': fputs("@\\\\\n\\mbox{}\\verb@", file); indent = 0; break; case '\t': <Expand tab into spaces> break; default: putc(c, file); indent++; break; } c = source_get(); } }
Definescopy_scrap
(links are to index).Previous and next definitions.
<Expand tab into spaces>= { int delta = 8 - (indent % 8); indent += delta; while (delta > 0) { putc(' ', file); delta--; } }
Used above (1), below (2), below (3).
<Check at-sequence for end-of-scrap>= { c = source_get(); switch (c) { case '@': fputs("@{\\tt @}\\verb@", file); break; case '|': <Skip over index entries> case '}': putc('@', file); return; case '<': <Format macro name> break; default: /* ignore these since pass1 will have warned about them */ break; } }
Used above.
There's no need to check for errors here, since we will have already pointed out any during the first pass.
<Skip over index entries>= { do { do c = source_get(); while (c != '@'); c = source_get(); } while (c != '}'); }
Used above (1), below (2).
<Format macro name>= { Name *name = collect_scrap_name(); fprintf(file, "@$\\langle$%s {\\footnotesize ", name->spelling); if (name->defs) <Write abbreviated definition list> else { putc('?', file); fprintf(stderr, "%s: scrap never defined <%s>\n", command_name, name->spelling); } fputs("}$\\rangle$\\verb@", file); }
Used above.
<Write abbreviated definition list>= { Scrap_Node *p = name->defs; write_single_scrap_ref(file, p->scrap); p = p->next; if (p) fputs(", \\ldots\\ ", file); }
Used above.
G
enerating the Indices
<Write index of file names>= { if (file_names) { fputs("\n{\\small\\begin{list}{}{\\setlength{\\itemsep}{-\\parsep}", tex_file); fputs("\\setlength{\\itemindent}{-\\leftmargin}}\n", tex_file); format_entry(file_names, tex_file, TRUE); fputs("\\end{list}}", tex_file); } c = source_get(); }
Used above.
<Write index of macro names>= { if (macro_names) { fputs("\n{\\small\\begin{list}{}{\\setlength{\\itemsep}{-\\parsep}", tex_file); fputs("\\setlength{\\itemindent}{-\\leftmargin}}\n", tex_file); format_entry(macro_names, tex_file, FALSE); fputs("\\end{list}}", tex_file); } c = source_get(); }
Used above.
<latex.c>+= static void format_entry(name, tex_file, file_flag) Name *name; FILE *tex_file; int file_flag; { while (name) { format_entry(name->llink, tex_file, file_flag); <Format an index entry> name = name->rlink; } }
Definesformat_entry
(links are to index).Previous and next definitions.
<Format an index entry>= { fputs("\\item ", tex_file); if (file_flag) { fprintf(tex_file, "\\verb@\"%s\"@ ", name->spelling); <Write file's defining scrap numbers> } else { fprintf(tex_file, "$\\langle$%s {\\footnotesize ", name->spelling); <Write defining scrap numbers> fputs("}$\\rangle$ ", tex_file); <Write referencing scrap numbers> } putc('\n', tex_file); }
Used above.
<Write file's defining scrap numbers>= { Scrap_Node *p = name->defs; fputs("{\\footnotesize Defined by scrap", tex_file); if (p->next) { fputs("s ", tex_file); print_scrap_numbers(tex_file, p); } else { putc(' ', tex_file); write_single_scrap_ref(tex_file, p->scrap); putc('.', tex_file); } putc('}', tex_file); }
Used above.
<Write defining scrap numbers>= { Scrap_Node *p = name->defs; if (p) { int page; write_scrap_ref(tex_file, p->scrap, TRUE, &page); p = p->next; while (p) { write_scrap_ref(tex_file, p->scrap, FALSE, &page); p = p->next; } } else putc('?', tex_file); }
Used above.
<Write referencing scrap numbers>= { Scrap_Node *p = name->uses; fputs("{\\footnotesize ", tex_file); if (p) { fputs("Referenced in scrap", tex_file); if (p->next) { fputs("s ", tex_file); print_scrap_numbers(tex_file, p); } else { putc(' ', tex_file); write_single_scrap_ref(tex_file, p->scrap); putc('.', tex_file); } } else fputs("Not referenced.", tex_file); putc('}', tex_file); }
Used above.
<Write index of user-specified names>= { if (user_names) { fputs("\n{\\small\\begin{list}{}{\\setlength{\\itemsep}{-\\parsep}", tex_file); fputs("\\setlength{\\itemindent}{-\\leftmargin}}\n", tex_file); format_user_entry(user_names, tex_file); fputs("\\end{list}}", tex_file); } c = source_get(); }
Used above.
<latex.c>+= static void format_user_entry(name, tex_file) Name *name; FILE *tex_file; { while (name) { format_user_entry(name->llink, tex_file); <Format a user index entry> name = name->rlink; } }
Definesformat_user_entry
(links are to index).Previous definition.
<Format a user index entry>= { Scrap_Node *uses = name->uses; if (uses) { int page; Scrap_Node *defs = name->defs; fprintf(tex_file, "\\item \\verb@%s@: ", name->spelling); if (uses->scrap < defs->scrap) { write_scrap_ref(tex_file, uses->scrap, TRUE, &page); uses = uses->next; } else { if (defs->scrap == uses->scrap) uses = uses->next; fputs("\\underline{", tex_file); write_single_scrap_ref(tex_file, defs->scrap); putc('}', tex_file); page = -2; defs = defs->next; } while (uses || defs) { if (uses && (!defs || uses->scrap < defs->scrap)) { write_scrap_ref(tex_file, uses->scrap, FALSE, &page); uses = uses->next; } else { if (uses && defs->scrap == uses->scrap) uses = uses->next; fputs(", \\underline{", tex_file); write_single_scrap_ref(tex_file, defs->scrap); putc('}', tex_file); page = -2; defs = defs->next; } } fputs(".\n", tex_file); } }
Used above.
<Function prototypes>+= extern void write_html();
Used above; previous and next definitions.
We need a few local function declarations before we get into the body of write_html.
<html.c>+= static void copy_scrap(); /* formats the body of a scrap */ static void display_scrap_ref(); /* formats a scrap reference */ static void display_scrap_numbers(); /* formats a list of scrap numbers */ static void print_scrap_numbers(); /* pluralizes scrap formats list */ static void format_entry(); /* formats an index entry */ static void format_user_entry();
Previous and next definitions.
The routine write_html takes two file names as parameters: the name of the web source file and the name of the .tex output file.
<html.c>+= void write_html(file_name, html_name) char *file_name; char *html_name; { FILE *html_file = fopen(html_name, "w"); if (html_file) { if (verbose_flag) fprintf(stderr, "writing %s\n", html_name); source_open(file_name); <Copy source_file into html_file> fclose(html_file); } else fprintf(stderr, "%s: can't open %s\n", command_name, html_name); }
Defineswrite_html
(links are to index).Previous and next definitions.
We make our second (and final) pass through the source web, this time copying characters straight into the .tex file. However, we keep an eye peeled for @ characters, which signal a command sequence.
<Copy source_file into html_file>= { int scraps = 1; int c = source_get(); while (c != EOF) { if (c == '@') <Interpret HTML at-sequence> else { putc(c, html_file); c = source_get(); } } }
Used above.
<Interpret HTML at-sequence>= { c = source_get(); switch (c) { case 'O': case 'o': <Write HTML output file definition> break; case 'D': case 'd': <Write HTML macro definition> break; case 'f': <Write HTML index of file names> break; case 'm': <Write HTML index of macro names> break; case 'u': <Write HTML index of user-specified names> break; case '@': putc(c, html_file); default: c = source_get(); break; } }
Used above.
<pre> <a name="nuweb68"><Interpret HTML at-sequence 68></a> = { c = source_get(); switch (c) { case 'O': case 'o': <Write HTML output file definition <a href="#nuweb69">69</a>> break; case 'D': case 'd': <Write HTML macro definition <a href="#nuweb71">71</a>> break; case 'f': <Write HTML index of file names <a href="#nuweb86">86</a>> break; case 'm': <Write HTML index of macro names <a href="#nuweb87">87</a>> break; case 'u': <Write HTML index of user-specified names <a href="#nuweb93">93</a>> break; case '@': putc(c, html_file); default: c = source_get(); break; } }<></pre> Macro referenced in scrap <a href="#nuweb67">67</a>. <br>Macro and file definitions are formatted nearly identically. I've factored the common parts out into separate scraps.
<Write HTML output file definition>= { Name *name = collect_file_name(); <Begin HTML scrap environment> <Write HTML output file declaration> scraps++; <Fill in the middle of HTML scrap environment> <Write HTML file defs> <Finish HTML scrap environment> }
Used above.
<Write HTML output file declaration>= fputs("<a name=\"nuweb", html_file); write_single_scrap_ref(html_file, scraps); fprintf(html_file, "\"><code>\"%s\"</code> ", name->spelling); write_single_scrap_ref(html_file, scraps); fputs("</a> =\n", html_file);
Used above.
<Write HTML macro definition>= { Name *name = collect_macro_name(); <Begin HTML scrap environment> <Write HTML macro declaration> scraps++; <Fill in the middle of HTML scrap environment> <Write HTML macro defs> <Write HTML macro refs> <Finish HTML scrap environment> }
Used above.
I don't format a macro name at all specially, figuring the programmer might want to use italics or bold face in the midst of the name. Note that in this implementation, programmers may only use directives in macro names that are recognized in preformatted text elements (PRE).
<Write HTML macro declaration>= fputs("<a name=\"nuweb", html_file); write_single_scrap_ref(html_file, scraps); fprintf(html_file, "\"><%s ", name->spelling); write_single_scrap_ref(html_file, scraps); fputs("></a> =\n", html_file);
Used above.
<Begin HTML scrap environment>= { fputs("\\begin{rawhtml}\n", html_file); fputs("<pre>\n", html_file); }
Used above (1), above (2).
The end of a scrap is marked with the characters <>.
<Fill in the middle of HTML scrap environment>= { copy_scrap(html_file); fputs("<></pre>\n", html_file); }
Used above (1), above (2).
The only task remaining is to get rid of the current at command and end the paragraph.
<Finish HTML scrap environment>= { fputs("\\end{rawhtml}\n", html_file); c = source_get(); /* Get rid of current at command. */ }
Used above (1), above (2).
F
ormatting Cross References
<Write HTML file defs>= { if (name->defs->next) { fputs("File defined by ", html_file); print_scrap_numbers(html_file, name->defs); fputs("<br>\n", html_file); } }
Used above.
<Write HTML macro defs>= { if (name->defs->next) { fputs("Macro defined by ", html_file); print_scrap_numbers(html_file, name->defs); fputs("<br>\n", html_file); } }
Used above.
<Write HTML macro refs>= { if (name->uses) { fputs("Macro referenced in ", html_file); print_scrap_numbers(html_file, name->uses); } else { fputs("Macro never referenced.\n", html_file); fprintf(stderr, "%s: <%s> never referenced.\n", command_name, name->spelling); } fputs("<br>\n", html_file); }
Used above.
<html.c>+= static void display_scrap_ref(html_file, num) FILE *html_file; int num; { fputs("<a href=\"#nuweb", html_file); write_single_scrap_ref(html_file, num); fputs("\">", html_file); write_single_scrap_ref(html_file, num); fputs("</a>", html_file); }
Definesdisplay_scrap_ref
(links are to index).Previous and next definitions.
<html.c>+= static void display_scrap_numbers(html_file, scraps) FILE *html_file; Scrap_Node *scraps; { display_scrap_ref(html_file, scraps->scrap); scraps = scraps->next; while (scraps) { fputs(", ", html_file); display_scrap_ref(html_file, scraps->scrap); scraps = scraps->next; } }
Definesdisplay_scrap_numbers
(links are to index).Previous and next definitions.
<html.c>+= static void print_scrap_numbers(html_file, scraps) FILE *html_file; Scrap_Node *scraps; { fputs("scrap", html_file); if (scraps->next) fputc('s', html_file); fputc(' ', html_file); display_scrap_numbers(html_file, scraps); fputs(".\n", html_file); }
Definesprint_scrap_numbers
(links are to index).Previous and next definitions.
F
ormatting a Scrap
We must translate HTML special keywords into entities in scraps.
<html.c>+= static void copy_scrap(file) FILE *file; { int indent = 0; int c = source_get(); while (1) { switch (c) { case '@': <Check HTML at-sequence for end-of-scrap> break; case '<' : fputs("<", file); indent++; break; case '>' : fputs(">", file); indent++; break; case '&' : fputs("&", file); indent++; break; case '\n': fputc(c, file); indent = 0; break; case '\t': <Expand tab into spaces> break; default: putc(c, file); indent++; break; } c = source_get(); } }
Definescopy_scrap
(links are to index).Previous and next definitions.
<Check HTML at-sequence for end-of-scrap>= { c = source_get(); switch (c) { case '@': fputc(c, file); break; case '|': <Skip over index entries> case '}': return; case '<': <Format HTML macro name> break; default: /* ignore these since pass1 will have warned about them */ break; } }
Used above.
There's no need to check for errors here, since we will have already pointed out any during the first pass.
<Format HTML macro name>= { Name *name = collect_scrap_name(); fprintf(file, "<%s ", name->spelling); if (name->defs) <Write HTML abbreviated definition list> else { putc('?', file); fprintf(stderr, "%s: scrap never defined <%s>\n", command_name, name->spelling); } fputs(">", file); }
Used above.
<Write HTML abbreviated definition list>= { Scrap_Node *p = name->defs; display_scrap_ref(file, p->scrap); if (p->next) fputs(", ... ", file); }
Used above.
G
enerating the Indices
<Write HTML index of file names>= { if (file_names) { fputs("\\begin{rawhtml}\n", html_file); fputs("<dl compact>\n", html_file); format_entry(file_names, html_file, TRUE); fputs("</dl>\n", html_file); fputs("\\end{rawhtml}\n", html_file); } c = source_get(); }
Used above.
<Write HTML index of macro names>= { if (macro_names) { fputs("\\begin{rawhtml}\n", html_file); fputs("<dl compact>\n", html_file); format_entry(macro_names, html_file, FALSE); fputs("</dl>\n", html_file); fputs("\\end{rawhtml}\n", html_file); } c = source_get(); }
Used above.
<html.c>+= static void format_entry(name, html_file, file_flag) Name *name; FILE *html_file; int file_flag; { while (name) { format_entry(name->llink, html_file, file_flag); <Format an HTML index entry> name = name->rlink; } }
Definesformat_entry
(links are to index).Previous and next definitions.
<Format an HTML index entry>= { fputs("<dt> ", html_file); if (file_flag) { fprintf(html_file, "<code>\"%s\"</code>\n<dd> ", name->spelling); <Write HTML file's defining scrap numbers> } else { fprintf(html_file, "<%s ", name->spelling); <Write HTML defining scrap numbers> fputs(">\n<dd> ", html_file); <Write HTML referencing scrap numbers> } putc('\n', html_file); }
Used above.
<Write HTML file's defining scrap numbers>= { fputs("Defined by ", html_file); print_scrap_numbers(html_file, name->defs); }
Used above.
<Write HTML defining scrap numbers>= { if (name->defs) display_scrap_numbers(html_file, name->defs); else putc('?', html_file); }
Used above.
<Write HTML referencing scrap numbers>= { Scrap_Node *p = name->uses; if (p) { fputs("Referenced in ", html_file); print_scrap_numbers(html_file, p); } else fputs("Not referenced.\n", html_file); }
Used above.
<Write HTML index of user-specified names>= { if (user_names) { fputs("\\begin{rawhtml}\n", html_file); fputs("<dl compact>\n", html_file); format_user_entry(user_names, html_file); fputs("</dl>\n", html_file); fputs("\\end{rawhtml}\n", html_file); } c = source_get(); }
Used above.
<html.c>+= static void format_user_entry(name, html_file) Name *name; FILE *html_file; { while (name) { format_user_entry(name->llink, html_file); <Format a user HTML index entry> name = name->rlink; } }
Definesformat_user_entry
(links are to index).Previous definition.
<Format a user HTML index entry>= { Scrap_Node *uses = name->uses; if (uses) { Scrap_Node *defs = name->defs; fprintf(html_file, "<dt><code>%s</code>:\n<dd> ", name->spelling); if (uses->scrap < defs->scrap) { display_scrap_ref(html_file, uses->scrap); uses = uses->next; } else { if (defs->scrap == uses->scrap) uses = uses->next; fputs("<strong>", html_file); display_scrap_ref(html_file, defs->scrap); fputs("</strong>", html_file); defs = defs->next; } while (uses || defs) { fputs(", ", html_file); if (uses && (!defs || uses->scrap < defs->scrap)) { display_scrap_ref(html_file, uses->scrap); uses = uses->next; } else { if (uses && defs->scrap == uses->scrap) uses = uses->next; fputs("<strong>", html_file); display_scrap_ref(html_file, defs->scrap); fputs("</strong>", html_file); defs = defs->next; } } fputs(".\n", html_file); } }
Used above.
<Function prototypes>+= extern void write_files();
Used above; previous and next definitions.
<output.c>+= void write_files(files) Name *files; { while (files) { write_files(files->llink); <Write out files->spelling> files = files->rlink; } }
Defineswrite_files
(links are to index).Previous definition.
We call tempnam, causing it to create a file name in the current directory. This could cause a problem for rename if the eventual output file will reside on a different file system. Perhaps it would be better to examine files->spelling to find any directory information.
Note the superfluous call to remove before rename. We're using it get around a bug in some implementations of rename.
<Write out files->spelling>= { char indent_chars[500]; FILE *temp_file; char *temp_name = tempnam(".", 0); temp_file = fopen(temp_name, "w"); if (!temp_file) { fprintf(stderr, "%s: can't create %s for a temporary file\n", command_name, temp_name); exit(-1); } if (verbose_flag) fprintf(stderr, "writing %s\n", files->spelling); write_scraps(temp_file, files->defs, 0, indent_chars, files->debug_flag, files->tab_flag, files->indent_flag); fclose(temp_file); if (compare_flag) <Compare the temp file and the old file> else { remove(files->spelling); rename(temp_name, files->spelling); } }
Used above.
Again, we use a call to remove before rename.
<Compare the temp file and the old file>= { FILE *old_file = fopen(files->spelling, "r"); if (old_file) { int x, y; temp_file = fopen(temp_name, "r"); do { x = getc(old_file); y = getc(temp_file); } while (x == y && x != EOF); fclose(old_file); fclose(temp_file); if (x == y) remove(temp_name); else { remove(files->spelling); rename(temp_name, files->spelling); } } else rename(temp_name, files->spelling); }
Used above.
T
he Support Routines
<Function prototypes>+= extern void source_open(); /* pass in the name of the source file */ extern int source_get(); /* no args; returns the next char or EOF */
Used above; previous and next definitions.
There are also two global variables maintained for use in error messages and such.
<Global variable declarations>+= extern char *source_name; /* name of the current file */ extern int source_line; /* current line in the source file */
Definessource_line
,source_name
(links are to index).Used above; previous and next definitions.
<Global variable definitions>+= char *source_name = NULL; int source_line = 0;
Used above; previous and next definitions.
L
ocal Declarations
<input.c>+= static FILE *source_file; /* the current input file */ static int source_peek; static int double_at; static int include_depth;
Definesdouble_at
,include_depth
,source_file
,source_peek
(links are to index).Previous and next definitions.
<input.c>+= static struct { FILE *file; char *name; int line; } stack[10];
Definesstack
(links are to index).Previous and next definitions.
R
eading a File
The routine source_get returns the next character from the
current source file. It notices newlines and keeps the line counter
source_line up to date. It also catches EOF and watches
for @ characters. All other characters are immediately returned.
<input.c>+= int source_get() { int c = source_peek; switch (c) { case EOF: <Handle EOF> return c; case '@': <Handle an ``at'' character> return c; case '\n': source_line++; default: source_peek = getc(source_file); return c; } }
Definessource_get
(links are to index).Previous and next definitions.
This whole @ character handling mess is pretty annoying. I want to recognize @i so I can handle include files correctly. At the same time, it makes sense to recognize illegal @ sequences and complain; this avoids ever having to check anywhere else. Unfortunately, I need to avoid tripping over the @@ sequence; hence this whole unsatisfactory double_at business.
<Handle an ``at'' character>= { c = getc(source_file); if (double_at) { source_peek = c; double_at = FALSE; c = '@'; } else switch (c) { case 'i': <Open an include file> break; case 'f': case 'm': case 'u': case 'd': case 'o': case 'D': case 'O': case '{': case '}': case '<': case '>': case '|': source_peek = c; c = '@'; break; case '@': source_peek = c; double_at = TRUE; break; default: fprintf(stderr, "%s: bad @ sequence (%s, line %d)\n", command_name, source_name, source_line); exit(-1); } }
Used above.
<Open an include file>= { char name[100]; if (include_depth >= 10) { fprintf(stderr, "%s: include nesting too deep (%s, %d)\n", command_name, source_name, source_line); exit(-1); } <Collect include-file name> stack[include_depth].name = source_name; stack[include_depth].file = source_file; stack[include_depth].line = source_line + 1; include_depth++; source_line = 1; source_name = save_string(name); source_file = fopen(source_name, "r"); if (!source_file) { fprintf(stderr, "%s: can't open include file %s\n", command_name, source_name); exit(-1); } source_peek = getc(source_file); c = source_get(); }
Used above.
<Collect include-file name>= { char *p = name; do c = getc(source_file); while (c == ' ' || c == '\t'); while (isgraph(c)) { *p++ = c; c = getc(source_file); } *p = '\0'; if (c != '\n') { fprintf(stderr, "%s: unexpected characters after file name (%s, %d)\n", command_name, source_name, source_line); exit(-1); } }
Used above.
If an EOF is discovered, the current file must be closed and input from the next stacked file must be resumed. If no more files are on the stack, the EOF is returned.
<Handle EOF>= { fclose(source_file); if (include_depth) { include_depth--; source_file = stack[include_depth].file; source_line = stack[include_depth].line; source_name = stack[include_depth].name; source_peek = getc(source_file); c = source_get(); } }
Used above.
O
pening a File
The routine source_open takes a file name and tries to open the
file. If unsuccessful, it complains and halts. Otherwise, it sets
source_name, source_line, and double_at.
<input.c>+= void source_open(name) char *name; { source_file = fopen(name, "r"); if (!source_file) { fprintf(stderr, "%s: couldn't open %s\n", command_name, name); exit(-1); } source_name = name; source_line = 1; source_peek = getc(source_file); double_at = FALSE; include_depth = 0; }
Definessource_open
(links are to index).Previous definition.
<scraps.c>+= #define SLAB_SIZE 500 typedef struct slab { struct slab *next; char chars[SLAB_SIZE]; } Slab;
DefinesSlab
,SLAB_SIZE
(links are to index).Previous and next definitions.
<scraps.c>+= typedef struct { char *file_name; int file_line; int page; char letter; Slab *slab; } ScrapEntry;
DefinesScrapEntry
(links are to index).Previous and next definitions.
<scraps.c>+= static ScrapEntry *SCRAP[256]; #define scrap_array(i) SCRAP[(i) >> 8][(i) & 255] static int scraps;
DefinesSCRAP
,scrap_array
,scraps
(links are to index).Previous and next definitions.
<Function prototypes>+= extern void init_scraps(); extern int collect_scrap(); extern int write_scraps(); extern void write_scrap_ref(); extern void write_single_scrap_ref();
Used above; previous and next definitions.
<scraps.c>+= void init_scraps() { scraps = 1; SCRAP[0] = (ScrapEntry *) arena_getmem(256 * sizeof(ScrapEntry)); }
Definesinit_scraps
(links are to index).Previous and next definitions.
<scraps.c>+= void write_scrap_ref(file, num, first, page) FILE *file; int num; int first; int *page; { if (scrap_array(num).page >= 0) { if (first) fprintf(file, "%d", scrap_array(num).page); else if (scrap_array(num).page != *page) fprintf(file, ", %d", scrap_array(num).page); if (scrap_array(num).letter > 0) fputc(scrap_array(num).letter, file); } else { if (first) putc('?', file); else fputs(", ?", file); <Warn (only once) about needing to rerun after Latex> } *page = scrap_array(num).page; }
Defineswrite_scrap_ref
(links are to index).Previous and next definitions.
<scraps.c>+= void write_single_scrap_ref(file, num) FILE *file; int num; { int page; write_scrap_ref(file, num, TRUE, &page); }
Defineswrite_single_scrap_ref
(links are to index).Previous and next definitions.
<Warn (only once) about needing to rerun after Latex>= { if (!already_warned) { fprintf(stderr, "%s: you'll need to rerun nuweb after running latex\n", command_name); already_warned = TRUE; } }
Used above (1), below (2).
<Global variable declarations>+= extern int already_warned;
Definesalready_warned
(links are to index).Used above; previous and next definitions.
<Global variable definitions>+= int already_warned = 0;
Used above; previous and next definitions.
<scraps.c>+= typedef struct { Slab *scrap; Slab *prev; int index; } Manager;
DefinesManager
(links are to index).Previous and next definitions.
<scraps.c>+= static void push(c, manager) char c; Manager *manager; { Slab *scrap = manager->scrap; int index = manager->index; scrap->chars[index++] = c; if (index == SLAB_SIZE) { Slab *new = (Slab *) arena_getmem(sizeof(Slab)); scrap->next = new; manager->scrap = new; index = 0; } manager->index = index; }
Definespush
(links are to index).Previous and next definitions.
<scraps.c>+= static void pushs(s, manager) char *s; Manager *manager; { while (*s) push(*s++, manager); }
Definespushs
(links are to index).Previous and next definitions.
<scraps.c>+= int collect_scrap() { Manager writer; <Create new scrap, managed by writer> <Accumulate scrap and return scraps++> }
Definescollect_scrap
(links are to index).Previous and next definitions.
<Create new scrap, managed by writer>= { Slab *scrap = (Slab *) arena_getmem(sizeof(Slab)); if ((scraps & 255) == 0) SCRAP[scraps >> 8] = (ScrapEntry *) arena_getmem(256 * sizeof(ScrapEntry)); scrap_array(scraps).slab = scrap; scrap_array(scraps).file_name = save_string(source_name); scrap_array(scraps).file_line = source_line; scrap_array(scraps).page = -1; scrap_array(scraps).letter = 0; writer.scrap = scrap; writer.index = 0; }
Used above.
<Accumulate scrap and return scraps++>= { int c = source_get(); while (1) { switch (c) { case EOF: fprintf(stderr, "%s: unexpect EOF in scrap (%s, %d)\n", command_name, scrap_array(scraps).file_name, scrap_array(scraps).file_line); exit(-1); case '@': <Handle at-sign during scrap accumulation> break; default: push(c, &writer); c = source_get(); break; } } }
Used above.
<Handle at-sign during scrap accumulation>= { c = source_get(); switch (c) { case '@': pushs("@@", &writer); c = source_get(); break; case '|': <Collect user-specified index entries> case '}': push('\0', &writer); return scraps++; case '<': <Handle macro invocation in scrap> break; default : fprintf(stderr, "%s: unexpected @%c in scrap (%s, %d)\n", command_name, c, source_name, source_line); exit(-1); } }
Used above.
<Collect user-specified index entries>= { do { char new_name[100]; char *p = new_name; do c = source_get(); while (isspace(c)); if (c != '@') { Name *name; do { *p++ = c; c = source_get(); } while (c != '@' && !isspace(c)); *p = '\0'; name = name_add(&user_names, new_name); if (!name->defs || name->defs->scrap != scraps) { Scrap_Node *def = (Scrap_Node *) arena_getmem(sizeof(Scrap_Node)); def->scrap = scraps; def->next = name->defs; name->defs = def; } } } while (c != '@'); c = source_get(); if (c != '}') { fprintf(stderr, "%s: unexpected @%c in scrap (%s, %d)\n", command_name, c, source_name, source_line); exit(-1); } }
Used above.
<Handle macro invocation in scrap>= { Name *name = collect_scrap_name(); <Save macro name> <Add current scrap to name's uses> c = source_get(); }
Used above.
<Save macro name>= { char *s = name->spelling; int len = strlen(s) - 1; pushs("@<", &writer); while (len > 0) { push(*s++, &writer); len--; } if (*s == ' ') pushs("...", &writer); else push(*s, &writer); pushs("@>", &writer); }
Used above.
<Add current scrap to name's uses>= { if (!name->uses || name->uses->scrap != scraps) { Scrap_Node *use = (Scrap_Node *) arena_getmem(sizeof(Scrap_Node)); use->scrap = scraps; use->next = name->uses; name->uses = use; } }
Used above.
<scraps.c>+= static char pop(manager) Manager *manager; { Slab *scrap = manager->scrap; int index = manager->index; char c = scrap->chars[index++]; if (index == SLAB_SIZE) { manager->prev = scrap; manager->scrap = scrap->next; index = 0; } manager->index = index; return c; }
Definespop
(links are to index).Previous and next definitions.
<scraps.c>+= static Name *pop_scrap_name(manager) Manager *manager; { char name[100]; char *p = name; int c = pop(manager); while (TRUE) { if (c == '@') <Check for end of scrap name and return> else { *p++ = c; c = pop(manager); } } }
Definespop_scrap_name
(links are to index).Previous and next definitions.
<Check for end of scrap name and return>= { c = pop(manager); if (c == '@') { *p++ = c; c = pop(manager); } else if (c == '>') { if (p - name > 3 && p[-1] == '.' && p[-2] == '.' && p[-3] == '.') { p[-3] = ' '; p -= 2; } *p = '\0'; return prefix_add(¯o_names, name); } else { fprintf(stderr, "%s: found an internal problem (1)\n", command_name); exit(-1); } }
Used above.
<scraps.c>+= int write_scraps(file, defs, global_indent, indent_chars, debug_flag, tab_flag, indent_flag) FILE *file; Scrap_Node *defs; int global_indent; char *indent_chars; char debug_flag; char tab_flag; char indent_flag; { int indent = 0; while (defs) { <Copy defs->scrap to file> defs = defs->next; } return indent + global_indent; }
Defineswrite_scraps
(links are to index).Previous and next definitions.
<Copy defs->scrap to file>= { char c; Manager reader; int line_number = scrap_array(defs->scrap).file_line; <Insert debugging information if required> reader.scrap = scrap_array(defs->scrap).slab; reader.index = 0; c = pop(&reader); while (c) { switch (c) { case '@': <Check for macro invocation in scrap> break; case '\n': putc(c, file); line_number++; <Insert appropriate indentation> break; case '\t': <Handle tab characters on output> break; default: putc(c, file); indent_chars[global_indent + indent] = ' '; indent++; break; } c = pop(&reader); } }
Used above.
<Insert debugging information if required>= if (debug_flag) { fprintf(file, "\n#line %d \"%s\"\n", line_number, scrap_array(defs->scrap).file_name); <Insert appropriate indentation> }
Used above (1), below (2).
<Insert appropriate indentation>= { if (indent_flag) { if (tab_flag) for (indent=0; indent<global_indent; indent++) putc(' ', file); else for (indent=0; indent<global_indent; indent++) putc(indent_chars[indent], file); } indent = 0; }
Used above (1), above (2).
<Handle tab characters on output>= { if (tab_flag) <Expand tab into spaces> else { putc('\t', file); indent_chars[global_indent + indent] = '\t'; indent++; } }
Used above.
<Check for macro invocation in scrap>= { c = pop(&reader); switch (c) { case '@': putc(c, file); indent_chars[global_indent + indent] = ' '; indent++; break; case '<': <Copy macro into file> <Insert debugging information if required> break; default: /* ignore, since we should already have a warning */ break; } }
Used above.
<Copy macro into file>= { Name *name = pop_scrap_name(&reader); if (name->mark) { fprintf(stderr, "%s: recursive macro discovered involving <%s>\n", command_name, name->spelling); exit(-1); } if (name->defs) { name->mark = TRUE; indent = write_scraps(file, name->defs, global_indent + indent, indent_chars, debug_flag, tab_flag, indent_flag); indent -= global_indent; name->mark = FALSE; } else if (!tex_flag) fprintf(stderr, "%s: macro never defined <%s>\n", command_name, name->spelling); }
Used above.
C
ollecting Page Numbers
<Function prototypes>+= extern void collect_numbers();
Used above; previous and next definitions.
<scraps.c>+= void collect_numbers(aux_name) char *aux_name; { if (number_flag) { int i; for (i=1; i<scraps; i++) scrap_array(i).page = i; } else { FILE *aux_file = fopen(aux_name, "r"); already_warned = FALSE; if (aux_file) { char aux_line[500]; while (fgets(aux_line, 500, aux_file)) { int scrap_number; int page_number; char dummy[50]; if (3 == sscanf(aux_line, "\\newlabel{scrap%d}{%[^}]}{%d}", &scrap_number, dummy, &page_number)) { if (scrap_number < scraps) scrap_array(scrap_number).page = page_number; else <Warn (only once) about needing to rerun after Latex> } } fclose(aux_file); <Add letters to scraps with duplicate page numbers> } } }
Definescollect_numbers
(links are to index).Previous and next definitions.
<Add letters to scraps with duplicate page numbers>= { int scrap; for (scrap=2; scrap<scraps; scrap++) { if (scrap_array(scrap-1).page == scrap_array(scrap).page) { if (!scrap_array(scrap-1).letter) scrap_array(scrap-1).letter = 'a'; scrap_array(scrap).letter = scrap_array(scrap-1).letter + 1; } } }
Used above.
<Type declarations>+= typedef struct scrap_node { struct scrap_node *next; int scrap; } Scrap_Node;
DefinesScrap_Node
(links are to index).Used above; previous and next definitions.
<Type declarations>+= typedef struct name { char *spelling; struct name *llink; struct name *rlink; Scrap_Node *defs; Scrap_Node *uses; int mark; char tab_flag; char indent_flag; char debug_flag; } Name;
DefinesName
(links are to index).Used above; previous definition.
<Global variable declarations>+= extern Name *file_names; extern Name *macro_names; extern Name *user_names;
Definesfile_names
,macro_names
,user_names
(links are to index).Used above; previous definition.
<Global variable definitions>+= Name *file_names = NULL; Name *macro_names = NULL; Name *user_names = NULL;
Used above; previous definition.
<Function prototypes>+= extern Name *collect_file_name(); extern Name *collect_macro_name(); extern Name *collect_scrap_name(); extern Name *name_add(); extern Name *prefix_add(); extern char *save_string(); extern void reverse_lists();
Used above; previous and next definitions.
<names.c>+= enum { LESS, GREATER, EQUAL, PREFIX, EXTENSION }; static int compare(x, y) char *x; char *y; { int len, result; int xl = strlen(x); int yl = strlen(y); int xp = x[xl - 1] == ' '; int yp = y[yl - 1] == ' '; if (xp) xl--; if (yp) yl--; len = xl < yl ? xl : yl; result = strncmp(x, y, len); if (result < 0) return GREATER; else if (result > 0) return LESS; else if (xl < yl) { if (xp) return EXTENSION; else return LESS; } else if (xl > yl) { if (yp) return PREFIX; else return GREATER; } else return EQUAL; }
Definescompare
,EQUAL
,EXTENSION
,GREATER
,LESS
,PREFIX
(links are to index).Previous and next definitions.
<names.c>+= char *save_string(s) char *s; { char *new = (char *) arena_getmem((strlen(s) + 1) * sizeof(char)); strcpy(new, s); return new; }
Definessave_string
(links are to index).Previous and next definitions.
<names.c>+= static int ambiguous_prefix(); Name *prefix_add(root, spelling) Name **root; char *spelling; { Name *node = *root; while (node) { switch (compare(node->spelling, spelling)) { case GREATER: root = &node->rlink; break; case LESS: root = &node->llink; break; case EQUAL: return node; case EXTENSION: node->spelling = save_string(spelling); return node; case PREFIX: <Check for ambiguous prefix> return node; } node = *root; } <Create new name entry> }
Definesprefix_add
(links are to index).Previous and next definitions.
Since a very short prefix might match more than one macro name, I need to check for other matches to avoid mistakes. Basically, I simply continue the search down both branches of the tree.
<Check for ambiguous prefix>= { if (ambiguous_prefix(node->llink, spelling) || ambiguous_prefix(node->rlink, spelling)) fprintf(stderr, "%s: ambiguous prefix @<%s...@> (%s, line %d)\n", command_name, spelling, source_name, source_line); }
Used above.
<names.c>+= static int ambiguous_prefix(node, spelling) Name *node; char *spelling; { while (node) { switch (compare(node->spelling, spelling)) { case GREATER: node = node->rlink; break; case LESS: node = node->llink; break; case EQUAL: case EXTENSION: case PREFIX: return TRUE; } } return FALSE; }
Previous and next definitions.
Rob Shillingsburg suggested that I organize the index of user-specified identifiers more traditionally; that is, not relying on strict ASCII comparisons via strcmp. Ideally, we'd like to see the index ordered like this:
The function robs_strcmp implements the desired predicate.aardvark
Adam
atom
Atomic
atoms
<names.c>+= static int robs_strcmp(x, y) char *x; char *y; { char *xx = x; char *yy = y; int xc = toupper(*xx); int yc = toupper(*yy); while (xc == yc && xc) { xx++; yy++; xc = toupper(*xx); yc = toupper(*yy); } if (xc != yc) return xc - yc; xc = *x; yc = *y; while (xc == yc && xc) { x++; y++; xc = *x; yc = *y; } if (isupper(xc) && islower(yc)) return xc * 2 - (toupper(yc) * 2 + 1); if (islower(xc) && isupper(yc)) return toupper(xc) * 2 + 1 - yc * 2; return xc - yc; }
Definesrobs_strcmp
(links are to index).Previous and next definitions.
<names.c>+= Name *name_add(root, spelling) Name **root; char *spelling; { Name *node = *root; while (node) { int result = robs_strcmp(node->spelling, spelling); if (result > 0) root = &node->llink; else if (result < 0) root = &node->rlink; else return node; node = *root; } <Create new name entry> }
Definesname_add
(links are to index).Previous and next definitions.
<Create new name entry>= { node = (Name *) arena_getmem(sizeof(Name)); node->spelling = save_string(spelling); node->mark = FALSE; node->llink = NULL; node->rlink = NULL; node->uses = NULL; node->defs = NULL; node->tab_flag = TRUE; node->indent_flag = TRUE; node->debug_flag = FALSE; *root = node; return node; }
Used above (1), above (2).
Name terminated by whitespace. Also check for ``per-file'' flags. Keep skipping white space until we reach scrap.
<names.c>+= Name *collect_file_name() { Name *new_name; char name[100]; char *p = name; int start_line = source_line; int c = source_get(); while (isspace(c)) c = source_get(); while (isgraph(c)) { *p++ = c; c = source_get(); } if (p == name) { fprintf(stderr, "%s: expected file name (%s, %d)\n", command_name, source_name, start_line); exit(-1); } *p = '\0'; new_name = name_add(&file_names, name); <Handle optional per-file flags> if (c != '@' || source_get() != '{') { fprintf(stderr, "%s: expected @{ after file name (%s, %d)\n", command_name, source_name, start_line); exit(-1); } return new_name; }
Definescollect_file_name
(links are to index).Previous and next definitions.
<Handle optional per-file flags>= { while (1) { while (isspace(c)) c = source_get(); if (c == '-') { c = source_get(); do { switch (c) { case 't': new_name->tab_flag = FALSE; break; case 'd': new_name->debug_flag = TRUE; break; case 'i': new_name->indent_flag = FALSE; break; default : fprintf(stderr, "%s: unexpected per-file flag (%s, %d)\n", command_name, source_name, source_line); break; } c = source_get(); } while (!isspace(c)); } else break; } }
Used above.
Name terminated by \n or @{; but keep skipping until @{
<names.c>+= Name *collect_macro_name() { char name[100]; char *p = name; int start_line = source_line; int c = source_get(); while (isspace(c)) c = source_get(); while (c != EOF) { switch (c) { case '@': <Check for terminating at-sequence and return name> break; case '\t': case ' ': *p++ = ' '; do c = source_get(); while (c == ' ' || c == '\t'); break; case '\n': <Skip until scrap begins, then return name> default: *p++ = c; c = source_get(); break; } } fprintf(stderr, "%s: expected macro name (%s, %d)\n", command_name, source_name, start_line); exit(-1); return NULL; /* unreachable return to avoid warnings on some compilers */ }
Definescollect_macro_name
(links are to index).Previous and next definitions.
<Check for terminating at-sequence and return name>= { c = source_get(); switch (c) { case '@': *p++ = c; break; case '{': <Cleanup and install name> default: fprintf(stderr, "%s: unexpected @%c in macro name (%s, %d)\n", command_name, c, source_name, start_line); exit(-1); } }
Used above.
<Cleanup and install name>= { if (p > name && p[-1] == ' ') p--; if (p - name > 3 && p[-1] == '.' && p[-2] == '.' && p[-3] == '.') { p[-3] = ' '; p -= 2; } if (p == name || name[0] == ' ') { fprintf(stderr, "%s: empty scrap name (%s, %d)\n", command_name, source_name, source_line); exit(-1); } *p = '\0'; return prefix_add(¯o_names, name); }
Used above (1), below (2), below (3).
<Skip until scrap begins, then return name>= { do c = source_get(); while (isspace(c)); if (c != '@' || source_get() != '{') { fprintf(stderr, "%s: expected @{ after macro name (%s, %d)\n", command_name, source_name, start_line); exit(-1); } <Cleanup and install name> }
Used above.
Terminated by @>
<names.c>+= Name *collect_scrap_name() { char name[100]; char *p = name; int c = source_get(); while (c == ' ' || c == '\t') c = source_get(); while (c != EOF) { switch (c) { case '@': <Look for end of scrap name and return> break; case '\t': case ' ': *p++ = ' '; do c = source_get(); while (c == ' ' || c == '\t'); break; default: if (!isgraph(c)) { fprintf(stderr, "%s: unexpected character in macro name (%s, %d)\n", command_name, source_name, source_line); exit(-1); } *p++ = c; c = source_get(); break; } } fprintf(stderr, "%s: unexpected end of file (%s, %d)\n", command_name, source_name, source_line); exit(-1); return NULL; /* unreachable return to avoid warnings on some compilers */ }
Definescollect_scrap_name
(links are to index).Previous and next definitions.
<Look for end of scrap name and return>= { c = source_get(); switch (c) { case '@': *p++ = c; c = source_get(); break; case '>': <Cleanup and install name> default: fprintf(stderr, "%s: unexpected @%c in macro name (%s, %d)\n", command_name, c, source_name, source_line); exit(-1); } }
Used above.
<names.c>+= static Scrap_Node *reverse(); /* a forward declaration */ void reverse_lists(names) Name *names; { while (names) { reverse_lists(names->llink); names->defs = reverse(names->defs); names->uses = reverse(names->uses); names = names->rlink; } }
Definesreverse_lists
(links are to index).Previous and next definitions.
Just for fun, here's a non-recursive version of the traditional list reversal code. Note that it reverses the list in place; that is, it does no new allocations.
<names.c>+= static Scrap_Node *reverse(a) Scrap_Node *a; { if (a) { Scrap_Node *b = a->next; a->next = NULL; while (b) { Scrap_Node *c = b->next; b->next = a; a = b; b = c; } } return a; }
Definesreverse
(links are to index).Previous definition.
S
earching for Index Entries [*]
Given the array of scraps and a set of index entries, we need to
search all the scraps for occurrences of each entry. The obvious
approach to this problem would be quite expensive for large documents;
however, there is an interesting paper describing an efficient
solution [cite aho:75].
<scraps.c>+= typedef struct name_node { struct name_node *next; Name *name; } Name_Node;
DefinesName_Node
(links are to index).Previous and next definitions.
<scraps.c>+= typedef struct goto_node { Name_Node *output; /* list of words ending in this state */ struct move_node *moves; /* list of possible moves */ struct goto_node *fail; /* and where to go when no move fits */ struct goto_node *next; /* next goto node with same depth */ } Goto_Node;
DefinesGoto_Node
(links are to index).Previous and next definitions.
<scraps.c>+= typedef struct move_node { struct move_node *next; Goto_Node *state; char c; } Move_Node;
DefinesMove_Node
(links are to index).Previous and next definitions.
<scraps.c>+= static Goto_Node *root[128]; static int max_depth; static Goto_Node **depths;
Definesdepths
,max_depth
,root
(links are to index).Previous and next definitions.
<scraps.c>+= static Goto_Node *goto_lookup(c, g) char c; Goto_Node *g; { Move_Node *m = g->moves; while (m && m->c != c) m = m->next; if (m) return m->state; else return NULL; }
Definesgoto_lookup
(links are to index).Previous and next definitions.
B
uilding the Automata
<Function prototypes>+= extern void search();
Used above; previous and next definitions.
<scraps.c>+= static void build_gotos(); static int reject_match(); void search() { int i; for (i=0; i<128; i++) root[i] = NULL; max_depth = 10; depths = (Goto_Node **) arena_getmem(max_depth * sizeof(Goto_Node *)); for (i=0; i<max_depth; i++) depths[i] = NULL; build_gotos(user_names); <Build failure functions> <Search scraps> }
Definessearch
(links are to index).Previous and next definitions.
<scraps.c>+= static void build_gotos(tree) Name *tree; { while (tree) { <Extend goto graph with tree->spelling> build_gotos(tree->rlink); tree = tree->llink; } }
Definesbuild_gotos
(links are to index).Previous and next definitions.
<Extend goto graph with tree->spelling>= { int depth = 2; char *p = tree->spelling; char c = *p++; Goto_Node *q = root[c]; if (!q) { q = (Goto_Node *) arena_getmem(sizeof(Goto_Node)); root[c] = q; q->moves = NULL; q->fail = NULL; q->moves = NULL; q->output = NULL; q->next = depths[1]; depths[1] = q; } while (c = *p++) { Goto_Node *new = goto_lookup(c, q); if (!new) { Move_Node *new_move = (Move_Node *) arena_getmem(sizeof(Move_Node)); new = (Goto_Node *) arena_getmem(sizeof(Goto_Node)); new->moves = NULL; new->fail = NULL; new->moves = NULL; new->output = NULL; new_move->state = new; new_move->c = c; new_move->next = q->moves; q->moves = new_move; if (depth == max_depth) { int i; Goto_Node **new_depths = (Goto_Node **) arena_getmem(2*depth*sizeof(Goto_Node *)); max_depth = 2 * depth; for (i=0; i<depth; i++) new_depths[i] = depths[i]; depths = new_depths; for (i=depth; i<max_depth; i++) depths[i] = NULL; } new->next = depths[depth]; depths[depth] = new; } q = new; depth++; } q->output = (Name_Node *) arena_getmem(sizeof(Name_Node)); q->output->next = NULL; q->output->name = tree; }
Used above.
<Build failure functions>= { int depth; for (depth=1; depth<max_depth; depth++) { Goto_Node *r = depths[depth]; while (r) { Move_Node *m = r->moves; while (m) { char a = m->c; Goto_Node *s = m->state; Goto_Node *state = r->fail; while (state && !goto_lookup(a, state)) state = state->fail; if (state) s->fail = goto_lookup(a, state); else s->fail = root[a]; if (s->fail) { Name_Node *p = s->fail->output; while (p) { Name_Node *q = (Name_Node *) arena_getmem(sizeof(Name_Node)); q->name = p->name; q->next = s->output; s->output = q; p = p->next; } } m = m->next; } r = r->next; } } }
Used above.
S
earching the Scraps
<Search scraps>= { for (i=1; i<scraps; i++) { char c; Manager reader; Goto_Node *state = NULL; reader.prev = NULL; reader.scrap = scrap_array(i).slab; reader.index = 0; c = pop(&reader); while (c) { while (state && !goto_lookup(c, state)) state = state->fail; if (state) state = goto_lookup(c, state); else state = root[c]; c = pop(&reader); if (state && state->output) { Name_Node *p = state->output; do { Name *name = p->name; if (!reject_match(name, c, &reader) && (!name->uses || name->uses->scrap != i)) { Scrap_Node *new_use = (Scrap_Node *) arena_getmem(sizeof(Scrap_Node)); new_use->scrap = i; new_use->next = name->uses; name->uses = new_use; } p = p->next; } while (p); } } } }
Used above.
<scraps.c>+= #define sym_char(c) (isalnum(c) || (c) == '_') static int op_char(c) char c; { switch (c) { case '!': case '@': case '#': case '%': case '$': case '^': case '&': case '*': case '-': case '+': case '=': case '/': case '|': case '~': case '<': case '>': return TRUE; default: return FALSE; } }
Definesop_char
,sym_char
(links are to index).Previous and next definitions.
<scraps.c>+= static int reject_match(name, post, reader) Name *name; char post; Manager *reader; { int len = strlen(name->spelling); char first = name->spelling[0]; char last = name->spelling[len - 1]; char prev = '\0'; len = reader->index - len - 2; if (len >= 0) prev = reader->scrap->chars[len]; else if (reader->prev) prev = reader->scrap->chars[SLAB_SIZE - len]; if (sym_char(last) && sym_char(post)) return TRUE; if (sym_char(first) && sym_char(prev)) return TRUE; if (op_char(last) && op_char(post)) return TRUE; if (op_char(first) && op_char(prev)) return TRUE; return FALSE; }
Definesreject_match
(links are to index).Previous definition.
<Function prototypes>+= extern void *arena_getmem(); extern void arena_free();
Used above; previous definition.
<arena.c>+= typedef struct chunk { struct chunk *next; char *limit; char *avail; } Chunk;
DefinesChunk
(links are to index).Previous and next definitions.
We define an empty chunk called first. The variable arena points at the current chunk of memory; it's initially pointed at first. As soon as some storage is required, a ``real'' chunk of memory will be allocated and attached to first->next; storage will be allocated from the new chunk (and later chunks if necessary).
<arena.c>+= static Chunk first = { NULL, NULL, NULL }; static Chunk *arena = &first;
Definesarena
,first
(links are to index).Previous and next definitions.
A
llocating Memory
The routine arena_getmem(n) returns a pointer to (at least)
n bytes of memory. Note that n is rounded up to ensure
that returned pointers are always aligned. We align to the nearest
8 byte segment, since that'll satisfy the more common 2-byte and
4-byte alignment restrictions too.
<arena.c>+= void *arena_getmem(n) size_t n; { char *q; char *p = arena->avail; n = (n + 7) & ~7; /* ensuring alignment to 8 bytes */ q = p + n; if (q <= arena->limit) { arena->avail = q; return p; } <Find a new chunk of memory> }
Definesarena_getmem
(links are to index).Previous and next definitions.
If the current chunk doesn't have adequate space (at least n bytes) we examine the rest of the list of chunks (starting at arena->next) looking for a chunk with adequate space. If n is very large, we may not find it right away or we may not find a suitable chunk at all.
<Find a new chunk of memory>= { Chunk *ap = arena; Chunk *np = ap->next; while (np) { char *v = sizeof(Chunk) + (char *) np; if (v + n <= np->limit) { np->avail = v + n; arena = np; return v; } ap = np; np = ap->next; } <Allocate a new chunk of memory> }
Used above.
If there isn't a suitable chunk of memory on the free list, then we need to allocate a new one.
<Allocate a new chunk of memory>= { size_t m = n + 10000; np = (Chunk *) malloc(m); np->limit = m + (char *) np; np->avail = n + sizeof(Chunk) + (char *) np; np->next = NULL; ap->next = np; arena = np; return sizeof(Chunk) + (char *) np; }
Used above.
F
reeing Memory
To free all the memory in the arena, we need only point arena
back to the first empty chunk.
<arena.c>+= void arena_free() { arena = &first; }
Definesarena_free
(links are to index).Previous definition.
[2]
Nikos Drakos.
The LaTeX2HTML translator, January 1994.
Available from
http://clb.leeds.ac.uk/nikos/tex2html/latex2html.tar.
[3]
David R. Hanson.
Fast allocation and deallocation of memory based on object lifetimes.
Software -- Practice and Experience, 20(1):5--12, January 1990.
[4]
Donald E. Knuth.
Literate programming.
The Computer Journal, 27(2):97--111, May 1984.
[5]
Donald E. Knuth.
METAFONT: The Program.
Computers &Typesetting. Addison-Wesley, 1986.
[6]
Donald E. Knuth.
TeX: The Program.
Computers &Typesetting. Addison-Wesley, 1986.
[7]
Donald E. Knuth.
The TeXbook.
Computers &Typesetting. Addison-Wesley, 1986.
[8]
Leslie Lamport.
LaTeX: A Document Preparation System.
Addison-Wesley, 1986.
[9]
Silvio Levy and Donald E. Knuth.
CWEB user manual: The CWEB system of structured
documentation.
Technical Report STAN-CS-83-977, Stanford
University, October 1990.
Available for anonymous ftp from labrea.stanford.edu in
directory pub/cweb.
[10]
Norman Ramsey.
Literate programming simplified.
IEEE Software, 11(5):97--105, September 1994.
[11]
Ross N. Williams.
FunnelWeb user's manual, May 1992.
Available for anonymous ftp from sirius.itd.adelaide.edu.au in
directory pub/funnelweb.