summaryrefslogtreecommitdiff
path: root/support/lacheck/lacheck.man
blob: 5040e4b27645d31f25150ce106e5605ccc8cb844 (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
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
.TH "LaCheck" "1" "2019-07-09" "Release @REV@ (TeX Live)"
.SH NAME
lacheck - a consistency checker for LaTeX documents
.SH SYNOPSIS
.B lacheck 
.IR filename [ \fB.tex\fP ]
.SH DESCRIPTION
LaCheck is a general purpose consistency checker for LaTeX documents.
It reads a LaTeX document and displays warning messages, if it finds
bad sequences. It should be noted, that the badness is 
.I very
subjective.  LaCheck is designed to help find common mistakes in LaTeX
documents, especially those made by beginners.
.LP
The things checked are:
.LP
Mismatched groups (braces), environments and math mode
delimiters.  When a mismatch is found, line numbers for
.I "both" 
start and end of the mismatch is given. The error messages comes in
pairs, one for the end match and one for the beginning, marked with
\`<-\' and \`->\' respectively.
.LP
Bad spacing including missing a \`\\ \' after an abbreviation, missing
an \`\\@\' before a punctuation mark in a paragraph that is ended by
an capital letter, double spaces like \` \~\', bad usage of ellipsis
(like using ... instead of \\ldots, or using \\ldots where \\cdots
should be used), missing \~ before a \\cite or \\ref commands, space
before footnotes, italic corrections before comma, point, or italic
text, italic correction after normal text, missing italic correction
when switching from italic to normal text, and double italic
correction.
.LP
Badly placed punctuation marks around end of math mode
delimiters. This is, punctuation placed right after display math end
or punctuation placed right before text math end.  Sequences of
whitespace followed by punctuation marks are also caught.
.LP 
Bad use of quotation characters, i.e. constructs like "\'word" or
"word\`" are warned about, tabs in verbatim environments are caught,
certain TeX primitives are frowned upon, attempts to give font
specifiers arguments such as \\em{text} are noted, and use of @ in
LaTeX macros are reported.
.LP
LaCheck will read files that are input using \\input or \\include.
Files with suffix \`.sty\' are omitted, as they probably will cause
LaCheck to crash.
.LP 
LaCheck may be invoked from within emacs(1) using M-x compile.
To run:  
.B "M-x compile RET lacheck RET"
, and then 
.B "C-x `"
to parse the messages

.SH OUTPUT
The output is UNIX-error like, and may be parsed using Emacs(1)
compile mode. Here is a sample:

.PD 0
lacheck compiler
.TP
"/usr/mef/compiler.tex", line 34: missing \`\\\\\\\\ \' after "etc."
.TP
"/usr/mef/compiler.tex", line 179: double space at " ~"
.TP
"/usr/mef/compiler.tex", line 186: <- unmatched "}"
.TP
"/usr/mef/compiler.tex", line 181: -> unmatched "$$"
.PD 1
.LP
A control space \`\\ \' should be inserted at line 34, to prevent an
end-of-sentence space. 
Also, at line 179, the first space of the sequence " ~" should
probably be deleted.
The last two lines is an example, where the user mistyped, and
probably inserted an extra "}" somewhere.

.SH DIAGNOSTICS
Some special cases should be explained. In cases where a sentence ends
with something that LaCheck thinks is an abbreviation an missing \`\\
\' error may also occur, if the following sentence begins with a
lowercase letter.
.LP
A mismatch error may cause more to follow, due to the lack of good
error recovery. In such cases, just correct the first
error and run LaCheck again.
.LP
Braces, environments and math mode must be balanced within a file.
.LP
LaCheck may be confused by unmatched stuff placed inside verbatim-like
environments called something else than exactly \`verbatim\'.
.SH SEE ALSO
tex(1), emacs(1), latex(1)
.SH BUGS
LaCheck gets confused by advanced macros, is fooled by simple macros,
can't figure out if you use a non-standard way to switch italic on or
off, does not like TeX at all, does not provide any options to turn
off specific warnings, and is at best a crude approximation.
.LP
Ideas for improvements and bug reports are very welcome.  Such
should be directed to the maintainers; please email tex-live@tug.org.
.SH AUTHOR
Kresten Krab Thorup with modifications by Per Abrahamsen.
Currently maintained as part of TeX Live (https://tug.org/texlive).