summaryrefslogtreecommitdiff
path: root/Build/source/utils/vlna/vlna.man
blob: 0470461370a1a5912d7cfcd8ae5ce2a45916e3a8 (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
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
.\"	$Id$
.TH VLNA 1 "4. unora 1998"
.nh
.SH NAZEV
vlna \- pridani vlnek za neslabicne predlozky v TeXu
.SH POUZITI
.B vlna
[\fIvolby\fP]
[\fIsoubory\fP]
.SH POPIS
Program
.B vlna
pridava vlnky (misto puvodnich mezer) za neslabicne predlozky
ve vstupnich souborech pro TeX, coz zabrani zlomu radku v nezadoucich mistech.
.PP
Veskere aktivity programu je mozne vypnout sekvenci \fB%~-\fP a zapnout
sekvenci \fB%~+\fP (mezi uvedenymi znaky muze byt libovolne mnozstvi mezer).
.PP
Pred predlozkou se muze nachazet libovolne mnozstvi oteviracich zavorek,
pred kterymi se musi nachazet mezera nebo zacatek radku. Pred
oteviraci svorkou muze byt take misto mezery TeXova 
\(lq\\sekvence\(rq (od verze 1.2).
Napr. za \(lq([{(V\(rq na pocatku radku bude vlnka pridana.
Stejne tak se text \(lq\\uv{V lese}\(rq promeni na
\(lq\\uv{V~lese}\(rq.
.PP
Program kontroluje konzistenci matematickych prostredi (neni-li uveden
parametr \fB\-m\fP).
Vstup do \fIdisplay\fP rezimu (\fB$$\fP) uvnitr \fItext\fP rezimu (\fB$\fP)
(napr. \fB$\fP...\fB$$\fP...\fB$\fP) znamena varovani a prechod do
\fIdisplay\fP.
Podobne prazdny radek uvnitr \fItext\fP nebo \fIdisplay\fP rezimu znamena
vypis varovani a prechod do nematematickeho (standardniho) rezimu.
Uvnitr rezimu \fIdisplay\fP se ignoruji vyskyty samostatneho znaku \fB$\fP,
jelikoz byva vetsinou soucasti konstrukce \fB\\hbox\fP.
.PP
Program kontroluje konzistenci verbatim rezimu na konci souboru.
Nebyl-li ukoncen, vypise se varovani.
Kontrola se neprovadi, pokud je pouzita volba \fB\-n\fP nebo \fB\-w\fP.
.PP
Program nedoplnuje vlnky za samostatna pismena, ktera jako predlozky vypadaji,
ale nasleduji bezprostredne za sekvencemi \fB\\TeX\fP nebo \fB\\LaTeX\fP.
Napr. do textu \(lq\fBVlastnosti \\TeX u jsou\fP\(rq nebude zadna vlnka
doplnena.
.SH VOLBY
Volby jsou nepovinne a mohou byt uvedeny v libovolnem poradi, ale nemohou
byt spojovany.
.TP
.B \-f
Filtr. Jmena souboru jsou interpretovana takto:
.RS
.TP 4
.B vlna \-f \fIsoubor1 soubor2\fP
Vstup je \fIsoubor1\fP, vystup \fIsoubor2\fP.
.TP 4
.B vlna \-f \fIsoubor1\fP
Vstup je \fIsoubor1\fP, vystup \fIstdout\fP.
.TP 4
.B vlna \-f
Vstup je \fIstdin\fP, vystup \fIstdout\fP.
.TP 4
\fBvlna\fP \fIsoubor1\fP [\fIsoubor2\fP [\fIsoubor3\fP ...]]
Neni-li uveden parametr \fB\-f\fP, kazdy soubor je zpracovavan samostatne.
.RE
.TP
.B \-s
Tichy rezim. Program potlaci vypis uvodni zpravy, varovnych zprav a
statistik o zmenach v souborech
(bez uvedeni parametru jsou zpravy vypisovany na \fIstderr\fP).
V tichem rezimu se vypise jen chyba, ktera predcasne ukonci
cinnost programu.
.TP
.B \-r
Nevytvaret (mazat) zalohy.
Parametr \fB\-r\fP nema vliv, pokud je uveden spolu s \fB\-f\fP.
V opacnem pripade se ke kazdemu souboru vytvari zaloha s vlnkou na konci jmena
a parametr \fB\-r\fP zpusobi, ze na konci zpracovani jsou tyto zalohy mazany.
.TP
.B \-v \fIznaky\fP
Znaky povazovane za neslabicne predlozky, za ktere ma byt pridavana
vlnka. Implicitni hodnota je \fB\-v\ KkSsVvZzOoUuAI\fP. (Mezi
\fB\-v\fP a skupinou znaku musi byt mezera.)
.TP
.B \-m
Ignorovani prechodu do matematickych prostredi
(\fB$\fP...\fB$\fP a \fB$$\fP...\fB$$\fP).
Parametr \fB\-m\fP zpusobi vlnkovani i v matematickych prostredich, ktera
se implicitne vynechavaji.
.TP
.B \-n
Ignorovani verbatim rezimu (\fB\\verb\fP\fI<znak>\fP...\fI<znak>\fP,
\fB\\begtt\fP...\fB\\endtt\fP).
Parametr \fB\-n\fP zpusobi vlnkovani i ve verbatim rezimu, ktery se
implicitne vynechava.
.TP
.B \-l
LaTeX. Pro rozpoznani matematickeho rezimu jsou pridana prostredi
\fB\\begin{display}\fP...\fB\\end{display}\fP a 
\fB\\begin{equation}\fP...\fB\\end{equation}\fP.
Pro rozpoznani verbatim rezimu je pridano LaTeXove prostredi
\fB\\begin{verbatim}\fP...\fB\\end{verbatim}\fP.
.TP
.B \-w
Web. Pro rozpoznani verbatim rezimu jsou pridany sekvence
\fB@<\fP, \fB@d\fP...\fB@*\fP, \fB@\fP\fImezera\fP nebo \fB@>|\fP.
Ve zdrojovem kodu se tedy nevlnkuje program, ale jen komentare.
.SH PRIKLADY
.TP
.B vlna \-m \-n \-s \-r \fIsoubor\fP
Volani priblizne odpovida volani puvodniho programu \fBvlna\fP.
(Navic se neprovadi vlnkovani za sekvencemi \fB\\TeX\fP a \fB\\LaTeX\fP.)
.TP
.B vlna *.tex
Vlnkovani vsech souboru s priponou \fBtex\fP.
(Pouze na UNIXu.)
.TP
.B vlna \-f soubor > /dev/null
Test konzistence matematickeho a verbatim rezimu bez provedeni zmen.
(Pouze na UNIXu.)
.SH SOUBORY
.PD 0
.TP
.I @BINDIR@/vlna
spustitelny program
.TP
.I @MANDIR@/vlna.@MANEXT@
manualova stranka
.PD
.SH AUTOR
Petr Olsak <olsak@math.feld.cvut.cz>. Manualovou stranku a Makefile vytvoril Rulolf Cejka