summaryrefslogtreecommitdiff
path: root/support/lgrind/README
blob: 5db42af13872077385e82384c3d6721dad98600c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
=-----
LGrind - a source pretty printer for LaTeX
=-----
Version 3.67

Welcome to LGrind. LGrind is a descendant of the Unix utility vgrind. It is
used to produce a beautified version of your source code using LaTeX. Unlike
other packages this is not pure TeX but an external preprocessor. You run e.g.
    lgrind example.c > example.tex
    latex example.tex
to get a complete listing. Options for producing includable files and pro-
cessing embedded listings in LaTeX texts are provided.


What you need: (Installation part 2)
^^^^^^^^^^^^^^
- lgrind        (or lgrind.exe) just where you like it
- lgrind.sty    somewhere in LaTeXs reach
- lgrindef      anywhere; (position is semi-fixed in the executable)
- LaTeX2e       the obsolete LaTeX 2.09 is not supported
- LGrind utilizes by default the fancyhdr package by Piet van Oostrum. You
  can change this behaviour by modifying the lgrindef file.


How to get these files: (Installation part 1)
^^^^^^^^^^^^^^^^^^^^^^^
- If your executable is not provided, all the  source files are in the source
  directory, a makefile provided.
- Run LaTeX or TeX on lgrind.ins. You will obtain lgrind.sty.
- Or simply run make in the top directory. This also gives lgrind.sty


Documentation
^^^^^^^^^^^^^
Main documentation is in lgrind.dtx. Run LaTeX on lgrind.dtx and the result is
lgrind.dvi. There are also manpages lgrind.1 and lgrindef.5 for people who
prefer those, but notice that I am not always able to keep them up to date.
To right the wrong impression: parts of the documentation have been written
by my predecessors, my thanks to them.



Files in the directories:
^^^^^^^^^^^^^^^^^^^^^^^^^
lgrind.ins      DocStrip driver
lgrind.dtx      Documented package
lgrind.gls      Glossary and index for the documentation (for the ones with-
lgrind.ind        out MakeIndex, and because it had to be modified by hand)
lgrindef        The language definition file


In the directory 'source':
lgrind.c        The source code for the LGrind executable
lgutil.c
lgrindef.c
lgrindef.h
regexp.c
regexp.h
v2lg.c          Source code for verbatim to embedded source converter
retest.c        Test program for the regular expression routines
lgrind.1        Man-pages for the LGrind program
lgrindef.5                and the language definition file
Makefile        Makefile for Unices
makefile.dos    Makefile for MS-DOS (not tested anymore)
makefile.emx    Makefile for use with DMAKE


In the directory 'example':
c2tex.bat       Example batch files for facilitating calls to LGrind
asm2tex.bat
c2tex           ditto as Bourne shell scripts
asm2tex
egmasm.asm      Example sources
egcprog.c
subst           Example substitution file
lgrindeg.tex    Example making use of the above



Comments, contributions, questions and cheques
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
LGrind contains non-free code written by Van Jacobson, who does not answer
to any request for changing his licence. This software is therefore not
maintained. I also do not accept any cheques anymore.

Have Fun!