
                           dvlabel/README

                 Copyright (C) 2003-2004, Fredrik Jonsson

The DVLABEL computer program generates TeX source code for typesetting of
labels for digital video tapes (DV format, typically used for hand-held
video camera recorders). The program is primarily designed to run in
interactive mode, but via command-line parameters it also supports batch-
mode operation. A feature of the program is also that it is able to compile
the generated TeX source code into PostScript, using the DVIPS program.
(The DVIPS program is copyrighted by Radical Eye Software, but is typically
included in most TeX distributions under UNIX, Linux, and Microsoft Windows;
see the site http://www.radicaleye.com for further information).

Files in this directory:

        Makefile    - The Makefile for compilation of the executable
                      file, as well as generation of the documentation
                      of the program. Extracts the C and TeX code from
                      the CWEB source, and compiles the C and TeX code
                      into binary executable and PostScript, respectively.
                      To create the executable and documentation, simply
                      run 'make' in this directory.

        dvlabel.w   - The CWEB [1] source code for the DVLABEL program.

        dvlabel.c   - ANSI-C (ISO C89) conforming source code, extracted
                      from the CWEB master source code.

        dvlabel.tex - Plain TeX [2] source code documentation, extracted
                      from the CWEB master source code.

        dvlabel.ps  - PostScript [3] documentation of the DVLABEL program,
                      generated from the CWEB master source code.

        dvlabel.pdf - Portable Document Format (PDF) [4] documentation of
                      the DVLABEL program.

Compile the DVLABEL program by using the enclosed Makefile, or use the
blocks of the Makefile as listed in section five of the documentation.


References

 [1] For information on the CWEB programming language by Donald E. Knuth,
     as well as samples of CWEB programs, see D. E. Knuth's homepage at
     http://www-cs-faculty.stanford.edu/~knuth/cweb.html. For information
     on literate programming, as well as additional CWEB examples, see
     http://www.literateprogramming.com.

 [2] For information on the TeX typesetting system, as well as references
     to the dvips program, see for example the homepage of the TeX Users
     Group, at http://www.tug.org.

 [3] For information on the PostScript programming language, see for
     example the homepage of Adobe Systems Inc., at
     http://www.adobe.com/products/postscript/main.html,
     or "PostScript Language - Tutorial and Cookbook" (Adison-Wesley,
     Reading, Massachusetts, 1985), ISBN 0-201-10179-3.

 [4] For information on the Portable Document Format (PDF) of Adobe,
     see for example the homepage of Adobe Systems Inc., at
     http://www.adobe.com/products/acrobat/adobepdf.html.

