This repository was archived by the owner on Jun 19, 2023. It is now read-only.
forked from tvondra/ispell_czech
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathispell.man
1569 lines (1569 loc) · 47.9 KB
/
ispell.man
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
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
.\"
.\" $Id: ispell.1X,v 1.91 2001/07/25 21:51:46 geoff Exp $
.\"
.\" Copyright 1992, 1993, 1999, 2001, Geoff Kuenning, Claremont, CA
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\"
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\" 3. All modifications to the source code must be clearly marked as
.\" such. Binary redistributions based on modified source code
.\" must be clearly marked as modified versions in the documentation
.\" and/or other materials provided with the distribution.
.\" 4. Any web site or other electronic service that offers ispell for
.\" download or other electronic transfer as a separate entity, in
.\" either source or binary form, must also include a prominent statement
.\" indicating that information about ispell can be obtained from the
.\" following Web site URL:
.\" http://fmg-www.cs.ucla.edu/geoff/ispell.html
.\" If the offering service supports hyperlinks, the aforementioned
.\" Web site must also be offered as a hyperlink. Condition #4 does
.\" not apply if ispell is offered only as part of a larger, aggregated
.\" product such as a word processor or packaged operating system.
.\" 5. The name of Geoff Kuenning may not be used to endorse or promote
.\" products derived from this software without specific prior
.\" written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY GEOFF KUENNING AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL GEOFF KUENNING OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" $Log: ispell.1X,v $
.\" Revision 1.91 2001/07/25 21:51:46 geoff
.\" Minor license update.
.\"
.\" Revision 1.90 2001/07/23 20:24:03 geoff
.\" Update the copyright and the license.
.\"
.\" Revision 1.89 2001/07/23 19:36:49 geoff
.\" Document that -w doesn't work with /
.\"
.\" Revision 1.88 2000/08/24 06:48:40 geoff
.\" Document correct_verbose_mode.
.\"
.\" Revision 1.87 1999/01/07 01:22:40 geoff
.\" Update the copyright.
.\"
.\" Revision 1.86 1999/01/05 20:40:26 geoff
.\" Improve the documentation of -F
.\"
.\" Revision 1.85 1999/01/03 01:46:31 geoff
.\" Document the -F (external deformatter) switch.
.\"
.\" Revision 1.84 1998/07/12 20:42:15 geoff
.\" Document the -k switch and associated environment variables. Fix a
.\" couple of places where ispell wasn't italicized.
.\"
.\" Revision 1.83 1995/11/08 05:09:12 geoff
.\" Document the new ispell-4-like interactive mode.
.\"
.\" Revision 1.82 1995/11/08 04:53:34 geoff
.\" Change the HTML-mode documentation to reflect the compatibility
.\" improvements and flag renaming I did.
.\"
.\" Revision 1.81 1995/10/25 04:05:20 geoff
.\" Documentation for html-mode added by Gerry Tierney 10/14/1995.
.\"
.\" Revision 1.80 1995/01/08 23:23:31 geoff
.\" Document the new personal-dictionary behavior (dictionary named after
.\" the hash file is preferred).
.\"
.\" Revision 1.79 1994/10/25 05:46:02 geoff
.\" Document the new DICTIONARY variable, and improve the documentation of
.\" the -d flag.
.\"
.\" Revision 1.78 1994/09/16 05:06:58 geoff
.\" Make it clear that the + command doesn't change the string-character
.\" type.
.\"
.\" Revision 1.77 1994/04/27 01:50:35 geoff
.\" Remove the bug about the tex parser getting confused by \endxxx.
.\"
.\" Revision 1.76 1994/03/21 01:54:08 geoff
.\" Document the '&' command in -a mode.
.\"
.\" Revision 1.75 1994/03/15 06:24:26 geoff
.\" Document the changes to the +/-/~ commands and the -T switch.
.\"
.\" Revision 1.74 1994/01/25 07:11:39 geoff
.\" Get rid of all old RCS log lines in preparation for the 3.1 release.
.\"
.\"
.TH ISPELL 1 local
.do hla cs
.do hpf hyphen.cs
.SH JMÉNO
ispell, buildhash, munchlist, findaffix, tryaffix, icombine, ijoin \-
Interaktivní korektor pøeklepù
.SH POU®ITÍ
.B ispell
.RI [ spoleèné-volby ]
.RB [ \-M | \-N ]
.RB [ \-L
\fIøádkù\fP]
.RB [ \-V ]
soubory
.br
.B ispell
.RI [ spoleèné-volby ]
.B \-l
.br
.B ispell
.RI [ spoleèné-volby ]
.RB [ \-f
soubor]
.RB [ \-s ]
.RB [ \-a | \-A ]
.br
.B ispell
.RB [ \-d
.IR soubor ]
.RB [ \-w
.IR znaky ]
.B \-c
.br
.B ispell
.RB [ \-d
.IR soubor ]
.RB [ \-w
.IR znaky ]
.BR \-e [ úroveò ]
.br
.B ispell
.RB [ \-d
.IR soubor ]
.B \-D
.br
.B ispell
.BR \-v [ v ]
.IP \fIspoleèné-volby\fP:
.RB [ \-t ]
.RB [ \-n ]
.RB [ \-H ]
.RB [ \-b ]
.RB [ \-x ]
.RB [ \-B ]
.RB [ \-C ]
.RB [ \-P ]
.RB [ \-m ]
.RB [ \-S ]
.RB [ \-d
.IR soubor ]
.RB [ \-p
.IR soubor ]
.RB [ \-w
.IR znaky ]
.RB [ \-W
.IR n ]
.RB [ \-T
.IR typ ]
.RB [ \-k\fIjméno\fP
.IR seznam ]
.RB [ \-F
.IR program ]
.PP
.B buildhash
.RB [ \-s ]
.I
dict-soubor afix-soubor hash-soubor
.br
.B buildhash
.B \-s
.I
poèet afix-soubor
.if n .TP 10
.if t .PP
.B munchlist
.RB [ \-l
.IR aff-soubor ]
.RB [ \-c
.IR conv-soubor ]
.RB [ \-T
.IR sufix ]
.if n .br
.RB [ \-s
.IR hash-soubor ]
.RB [ \-D ]
.RB [ \-v ]
.RB [ \-w
.IR znaky ]
.RI [ soubory ]
.if n .TP 10
.if t .PP
.B findaffix
.RB [ \-p | \-s ]
.RB [ \-f ]
.RB [ \-c ]
.RB [ \-m
.IR min ]
.RB [ \-M
.IR max ]
.RB [ \-e
.IR elim ]
.if n .br
.RB [ \-t
.IR tabchar ]
.RB [ \-l
.IR min-poèet ]
.RI [ soubory ]
.PP
.B tryaffix
.RB [ \-p | \-s]
.RB [ \-c ]
.I expandovaný-soubor
.IR afix [ +pøídavek ]
...
.PP
.B icombine
.RB [ \-T
.IR typ ]
.RI [ aff-soubor ]
.PP
.B ijoin
.RB [ \-s | \-u ]
.I volby-pro-join
.I soubor1
.I soubor2
.SH POPIS
.PP
Korektor pøeklepù
.I ispell
vychází z programu
.I spell
pro ITS, který byl na systému Twenex pøejmenován na
.IR ispell .
Nejèastìji se pou¾ívá pro interaktivní kontrolu
obsahu souboru pøíkazem "ispell jméno_souboru".
Pøi ní
.I ispell
pøeskakuje v¹echna jemu známá slova; slovo, které nemá ve slovníku,
pova¾uje za pøeklep, zobrazí je v horní èásti obrazovky, a umo¾ní
u¾ivateli jeho opravu.
Na obrazovce se zobrazuje i èást kontrolovaného souboru - øádek
obsahující neznámé slovo a øádek pøedchozí. Je-li pou¾itý terminál
schopen zvýrazòovat text inverzním zobrazením, bude neznámé slovo
zvýraznìno.
Jsou-li ve slovníku "podobná slova" (taková, která se od neznámého
slova odli¹ují zmìnou jediného písmene, vypu¹tìním nebo pøidáním
jednoho písmene, pøehozením dvojice písmen, anebo lze-li vlo¾ením
mezery, pomlèky èi spojovníku rozdìlit neznámé slovo na dvì slova
uvedená ve slovníku), budou zobrazena jako mo¾né opravy na
následujících øádcích. Kromì nich
.I ispell
zobrazuje i takzvané odhady. Odhad je zpùsob, jak získat neznámé slovo
z nìkterého základního tvaru uvedeného ve slovníku pou¾itím libovolných
odvozovacích pravidel ze souboru afixù (za bezchybná jsou pova¾ována
slova získaná výhradnì pou¾itím pravidel povolených pro daný základní
tvar). Navrhované opravy jsou oèíslovány, odhady jsou oznaèeny otazníky.
Pokud je neznámé slovo chybné, mù¾e jej u¾ivatel opravit vybráním jedné
z navrhovaných oprav nebo napsáním správného slova. Správné slovo, které
.I ispell
nezná, mù¾e u¾ivatel zaøadit do svého osobního slovníku. Po¾adovaná
akce se vybere jedním z následujících jednopísmenných pøíkazù
(mohou být zadány velkými i malými písmeny):
.PP
.RS
.IP mezera
Tento výskyt neznámého slova neopravovat.
.IP 0-\fIn\fR
Slovo nahradit navrhovanou opravou se zadaným èíslem.
.IP R
Replace - ruènì zadat opravu chybného slova.
.IP A
Accept - pova¾ovat slovo za správné do konce tohoto spu¹tìní programu
.IR ispell .
.IP I
Insert - slovo pova¾ovat za správné a vlo¾it jej (pøesnì v uvedeném tvaru,
vèetnì pou¾ití velkých písmen) do osobního slovníku.
.IP U
Uncapitalized - slovo pova¾ovat za správné a pøevedené na malá písmena
jej vlo¾it do osobního slovníku.
.IP L
Look up - zkontrolovat, zda se slovo vyskytuje v systémovém slovníku
(urèeném pøi pøekladu programu
.I ispell
volbou WORDS).
.IP X
eXit - zapsat aktuální stav opravovaného souboru na disk a zahájit
zpracování pøípadného dal¹ího souboru.
.IP Q
Quit - ukonèit program
.I ispell
a opravovaný soubor ponechat beze zmìn.
.IP !
Vyvolat interpret pøíkazù (návrat pøíkazem exit).
.IP ^L
Pøekreslit obrazovku.
.IP ^Z
Suspendovat ispell (pokraèovat pøíkazem fg).
.IP ?
Zobrazit nápovìdu.
.RE
.PP
Podle hodnoty volby MINIMENU zadané pøi pøekladu programu
.I ispell
mù¾e být ve spodní èásti obrazovky zobrazen øádek se seznamem
vý¹e uvedených pøíkazù. Jeho zobrazení lze vynutit volbou
.BR \-M .
Naopak volbou
.B \-N
se zobrazení této nápovìdy potlaèí.
.PP
Volbou
.B \-L
lze stanovit, kolik øádkù kontrolovaného souboru se má pøi opravování
zobrazovat. Implicitní hodnota je vypoèítána jako urèitá èást
velikosti obrazovky. Poèet øádkù je omezen systémovì závislým limitem.
.PP
Pøi pou¾ití volby
.B \-V
budou jiné ne¾ tisknutelné ASCII znaky zobrazovány ve stylu
pøíkazu "cat -v", a to i v pøípadì, ¾e
.I ispell
na va¹em systému tyto znaky pova¾uje za zobrazitelné ISO Latin-n znaky.
Tato volba mù¾e poslou¾it na star¹ích terminálech. Bez ní bude
.I ispell
osmibitové znaky povolené pro pøíslu¹ný formát souboru zobrazovat jak
jsou.
.PP
V "normálním" re¾imu nebo pøi pou¾ití voleb
.BR \-l ,
.B \-a
èi
.B \-A
a v interaktivním re¾imu (viz ní¾e) lze v pøíkazovém øádku pou¾ít také
následující spoleèné volby:
.RS
.IP \fB\-t\fR
Vstupní soubor je ve formátu TeX nebo LaTeX.
.IP \fB\-n\fR
Vstupní soubor je ve formátu nroff/troff.
.IP \fB\-H\fR
Vstupní soubor je ve formátu SGML/HTML.
(Tato volba by se mìla jmenovat
.BR \-s ,
ale ta byla v minulosti pou¾ita pro jiný úèel.)
.IP \fB\-b\fR
Bude vytvoøen zálo¾ní soubor se jménem vzniklým pøidáním pøípony ".bak"
ke jménu vstupního souboru.
.IP \fB\-x\fR
Zálo¾ní soubor bude smazán.
.IP \fB\-B\fR
Spojená slova budou pova¾ována za povolené slo¾eniny.
.IP \fB\-C\fR
Spojená slova budou pova¾ována za pøeklep (chybìjící mezeru).
.IP \fB\-P\fR
Nebudou se generovat zvlá¹tní kombinace koøen/afix.
.IP \fB\-m\fR
Budou se generovat kombinace koøen/afix neuvedené ve slovníku.
.IP \fB\-S\fR
Seznam odhadù bude tøídìn podle pravdìpodobné správnosti.
.IP "\fB\-d\fR soubor"
Jméno alternativního ha¹ovaného souboru se slovníkem
(pøíponu .hash není tøeba uvádìt). Napøíklad pomocí
.B "\-d czech"
lze v èeské instalaci vybrat èeský slovník.
.IP "\fB\-p\fR soubor"
Urèuje jméno souboru s alternativním osobním slovníkem.
.IP "\fB\-w\fR znaky"
Udává, které dal¹í znaky mohou být èástí slova.
.IP "\fB\-W\fR n"
Udává maximální délku slov, která jsou automaticky pova¾ována za správná.
.IP "\fB-T\fR typ"
Pøedpokládá, ¾e v¹echny soubory jsou zadaného typu.
.RE
.PP
Volby
.BR \-H ,
.B \-n
a
.B \-t
urèují, zda
.I ispell
oèekává vstupní soubor ve formátu HTML
.RB ( \-H ),
nroff/troff
.RB ( \-n )
nebo TeX/LaTeX
.RB ( \-t ).
(Implicitní hodnota je urèena volbou DEFTEXFLAG pøi instalaci, ale
obvykle je z historických dùvodù nastavena na re¾im nroff/troff.)
Pokud není zmìnìna nìkterou z voleb pro nastavení formátu, bude
pøi zpracování souboru, jeho¾ jméno má pøíponu ".tex", nastavena
na TeX/LaTeX a pøi zpracování souboru, jeho¾ jméno má pøíponu
".html" nebo ".htm" na HTML.
V re¾imu HTML nebudou kontrolovány HTML znaèky mezi <>. Budou v¹ak
kontrolovány hodnoty atributù "ALT=" (pokud okolo rovnítka nejsou
mezery).
.PP
V re¾imu pro TeX/LaTeX
.I ispell
pøeskakuje znaky za zpìtnými lomítky ("\e"), dokud nenalezne mezeru
nebo oddìlovaè TeXu/LaTeXu. Jisté pøíkazy obsahují argumenty, které
nemají být kontrolovány (napøíklad návì¹tí a jména referencí v pøíkazu
\ecite), proto¾e mohou obsahovat libovolné neslovní argumenty. Kontrola
pøeklepù je také potlaèena v matematickém re¾imu.
Napøíklad v textu
.PP
.RS
\echapter {Tato kpitola}
\ecite{SCH86}
.RE
.PP
.I ispell
oznaèí za chybné slovo "kpitola" ale nikoli "SCH".
Volba
.B \-t
nerozpoznává komentáøové znaky "%" TeXu, tak¾e jsou kontrolovány
i komentáøe. Není-li dodr¾ena správná syntaxe, mohou být omylem
kontrolovány i pøíkazy LaTeXu. Také argumenty øídce pou¾ívaných
pøíkazù a nìkteré volitelné argumenty mohou být nìkdy kontrolovány
omylem. Bibliografie nebude kontrolována, jestli¾e byl
.I ispell
byl pøelo¾en s definovanou volbou
.BR IGNOREBIB .
Nikdy nebudou kontrolovány jména referencí.
.PP
Reference pro bibliografický systém
.I tib
tvoøené textem mezi ``[.'' nebo ``<.'' a ``.]'' nebo ``.>'',
budou v re¾imu TeX/LaTeX v¾dy ignorovány.
.PP
Pøi pou¾ití voleb
.B \-b
nebo
.B \-x
vytvoøí
.I ispell
pro ka¾dý kontrolovaný soubor zálo¾ní (.bak) kopii obsahující
pùvodní text pøed kontrolou pøeklepù. Pokud pøi práci se souborem
dojde k chybì, bude mo¾né obnovit pùvodní dokument ze zálo¾ního
souboru - a to i pøi pou¾ití volby
.BR \-x ,
která urèuje, ¾e po bezchybném skonèení se má zálo¾ní soubor smazat.
Implicitní nastavení této vlastnosti je urèeno hodnotou konstanty
DEFNOBACKUPFLAG pøi pøekladu.
.PP
Volby
.B \-B
a
.B \-C
stanovují, jak bude
.I ispell
zpracovávat spojená slova, jako "aletaké" místo "ale také".
S volbou
.B \-C
budou taková slova pova¾ována za chybná, a
.I ispell
bude vypisovat jejich variace s vlo¾enými mezerami nebo pomlèkami
jako mo¾né opravy.
Je-li zadána volba
.BR \-B ,
budou spojená slova pova¾ována za povolené slo¾eniny, pokud jsou obì
komponenty ve slovníku, a ka¾dá komponenta je pøinejmen¹ím tak dlouhá
jako jazykovì závislé minimum (implicitnì 3 znaky). Volba mù¾e být
u¾iteèná pro jazyky jako je nìmèina a nor¹tina, kde se mnoho slo¾ených
slov vytváøí prostým zøetìzením. (Slo¾eniny ze tøí nebo více
základních slov v¹ak budou stále pova¾ovány za chybu). Implicitní
hodnota pro tuto volbu je jazykovì závislá; ve vícejazyèných
instalacích mù¾e záviset na zvoleném slovníku.
.PP
Volby
.B \-P
a
.B \-m
urèují, kdy bude
.I ispell
pro slova, která nejsou ve slovníku, zobrazovat odhadnuté kombinace
koøen+afix (polo¾ky tvaru ??: Bo¾etìch+ovi v seznamu nabízených oprav).
Správná slova pak mù¾ete pøidat do svého osobního slovníku.
S volbou
.B \-P
budou tyto odhady zobrazovány pouze v pøípadì, ¾e neexistuje ¾ádná jiná
oprava; s volbou
.B \-m
budou zobrazovány v¾dy. To mù¾e být u¾iteèné, pokud slovník obsahuje
omezený seznam slov, nebo pokud slovùm v seznamu nejsou pøiøazeny
v¹echny správné afixy. Pøi pou¾ívání této volby v¹ak musíte být opatrní,
proto¾e mù¾e generovat chybná slova. Implicitní hodnota je urèena
pou¾itým slovníkem.
.PP
Volba
.B \-S
potlaèuje implicitní tøídìní seznamu oprav slova. Tím se v nìkterých
pøípadech mù¾e zvý¹it pravdìpodobnost, ¾e správné slovo bude na zaèátku
seznamu.
.PP
Pomocí volby
.B \-d
lze zadat jméno souboru s jiným ha¹ovaným slovníkem - napøíklad pro jiný
jazyk. Pokud zadané jméno souboru neobsahuje znak "/", bude
.I ispell
soubor hledat ve stejném knihovním adresáøi, jako je soubor s implicitním
slovníkem. Pokud chcete pou¾ít slovník umístìný v aktuálním adresáøi, je
nutné zadat "-d ./slovnik.hash". V souèasné verzi programu
.I ispell
ji¾ nelze jako slovník pou¾ít soubor
.IR /dev/null ,
proto¾e slovník musí obsahovat tabulku afixù. Jestli¾e potøebujete
efektivnì prázdný slovník, vytvoøte seznam obsahující jedinou polo¾ku
s nepravdìpodobným øetìzcem (napø. "qqqqq").
.PP
Volba
.B \-p
se pou¾ívá pro zadání alternativního osobního slovníku. Jestli¾e
jméno souboru nezaèíná znakem "/", pøedøadí se mu $HOME. Stejným
zpùsobem definuje jméno osobního slovníku promìnná prostøedí WORDLIST.
Volba z pøíkazového øádku má pøednost pøed nastavením pomocí
WORDLIST.
Jestli¾e není pou¾ita ani volba
.BR \-p ,
ani není nastavena promìnná prostøedí WORDLIST, bude
.I ispell
hledat osobní slovník v aktuálním adresáøi a poté v $HOME; pokud
ani jeden nebude nalezen, vytvoøí slovník v $HOME. Jméno souboru
s u¾ivatelským slovníkem je implicitnì vytvoøeno pøedøazením
øetìzce ".ispell_" pøed jméno základního slovníku. Pokud
napøíklad pou¾íváte anglický slovník, bude vá¹ osobní slovník
pojmenován ".ispell_english". Pokud ov¹em existuje
soubor ".ispell_words", bude pou¾íván jako osobní slovník bez
ohledu na zvolený hlavní slovník. Dùvodem tohoto chování je zpìtná
kompatibilita.
.PP
Jestli¾e není zadána volba
.BR \-p ,
bude
.I ispell
hledat osobní slovník jak v aktuálním adresáøi, tak v domovském
adresáøi. Existují-li slovníky v obou, pou¾ije se obsah obou.
Pøi pøidávání slov do osobního slovníku budou slova pøednostnì
pøidávána do slovníku v aktuálním adresáøi. Pokud neexistuje,
budou pøidávána do slovníku v domovském adresáøi.
.PP
Pomocí volby
.B \-w
lze zadat, které nepísmenné znaky mají být pova¾ovány za znaky
povolené ve slovech. Napøíklad
.B \-w
"&" umo¾ní, aby "AT&T" bylo pova¾ováno za jedno slovo. V mnoha
technických dokumentech mù¾e být u¾iteèné takto pøidat znak
podtr¾ítko. Tato volba
také umo¾òuje velmi primitivní podporu 8-bitových mezinárodních
znakù. Netisknutelné znaky mohou být zadány zpùsobem obvyklým
v jazyce C - pomocí zpìtného lomítka následovaného osmièkovým
kódem znaku; napø. "\e014" znamená znak form feed. Kódy znakù
mohou být zadány také v desítkové soustavì; pak je nutné pøed
kódem zapsaným jednou a¾ tøemi èíslicemi pou¾ít znak "n".
Pokud byste napøíklad chtìli umo¾nit, aby se ve slovech mohly
vyskytovat ASCII znaky BEL (zvonek) a FF (nová stránka) (to je
samozøejmì nesmysl slou¾ící pouze pro ilustraci), bylo by
mo¾né pou¾ít
.PP
.RS
n007n012
.RE
.PP
Jiné èíslice ne¾ tøi následující znak "n" jsou obyèejnými èíslicemi.
Ani pou¾ití písmene "n" pro tento úèel nezpùsobuje ¾ádné problémy,
proto¾e písmena bez diakritiky jsou v¾dy pova¾ována za legální znaky,
které není nutné povolovat pomocí
.BR \-w .
Program
.I ispell
se obvykle pou¾ívá pro zpracování obsahu souboru, tak¾e implicitní
zpracovávání 8-bitových znakù nepùsobí potí¾e. Je-li ale vstupní text
naèítán z terminálu s pou¾itím volby
.BR -l ,
budou problémy, pokud je stty nastaveno tak, ¾e osmý bit je paritní.
.PP
Nìkteré znaky nelze pou¾ít jako argument volby
.B \-w
- jmenovitì znak pro oznaèení jazyka (definovaný v souboru afixù -
obvykle "/").
Volba
.B \-W
stanovuje maximální délku slov, která
.I ispell
bude v¾dy pova¾ovat za správná. Implicitní hodnota je 1, tak¾e
.I ispell
implicitnì jednoznaková slova nekontroluje a pova¾uje je za správná.
(Ve skuteènosti je implicitní hodnota této volby urèena parametrem
MINWORD, který lze zadat pøi pøekladu, tak¾e ve va¹í instalaci mù¾e
být jiná.) Jestli¾e chcete, aby byla kontrolována v¹echna slova bez
ohledu na délku, musíte pou¾ít "\fB\-W 0\fR". Pokud naopak vá¹
dokument obsahuje velké mno¾ství tøípísmenných zkratek, které nejsou
ve slovníku, pou¾ijte "\fB\-W 3\fR".
Bez ohledu na nastavení této volby bude
.I ispell
jako mo¾né opravy generovat pouze slova, které jsou ve slovníku.
Jinak by byl seznam doporuèovaných oprav pøíli¹ dlouhý. Pou¾ívání
této volby mù¾e být samozøejmì velmi nebezpeèné, proto¾e chyby
v krátkých slovech budou ignorovány. Pokud ji pou¾íváte, je vhodné
udìlat poslední kontrolu dokumentu bez ní, aby byly odhaleny i chyby
v krátkých slovech.
.PP
Volba
.B \-T
.I typ
se pou¾ívá pro zadání implicitní volby stringchars, tj. zpùsobu, jak
jsou v dokumentu zakódovány ne-ASCII znaky pomocí øetìzcù známých
napøíklad z programu TeX (napø. \\'a pro znak "a s èárkou"). Tato volba
má pøednost pøed implicitním typem odvozeným ze jména souboru. Argument
.I typ
mù¾e být buï jedno z unikátních jmen definovaných v souboru afixù
(napø.
.BR nroff )
nebo pøípona souboru vèetnì teèky (napø.
.BR .tex ).
Není-li pou¾ita volba
.B \-T
a typ nelze urèit ze jména souboru, bude pou¾it implicitní nastavení
stringchars podle souboru afixù.
.PP
Volba
.B \-k
slou¾í ke zlep¹ení chování ispellu pøi zpracování nìkterých formátù.
Argument
.I jméno
udává jméno sady klíèových slov pro zpracování formátu (viz ní¾e) a
.I seznam
je seznam jednoho nebo více klíèových slov, které mají být zpracovávány
speciálním zpùsobem.
Pokud
.I seznam
zaèíná znakem "+" (plus), bude seznam pøidán k existujícím klíèovým slovùm.
Jinak bude pou¾it jako seznam klíèových slov. Napøíklad
.B "\-ktexskip1 +bibliographystyle"
pøidá "bibliographystyle" do TeXového seznamu texskip1. Podobnì
.B "\-khtmlignore pre,strong"
nahradí HTML seznam ignore slovy "pre" a "strong".
Lze pou¾ívat následující seznamy:
.IP texskip1
- pøíkazy TeXu/LaTeXu, které mají jeden argument, který nemá být
kontrolován - napøíklad "bibliographystyle". Implicitní hodnota je
"end", "vspace", "hspace", "cite", "ref", "parbox", "label", "input",
"nocite", "include", "includeonly", "documentstyle", "documentclass",
"usepackage", "selectlanguage", "pagestyle", "pagenumbering",
"hyphenation", "pageref" a "psfig", plus v nìkterých instalacích
"bibliography".
V klíèových slovech se rozli¹ují malá a velká písmena.
.IP texskip2
- pøíkazy TeXu/LaTeXu, které mají dva argumenty, které nemají být
kontrolovány - napøíklad "setlength". Implicitní hodnota je
"rule", "setcounter", "addtocounter", "setlength", "addtolength" a
"settowidth".
V klíèových slovech se rozli¹ují malá a velká písmena.
.IP htmlignore
- párové HTML znaèky, které ohranièují text, který nemá být kontrolován.
Implicitní hodnota je "code", "samp", "kbd", "pre", "listing" a "address".
V klíèových slovech se nerozli¹ují malá a velká písmena.
Pamatujte, ¾e text uvnitø HTML znaèek jako je "HREF=" se normálnì
nekontroluje.
.IP htmlcheck
- parametry, jejich¾ hodnoty mají být kontrolovány i uvnitø HTML znaèek.
Implicitní hodnota je "alt", tak¾e hodnota parametru "ALT=" ve znaèce
IMG bude kontrolována.
V klíèových slovech se nerozli¹ují malá a velká písmena.
.PP
V¹echny vý¹e uvedené seznamy klíèových slov mohou být modifikovány také
pomocí promìnných prostøedí, jejich¾ jména jsou stejná jako jména seznamù
(ale velkými písmeny - napø. TEXSKIP1).
Volba
.B \-k
má pøednost (nebo modifikuje) hodnoty zadané promìnnými prostøedí a
promìnné prostøedí mají pøednost (nebo modifikují) zabudované
implicitní hodnoty.
.PP
Volba
.B \-F
udává jméno externího programu, který odstraòuje znaèky ze souboru.
Program musí èíst data ze standardního vstupu a zapisovat na standardní
výstup.
Program
.I musí
produkovat jeden znak výstupu pro jeden znak vstupu, jinak
.I ispell
ztratí synchronizaci a po¹kodí obsah souboru. "Bílé znaky"
(mezery, tabelátory, znaky konce øádku, atd.) a øetìzce, ve kterých mají
být kontrolovány pøeklepy, musí být zkopírovány na výstup beze zmìn.
Èásti, ve kterých nemají být kontrolovány pøeklepy, musí být zmìnìny
na mezery nebo znaky, které nejsou pova¾ovány za souèást slov.
Napøíklad program pro odstraòování znaèek z HTML souboru mù¾e mìnit
v¹echny HTML znaèky a text ohranièený znaèkami jako "code" nebo "kbd"
na mezery.
.PP
Volba
.B \-F
je preferovaným zpùsobem pro odstraòování znaèek ze souborù pro ispell
a pozdìj¹í verze mohou podporovat pouze ji.
.PP
Pokud je
.I ispell
vyvolán bez parametrù a pøepínaèù, pobì¾í v interaktivním re¾imu,
který slou¾í pro kontrolování jednotlivých slov.
Program vypisuje výzvu "word:" a na zadání slov odpovídá buï "ok"
(s pøípadným komentáøem) nebo "not found" (nenalezeno) nebo
"how about" (a co napøíklad) následovaným seznamem návrhù opravy.
.PP
Volba
.B \-l
(list) slou¾í pro vypsání seznamu neznámých slov z textu èteného ze
standardního vstupu.
.PP
Volba
.B \-a
slou¾í pro komunikaci jiných programù s programem
.I ispell
pomocí roury. V tomto re¾imu
.I ispell
vypí¹e jednoøádkovou zprávu o své verzi, a pak zahájí ètení øádkù ze
vstupu. Pro ka¾dé vstupní slovo bude na standardní výstup vypsán jeden
øádek. Pokud se jedná o tvar slova, který je pøímo uveden v hlavním
nebo v osobním slovníku, bude øádek obsahovat pouze znak '*'. Pokud lze
slovo odvodit pomocí pravidel ze souboru afixù (tj. slovo by v normálním
re¾imu bylo pova¾ováno za bezchybné), bude øádek obsahovat znak '+',
mezeru a základní tvar slova. Pokud bylo slovo odvozeno zøetìzením dvou
slov (povoleného volbou
.BR \-C ),
pak øádek bude obsahovat pouze znak '\-'.
.PP
Jestli¾e slovo ve slovníku není, ale jsou tam podobná slova, pak øádek
bude obsahovat znak '&', mezeru, ¹patnì napsané slovo, mezeru, poèet
podobných slov, pozici slova na øádku (0 znamená, ¾e slovo bylo na
zaèátku øádku), dvojteèku, dal¹í mezeru a seznam podobných správných
slov oddìlených v¾dy èárkou a mezerou. Za podobnými slovy následují
odhady (které lze rozpoznat od podobných slov pouze tím, ¾e skuteèný
poèet slov je vìt¹í, ne¾ kolik bylo udáno), tj. zpùsoby, jak by mohlo
být slovo vytvoøeno pøidáním (ve slovníku pro daný základní tvar
nepovolených) afixù ke známému základnímu tvaru. Jednotlivé odhady
jsou také oddìleny èárkou a mezerou. Jestli¾e jsou v seznamu pouze
odhady a ¾ádná podobná slova,
bude formát øádku stejný, ale místo úvodního znaku '&' bude pou¾it
znak '?' (a poèet podobných slov bude v¾dy nula). Doporuèovaná odvození
v odhadech mají následující tvar:
.PP
.RS
[prefix+] koøen [-prefix] [-sufix] [+sufix]
.RE
.PP
(napø. "re+fry-y+ies" dává "refries"); ka¾dý nepovinný
.I prefix
a
.I sufix
je øetìzec.
V ka¾dém podobném slovì nebo odhadu jsou pou¾ita velká písmena stejným
zpùsobem jako ve vstupním slovì, pokud není takové pou¾ití velkých písmen
zakázáno; jinak jsou v podobných slovech pou¾ita velká písmena podle
slovníku.
.PP
Jestli¾e se slovo ve slovníku nevyskytuje, ani v nìm nejsou podobná
slova, pak øádek bude obsahovat znak '#', mezeru, ¹patnì napsané slovo,
mezeru a pozici slova na øádku (0 znamená, ¾e slovo bylo na zaèátku øádku).
.PP
Za posledním vypsaným záznamem bude jeden prázdný øádek, který oznaèuje, ¾e
.I ispell
dokonèil zpracování vstupního øádku.
.PP
Formát výstupních øádkù lze shrnout takto:
.PP
.RS
.IP Slovo:
.IP Správné:
*
.IP Koøen:
+ <koøen>
.IP Slo¾enina:
\-
.IP ©patné:
& <pùvodní> <poèet> <posunutí>: <podobné>, <podobné>, ..., <odhad>, ...
.IP Odhad:
? <pùvodní> 0 <posunutí>: <odhad>, <odhad>, ...
.IP Nenalezeno:
# <pùvodní> <posunutí>
.RE
.PP
Pokud by anglický slovník napøíklad obsahoval pouze slova "fray", "Frey",
"fry" a "refried", na pøíkaz
"echo 'frqy refries' | ispell -a -C -d ./fray.hash" by
.I ispell
odpovìdìl
.RS
.nf
@(#) International Ispell Version 3.1.20 10/10/95
& frqy 3 0: fray, Frey, fry
& refries 1 5: refried, re+fry-y+ies
.fi
.RE
.PP
Re¾im s volbou
.B \-a
mù¾e být vhodný i pro interaktivní pou¾ití, napøíklad pokud
chcete zjistit, jak se má psát jedno konkrétní slovo.
.PP
Volba
.B \-A
funguje stejnì jako volba
.BR \-a ,
ale pokud øádek zaèíná øetìzcem "&Include_File&", zbytek
øádku je pova¾ován za jméno souboru, jeho¾ obsah má být vlo¾en.
Po zpracování vlo¾eného souboru bude
.I ispell
pokraèovat ve zpracování pùvodního souboru. Maximální hloubka vnoøení
vlo¾ených souborù je 5. Øetìzec pou¾itý pro vlo¾ení souboru mù¾e být
zmìnìn pomocí promìnné prostøedí
.B INCLUDE_STRING
(znaky '&' musí být obsa¾eny).
.PP
V re¾imu
.B \-a
pøijímá
.I ispell
øádky obsahující jediné slovo s pøedøazeným nìkterým z následujících
znakù: '*', '&', '@', '+', '-', '~', '#', '!', '%', '`' nebo '^'.
Øádek zaèínající znakem '*' pøikazuje programu
.IR ispell ,
aby vlo¾il slovo do u¾ivatelského slovníku (jako interaktivní pøíkaz I);
øádek zaèínající znakem '&' pøikazuje
vlo¾it slovo pøevedené na malá písmena do u¾ivatelského slovníku
(jako interaktivní pøíkaz U);
øádek zaèínající znakem '@' zpùsobí, ¾e program
.I ispell
bude toto slovo pøí¹tì pøijímat (jako pøíkaz A);
øádek zaèínající znakem '+' následovaným (bez mezery) øetìzcem
.B tex
nebo
.B nroff
zpùsobí, ¾e
.I ispell
bude dal¹í vstup zpracovávat podle syntaxe zadaného formátu;
øádek obsahující pouze znak '+' pøepne
.I ispell
do re¾imu TeX/LaTeX (jako volba
.BR \-t )
a znak '-' pøepne
.I ispell
zpìt do re¾imu nroff/troff (poslední dva pøíkazy jsou zastaralé).
Nicménì typ øetìzcových znakù
.I není
tìmito pøíkazy zmìnìn; pro jeho zmìnu je tøeba pou¾ít pøíkaz '~'.
Øádek zaèínající znakem '~' zpùsobí, ¾e
.I ispell
nastaví interní parametr urèující implicitní typ øetìzcových
znakù podle jména souboru zadaného ve zbytku øádku. (Postaèuje
pøípona souboru s teèkou na zaèátku. Místo jména souboru nebo
pøípony mù¾e být pou¾ito unikátní jméno uvedené v souboru afixù.)
Pøíkaz '~'
.I nemìní
nastavení zpùsob zpracování (formát) zpracovávaného souboru;
pro jeho zmìnu musí být pou¾it pøíkaz '+'.
Øádek zaèínající znakem '#' zpùsobí, ¾e bude ulo¾en osobní slovník.
Øádek zaèínající znakem '!' zapne
.I struèný
re¾im (viz dále); øádek zaèínající znakem '%' pøepne
.I ispell
do normálního (nestruèného) re¾imu.
Øádek zaèínající '`' pøepne
.I ispell
do "upovídaného" re¾imu (viz ní¾e). Tento re¾im mù¾e být zakázán
pouze pomocí '%'.
.PP
Jakékoli znaky na øádku obsahujícím pøíkaz '+', '-', '#', '!', '`'
nebo '%' jsou ignorovány, stejnì jako libovolný vstup následující
jméno_souboru na øádku '~'. Aby bylo mo¾né kontrolovat øádky, které
zaèínají nìkterým z tìchto znakù, je nutné na zaèátek takových
øádkù pøidat znak '^'. Program
.I ispell
odstraní tento znak a zbytek øádku pøedá kódu na kontrolu pøeklepù.
Doporuèuje se, aby programy, které komunikují tímto zpùsobem s programem
.IR ispell ,
pøidávaly znak '^' na ka¾dý øádek, který má být kontrolován, aby
byly chránìny pøed budoucími zmìnami chování programu
.IR ispell .
.PP
Souhrn vý¹e uvedených pøíkazù:
.PP
.RS
.IP *
Pøidat slovo do osobního slovníku
.IP @
Slovo pøijmout, ale nevlo¾it jej do slovníku
.IP #
Ulo¾it aktuální osobní slovník
.IP ~
Nastavit parametry podle jména_souboru
.IP +
Zapnout re¾im TeX
.IP -
Ukonèit re¾im TeX
.IP !
Zapnout struèný re¾im
.IP %
Ukonèit struèný re¾im
.IP "`"
Vstoupit do "upovídaného" re¾imu.
.IP ^
Kontrolovat zbytek øádku
.fi
.RE
.PP
Ve
.I struèném
re¾imu nebude
.I ispell
tisknout øádky zaèínající znaky '*', '+' nebo '\-', které indikují
správná slova. To významnì zvy¹uje rychlost bìhu pokud øídící program
tato správná slova ignoruje.
.PP
V
.I "upovídaném"
re¾imu
.I ispell
vypisuje ve výstupních øádcích zaèínajících '*', '+' a '\-' pùvodní
slovo bezprostøednì za indikaèním znakem (slou¾í ke zjednodu¹ení
interakce s nìkterými programy).
.PP
Volba
.B \-s
je povolena pouze na systémech odvozených od BSD a pouze ve spojení
s volbami
.B \-a
nebo
.BR \-A .
S touto volbou program
.I ispell
sám sebe zastaví signálem
.B SIGTSTP
po ka¾dém vstupním øádku.
Pokraèovat bude a¾ po pøíchodu signálu
.BR SIGCONT .
Tato vlastnost slou¾í pro handshaking s urèitými textovými editory.
.PP
Volba
.B \-f
je povolena pouze ve spojení s volbami
.B \-a
nebo
.BR \-A .
S touto volbou bude
.I ispell
zapisovat výsledky do zadaného souboru místo standardního výstupu.
.PP
Volba
.B \-v
zpùsobí, ¾e
.I ispell
vypí¹e identifikaci své aktuální verzi na standardní výstup a skonèí.
Pokud se tato volba zdvojí, vypí¹e
.I ispell
také volby, se kterými byl pøelo¾en.
.PP
Volby
.BR \-c ,
.BR \-e [ 1-4 ]
a
.B \-D
programu
.I ispell
jsou primárnì urèeny pro pou¾ití shellovým skriptem
.IR munchlist .
Volba
.B \-c
zpùsobí, ¾e seznam slov bude èten ze standardního vstupu, a pro ka¾dé
slovo bude vypsán na standardní výstup seznam v¹ech mo¾ných kombinací
koøene a afixu, pomocí kterých lze dané slovo vygenerovat. Nìkteré
koøeny mohou být ¹patné a musí být odfiltrovány z výstupu jinými
prostøedky; to dìlá napøíklad skript
.IR munchlist .
Napøíklad pøíkaz
.PP
.RS
echo BOTHER | ispell -c
.RE
.PP
produkuje:
.PP
.RS