xml-lit

Name

xml-lit — Weave and tangle and XML Literate Program

Synopsis

xml-lit [ -cntwXx -T [size] ] [file]

Description

The xml-lit command will tangle (extract) from the XML file containing a literate program, or weave the XML file, producing another XML file which is suitable for processing into a printable document.

-c, --c-mode

Produces #line compiler directives so that a C compiler that understands these directives processing the tangled files produces line numbers in the source XML document containing the literate program instead of line numbers in the tangled files. This is on by default. Turn it off with -n if you are tangling source of a programming language that doesn't use or understand these directives.

-n, --no-line

The opposite of -c, this switch disables the creation of #line compiler directives. Useful if the output code is not C or otherwise processed by a system that does not understand such directives.

-t, --tangle

Tangle. This option causes the program to tangle the input file.

-T [size], --hash-table-size=size

This switch allows you to set the size of the hash table by setting the number of bits. The hash table used for storing fragment map names will be set to two 2^size entries. The default is 6, giving a total of 64 entries.

-w, --weave

Weave. This option produces an output file that is the input file name with a '.out' appended which has all of the elements relevant only to the literate programming system stripped out (i.e. <xml-lit:code/> elements).

-X, --Xml-lit

This forces xml-lit to use the old-style xmltangle-style method of using <programlisting/> elements to give code output to files. This usage is deprecated.

-x, --xmltangle

The reverse of -X. This forces xml-lit to use the new-style method of using the namespaced elements for the literate program. This is the default.

See Also

xmltangle(1)