翻訳ドキュメント管理用
Revision | 9daef2dd9fa3202cdac9a19edc24830e18c6e1ec (tree) |
---|---|
Time | 2021-05-16 08:45:03 |
Author | Akihiro Motoki <amotoki@gmai...> |
Commiter | Akihiro Motoki |
GNU_texinfo: Upgrade original to 6.7
texinfo 6.7 was downloaded from https://ftp.gnu.org/gnu/texinfo/.
translation_list was updated using admin/git2upd and admin/upd_tl.perl.
infokey.1 was removed so obsoleted_list (generated by upd_tl.perl)
was newly added.
@@ -0,0 +1 @@ | ||
1 | +×:GNU texinfo:4.13:2008/09/18:infokey:1:::::dissap. at 6.7 |
@@ -1,101 +1,107 @@ | ||
1 | -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. | |
2 | -.TH INFO "1" "September 2008" "info 4.13" "User Commands" | |
1 | +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6. | |
2 | +.TH INFO "1" "September 2019" "info 6.7" "User Commands" | |
3 | 3 | .SH NAME |
4 | 4 | info \- read Info documents |
5 | 5 | .SH SYNOPSIS |
6 | 6 | .B info |
7 | -[\fIOPTION\fR]... [\fIMENU-ITEM\fR...] | |
7 | +[\fI\,OPTION\/\fR]... [\fI\,MENU-ITEM\/\fR...] | |
8 | 8 | .SH DESCRIPTION |
9 | 9 | Read documentation in Info format. |
10 | -.SH OPTIONS | |
10 | +.SS "Frequently-used options:" | |
11 | 11 | .TP |
12 | -\fB\-k\fR, \fB\-\-apropos\fR=\fISTRING\fR | |
13 | -look up STRING in all indices of all manuals. | |
12 | +\fB\-a\fR, \fB\-\-all\fR | |
13 | +use all matching manuals | |
14 | 14 | .TP |
15 | -\fB\-d\fR, \fB\-\-directory\fR=\fIDIR\fR | |
16 | -add DIR to INFOPATH. | |
15 | +\fB\-k\fR, \fB\-\-apropos\fR=\fI\,STRING\/\fR | |
16 | +look up STRING in all indices of all manuals | |
17 | 17 | .TP |
18 | -\fB\-\-dribble\fR=\fIFILENAME\fR | |
19 | -remember user keystrokes in FILENAME. | |
18 | +\fB\-d\fR, \fB\-\-directory\fR=\fI\,DIR\/\fR | |
19 | +add DIR to INFOPATH | |
20 | 20 | .TP |
21 | -\fB\-f\fR, \fB\-\-file\fR=\fIFILENAME\fR | |
22 | -specify Info file to visit. | |
21 | +\fB\-f\fR, \fB\-\-file\fR=\fI\,MANUAL\/\fR | |
22 | +specify Info manual to visit | |
23 | 23 | .TP |
24 | 24 | \fB\-h\fR, \fB\-\-help\fR |
25 | -display this help and exit. | |
25 | +display this help and exit | |
26 | 26 | .TP |
27 | -\fB\-\-index\-search\fR=\fISTRING\fR | |
28 | -go to node pointed by index entry STRING. | |
27 | +\fB\-\-index\-search\fR=\fI\,STRING\/\fR | |
28 | +go to node pointed by index entry STRING | |
29 | 29 | .TP |
30 | -\fB\-n\fR, \fB\-\-node\fR=\fINODENAME\fR | |
31 | -specify nodes in first visited Info file. | |
30 | +\fB\-n\fR, \fB\-\-node\fR=\fI\,NODENAME\/\fR | |
31 | +specify nodes in first visited Info file | |
32 | 32 | .TP |
33 | -\fB\-o\fR, \fB\-\-output\fR=\fIFILENAME\fR | |
34 | -output selected nodes to FILENAME. | |
35 | -.TP | |
36 | -\fB\-R\fR, \fB\-\-raw\-escapes\fR | |
37 | -output "raw" ANSI escapes (default). | |
38 | -.TP | |
39 | -\fB\-\-no\-raw\-escapes\fR | |
40 | -output escapes as literal text. | |
41 | -.TP | |
42 | -\fB\-\-restore\fR=\fIFILENAME\fR | |
43 | -read initial keystrokes from FILENAME. | |
33 | +\fB\-o\fR, \fB\-\-output\fR=\fI\,FILE\/\fR | |
34 | +output selected nodes to FILE | |
44 | 35 | .TP |
45 | 36 | \fB\-O\fR, \fB\-\-show\-options\fR, \fB\-\-usage\fR |
46 | -go to command\-line options node. | |
37 | +go to command\-line options node | |
47 | 38 | .TP |
48 | 39 | \fB\-\-subnodes\fR |
49 | -recursively output menu items. | |
40 | +recursively output menu items | |
50 | 41 | .TP |
51 | -\fB\-\-vi\-keys\fR | |
52 | -use vi\-like and less\-like key bindings. | |
42 | +\fB\-v\fR, \fB\-\-variable\fR VAR=VALUE | |
43 | +assign VALUE to Info variable VAR | |
53 | 44 | .TP |
54 | 45 | \fB\-\-version\fR |
55 | -display version information and exit. | |
46 | +display version information and exit | |
56 | 47 | .TP |
57 | 48 | \fB\-w\fR, \fB\-\-where\fR, \fB\-\-location\fR |
58 | -print physical location of Info file. | |
49 | +print physical location of Info file | |
59 | 50 | .PP |
60 | 51 | The first non\-option argument, if present, is the menu entry to start from; |
61 | -it is searched for in all `dir' files along INFOPATH. | |
62 | -If it is not present, info merges all `dir' files and shows the result. | |
52 | +it is searched for in all 'dir' files along INFOPATH. | |
53 | +If it is not present, info merges all 'dir' files and shows the result. | |
63 | 54 | Any remaining arguments are treated as the names of menu |
64 | 55 | items relative to the initial node visited. |
65 | 56 | .PP |
66 | -For a summary of key bindings, type h within Info. | |
57 | +For a summary of key bindings, type H within Info. | |
67 | 58 | .SH EXAMPLES |
68 | 59 | .TP |
69 | 60 | info |
70 | 61 | show top\-level dir menu |
71 | 62 | .TP |
72 | -info info | |
73 | -show the general manual for Info readers | |
74 | -.TP | |
75 | 63 | info info\-stnd |
76 | -show the manual specific to this Info program | |
64 | +show the manual for this Info program | |
77 | 65 | .TP |
78 | 66 | info emacs |
79 | 67 | start at emacs node from top\-level dir |
80 | 68 | .TP |
81 | 69 | info emacs buffers |
82 | -start at buffers node within emacs manual | |
70 | +select buffers menu entry in emacs manual | |
71 | +.TP | |
72 | +info emacs \-n Files | |
73 | +start at Files node within emacs manual | |
83 | 74 | .TP |
84 | -info \fB\-\-show\-options\fR emacs | |
75 | +info '(emacs)Files' | |
76 | +alternative way to start at Files node | |
77 | +.TP | |
78 | +info \-\-show\-options emacs | |
85 | 79 | start at node with emacs' command line options |
86 | 80 | .TP |
87 | -info \fB\-\-subnodes\fR \fB\-o\fR out.txt emacs | |
88 | -dump entire manual to out.txt | |
81 | +info \-\-subnodes \-o out.txt emacs | |
82 | +dump entire emacs manual to out.txt | |
89 | 83 | .TP |
90 | -info \fB\-f\fR ./foo.info | |
84 | +info \-f ./foo.info | |
91 | 85 | show file ./foo.info, not searching dir |
92 | 86 | .SH "REPORTING BUGS" |
93 | 87 | Email bug reports to bug\-texinfo@gnu.org, |
94 | 88 | general questions and discussion to help\-texinfo@gnu.org. |
89 | +.br | |
95 | 90 | Texinfo home page: http://www.gnu.org/software/texinfo/ |
96 | 91 | .SH COPYRIGHT |
97 | -Copyright \(co 2008 Free Software Foundation, Inc. | |
92 | +Copyright \(co 2019 Free Software Foundation, Inc. | |
98 | 93 | License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html> |
99 | 94 | .br |
100 | 95 | This is free software: you are free to change and redistribute it. |
101 | 96 | There is NO WARRANTY, to the extent permitted by law. |
97 | +.SH "SEE ALSO" | |
98 | +The full documentation for | |
99 | +.B info | |
100 | +is maintained as a Texinfo manual. If the | |
101 | +.B info | |
102 | +program is properly installed at your site, the command | |
103 | +.IP | |
104 | +.B info info | |
105 | +.PP | |
106 | +should give you access to the complete manual. | |
107 | +(Or, if you have Emacs, M-x info will lead to the manual.) |
@@ -1,42 +0,0 @@ | ||
1 | -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. | |
2 | -.TH INFOKEY "1" "September 2008" "infokey 4.13" "User Commands" | |
3 | -.SH NAME | |
4 | -infokey \- compile customizations for Info | |
5 | -.SH SYNOPSIS | |
6 | -.B infokey | |
7 | -[\fIOPTION\fR]... [\fIINPUT-FILE\fR] | |
8 | -.SH DESCRIPTION | |
9 | -Compile infokey source file to infokey file. Reads INPUT\-FILE (default | |
10 | -$HOME/.infokey) and writes compiled key file to (by default) $HOME/.info. | |
11 | -.SH OPTIONS | |
12 | -.TP | |
13 | -\fB\-\-output\fR FILE | |
14 | -output to FILE instead of $HOME/.info | |
15 | -.TP | |
16 | -\fB\-\-help\fR | |
17 | -display this help and exit. | |
18 | -.TP | |
19 | -\fB\-\-version\fR | |
20 | -display version information and exit. | |
21 | -.SH "REPORTING BUGS" | |
22 | -Email bug reports to bug\-texinfo@gnu.org, | |
23 | -general questions and discussion to help\-texinfo@gnu.org. | |
24 | -Texinfo home page: http://www.gnu.org/software/texinfo/ | |
25 | -.SH COPYRIGHT | |
26 | -Copyright \(co 2008 Free Software Foundation, Inc. | |
27 | -License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html> | |
28 | -.br | |
29 | -This is free software: you are free to change and redistribute it. | |
30 | -There is NO WARRANTY, to the extent permitted by law. | |
31 | -.SH "SEE ALSO" | |
32 | -The full documentation for | |
33 | -.B infokey | |
34 | -is maintained as a Texinfo manual. If the | |
35 | -.B info | |
36 | -and | |
37 | -.B infokey | |
38 | -programs are properly installed at your site, the command | |
39 | -.IP | |
40 | -.B info infokey | |
41 | -.PP | |
42 | -should give you access to the complete manual. |
@@ -1,14 +1,26 @@ | ||
1 | -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. | |
2 | -.TH INSTALL-INFO "1" "September 2008" "install-info 4.13" "User Commands" | |
1 | +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6. | |
2 | +.TH INSTALL-INFO "1" "September 2019" "install-info 6.7" "User Commands" | |
3 | 3 | .SH NAME |
4 | 4 | install-info \- update info/dir entries |
5 | 5 | .SH SYNOPSIS |
6 | 6 | .B install-info |
7 | -[\fIOPTION\fR]... [\fIINFO-FILE \fR[\fIDIR-FILE\fR]] | |
7 | +[\fI\,OPTION\/\fR]... [\fI\,INFO-FILE \/\fR[\fI\,DIR-FILE\/\fR]] | |
8 | 8 | .SH DESCRIPTION |
9 | 9 | Add or remove entries in INFO\-FILE from the Info directory DIR\-FILE. |
10 | +INFO\-FILE and DIR\-FILE are required unless the \fB\-\-info\-file\fR | |
11 | +or \fB\-\-dir\-file\fR (or \fB\-\-info\-dir\fR) options are given, respectively. | |
10 | 12 | .SH OPTIONS |
11 | 13 | .TP |
14 | +\fB\-\-add\-once\fR | |
15 | +add only to first matching section, not all. | |
16 | +.TP | |
17 | +\fB\-\-align\fR=\fI\,COL\/\fR | |
18 | +start description of new entries at column COL. | |
19 | +.TP | |
20 | +\fB\-\-calign\fR=\fI\,COL\/\fR | |
21 | +format second and subsequent description lines to | |
22 | +start at column COL. | |
23 | +.TP | |
12 | 24 | \fB\-\-debug\fR |
13 | 25 | report what is being done. |
14 | 26 | .TP |
@@ -16,52 +28,56 @@ report what is being done. | ||
16 | 28 | delete existing entries for INFO\-FILE from DIR\-FILE; |
17 | 29 | don't insert any new entries. |
18 | 30 | .TP |
19 | -\fB\-\-description\fR=\fITEXT\fR | |
31 | +\fB\-\-defsection\fR=\fI\,TEXT\/\fR | |
32 | +like \fB\-\-section\fR, but only use TEXT if no sections | |
33 | +are present in INFO\-FILE (replacing "Miscellaneous"). | |
34 | +.TP | |
35 | +\fB\-\-description\fR=\fI\,TEXT\/\fR | |
20 | 36 | the description of the entry is TEXT; used with |
21 | 37 | the \fB\-\-name\fR option to become synonymous with the |
22 | 38 | \fB\-\-entry\fR option. |
23 | 39 | .TP |
24 | -\fB\-\-dir\-file\fR=\fINAME\fR | |
40 | +\fB\-\-dir\-file\fR=\fI\,NAME\/\fR | |
25 | 41 | specify file name of Info directory file; |
26 | 42 | equivalent to using the DIR\-FILE argument. |
27 | 43 | .TP |
28 | 44 | \fB\-\-dry\-run\fR |
29 | 45 | same as \fB\-\-test\fR. |
30 | 46 | .TP |
31 | -\fB\-\-entry\fR=\fITEXT\fR | |
32 | -insert TEXT as an Info directory entry. | |
47 | +\fB\-\-entry\fR=\fI\,TEXT\/\fR | |
48 | +insert TEXT as an Info directory entry, | |
49 | +overriding any corresponding entry from DIR\-FILE. | |
33 | 50 | TEXT is written as an Info menu item line followed |
51 | +.TP | |
34 | 52 | by zero or more extra lines starting with whitespace. |
35 | -.IP | |
36 | 53 | If you specify more than one entry, all are added. |
37 | 54 | If you don't specify any entries, they are determined |
38 | -from information in the Info file itself. | |
39 | 55 | .IP |
40 | -When removing, TEXT specifies the entry to remove. | |
41 | -TEXT is only removed as a last resort, if the | |
42 | -entry as determined from the Info file is not present, | |
43 | -and the basename of the Info file isn't found either. | |
56 | +from information in the Info file itself. | |
44 | 57 | .TP |
45 | 58 | \fB\-\-help\fR |
46 | 59 | display this help and exit. |
47 | 60 | .TP |
48 | -\fB\-\-info\-dir\fR=\fIDIR\fR | |
49 | -same as \fB\-\-dir\-file\fR=\fIDIR\fR/dir. | |
61 | +\fB\-\-info\-dir\fR=\fI\,DIR\/\fR | |
62 | +same as \fB\-\-dir\-file\fR=\fI\,DIR\/\fR/dir. | |
50 | 63 | .TP |
51 | -\fB\-\-info\-file\fR=\fIFILE\fR | |
64 | +\fB\-\-info\-file\fR=\fI\,FILE\/\fR | |
52 | 65 | specify Info file to install in the directory; |
53 | 66 | equivalent to using the INFO\-FILE argument. |
54 | 67 | .TP |
55 | -\fB\-\-item\fR=\fITEXT\fR | |
56 | -same as \fB\-\-entry\fR=\fITEXT\fR. | |
68 | +\fB\-\-item\fR=\fI\,TEXT\/\fR | |
69 | +same as \fB\-\-entry\fR=\fI\,TEXT\/\fR. | |
57 | 70 | .TP |
58 | 71 | \fB\-\-keep\-old\fR |
59 | 72 | do not replace entries, or remove empty sections. |
60 | 73 | .TP |
61 | -\fB\-\-menuentry\fR=\fITEXT\fR | |
62 | -same as \fB\-\-name\fR=\fITEXT\fR. | |
74 | +\fB\-\-maxwidth\fR, \fB\-\-max\-width\fR=\fI\,COL\/\fR | |
75 | +wrap description at column COL. | |
76 | +.TP | |
77 | +\fB\-\-menuentry\fR=\fI\,TEXT\/\fR | |
78 | +same as \fB\-\-name\fR=\fI\,TEXT\/\fR. | |
63 | 79 | .TP |
64 | -\fB\-\-name\fR=\fITEXT\fR | |
80 | +\fB\-\-name\fR=\fI\,TEXT\/\fR | |
65 | 81 | the name of the entry is TEXT; used with \fB\-\-description\fR |
66 | 82 | to become synonymous with the \fB\-\-entry\fR option. |
67 | 83 | .TP |
@@ -71,7 +87,7 @@ do not format new entries in the DIR file. | ||
71 | 87 | \fB\-\-quiet\fR |
72 | 88 | suppress warnings. |
73 | 89 | .TP |
74 | -\fB\-\-regex\fR=\fIR\fR | |
90 | +\fB\-\-regex\fR=\fI\,R\/\fR | |
75 | 91 | put this file's entries in all sections that match the |
76 | 92 | regular expression R (ignoring case). |
77 | 93 | .TP |
@@ -82,16 +98,20 @@ same as \fB\-\-delete\fR. | ||
82 | 98 | only remove if the info file name matches exactly; |
83 | 99 | suffixes such as .info and .gz are not ignored. |
84 | 100 | .TP |
85 | -\fB\-\-section\fR=\fISEC\fR | |
101 | +\fB\-\-section\fR=\fI\,SEC\/\fR | |
86 | 102 | put entries in section SEC of the directory. |
87 | 103 | If you specify more than one section, all the entries |
104 | +.TP | |
88 | 105 | are added in each of the sections. |
89 | -.IP | |
90 | 106 | If you don't specify any sections, they are determined |
91 | -from information in the Info file itself. | |
107 | +.TP | |
108 | +from information in the Info file itself; | |
109 | +if nothing is available there, the \fB\-\-defsection\fR | |
110 | +value is used; if that is not specified, the | |
111 | +final default is "Miscellaneous". | |
92 | 112 | .TP |
93 | 113 | \fB\-\-section\fR R SEC |
94 | -equivalent to \fB\-\-regex\fR=\fIR\fR \fB\-\-section\fR=\fISEC\fR \fB\-\-add\-once\fR. | |
114 | +equivalent to \fB\-\-regex\fR=\fI\,R\/\fR \fB\-\-section\fR=\fI\,SEC\/\fR \fB\-\-add\-once\fR. | |
95 | 115 | .TP |
96 | 116 | \fB\-\-silent\fR |
97 | 117 | suppress warnings. |
@@ -104,9 +124,10 @@ display version information and exit. | ||
104 | 124 | .SH "REPORTING BUGS" |
105 | 125 | Email bug reports to bug\-texinfo@gnu.org, |
106 | 126 | general questions and discussion to help\-texinfo@gnu.org. |
127 | +.br | |
107 | 128 | Texinfo home page: http://www.gnu.org/software/texinfo/ |
108 | 129 | .SH COPYRIGHT |
109 | -Copyright \(co 2008 Free Software Foundation, Inc. | |
130 | +Copyright \(co 2019 Free Software Foundation, Inc. | |
110 | 131 | License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html> |
111 | 132 | .br |
112 | 133 | This is free software: you are free to change and redistribute it. |
@@ -1,21 +1,24 @@ | ||
1 | -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. | |
2 | -.TH MAKEINFO "1" "September 2008" "makeinfo 4.13" "User Commands" | |
1 | +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6. | |
2 | +.TH TEXI2ANY "1" "September 2019" "texi2any 6.7" "User Commands" | |
3 | 3 | .SH NAME |
4 | -makeinfo \- translate Texinfo documents | |
4 | +texi2any \- translate Texinfo documents | |
5 | 5 | .SH SYNOPSIS |
6 | 6 | .B makeinfo |
7 | -[\fIOPTION\fR]... \fITEXINFO-FILE\fR... | |
7 | +[\fI\,OPTION\/\fR]... \fI\,TEXINFO-FILE\/\fR... | |
8 | 8 | .SH DESCRIPTION |
9 | 9 | Translate Texinfo source documentation to various other formats, by default |
10 | 10 | Info files suitable for reading online with Emacs or standalone GNU Info. |
11 | +.PP | |
12 | +This program is commonly installed as both `makeinfo' and `texi2any'; | |
13 | +the behavior is identical, and does not depend on the installed name. | |
11 | 14 | .SS "General options:" |
12 | 15 | .TP |
13 | -\fB\-\-error\-limit\fR=\fINUM\fR | |
14 | -quit after NUM errors (default 100). | |
15 | -.TP | |
16 | -\fB\-\-document\-language\fR=\fISTR\fR locale to use in translating Texinfo keywords | |
16 | +\fB\-\-document\-language\fR=\fI\,STR\/\fR locale to use in translating Texinfo keywords | |
17 | 17 | for the output document (default C). |
18 | 18 | .TP |
19 | +\fB\-\-error\-limit\fR=\fI\,NUM\/\fR | |
20 | +quit after NUM errors (default 100). | |
21 | +.TP | |
19 | 22 | \fB\-\-force\fR |
20 | 23 | preserve output even if errors. |
21 | 24 | .TP |
@@ -28,6 +31,16 @@ suppress node cross\-reference validation. | ||
28 | 31 | \fB\-\-no\-warn\fR |
29 | 32 | suppress warnings (but not errors). |
30 | 33 | .TP |
34 | +\fB\-\-conf\-dir\fR=\fI\,DIR\/\fR | |
35 | +search also for initialization files in DIR. | |
36 | +.TP | |
37 | +\fB\-\-init\-file\fR=\fI\,FILE\/\fR | |
38 | +load FILE to modify the default behavior. | |
39 | +.TP | |
40 | +\fB\-c\fR, \fB\-\-set\-customization\-variable\fR VAR=VAL | |
41 | +set customization variable VAR | |
42 | +to value VAL. | |
43 | +.TP | |
31 | 44 | \fB\-v\fR, \fB\-\-verbose\fR |
32 | 45 | explain what is being done. |
33 | 46 | .TP |
@@ -41,32 +54,47 @@ output Docbook XML rather than Info. | ||
41 | 54 | \fB\-\-html\fR |
42 | 55 | output HTML rather than Info. |
43 | 56 | .TP |
57 | +\fB\-\-plaintext\fR | |
58 | +output plain text rather than Info. | |
59 | +.TP | |
44 | 60 | \fB\-\-xml\fR |
45 | 61 | output Texinfo XML rather than Info. |
46 | 62 | .TP |
47 | -\fB\-\-plaintext\fR | |
48 | -output plain text rather than Info. | |
63 | +\fB\-\-dvi\fR, \fB\-\-dvipdf\fR, \fB\-\-ps\fR, \fB\-\-pdf\fR | |
64 | +call texi2dvi to generate given output, | |
65 | +after checking validity of TEXINFO\-FILE. | |
49 | 66 | .SS "General output options:" |
50 | 67 | .TP |
51 | -\fB\-E\fR, \fB\-\-macro\-expand\fR=\fIFILE\fR | |
68 | +\fB\-E\fR, \fB\-\-macro\-expand\fR=\fI\,FILE\/\fR | |
52 | 69 | output macro\-expanded source to FILE, |
53 | 70 | ignoring any @setfilename. |
54 | 71 | .TP |
55 | 72 | \fB\-\-no\-headers\fR |
56 | 73 | suppress node separators, Node: lines, and menus |
57 | 74 | from Info output (thus producing plain text) |
58 | -or from HTML (thus producing shorter output); | |
59 | -also, write to standard output by default. | |
75 | +or from HTML (thus producing shorter output). | |
76 | +Also, if producing Info, write to | |
77 | +standard output by default. | |
60 | 78 | .TP |
61 | 79 | \fB\-\-no\-split\fR |
62 | -suppress the splitting of Info or HTML output, | |
80 | +suppress any splitting of the output; | |
63 | 81 | generate only one output file. |
64 | 82 | .TP |
65 | -\fB\-\-number\-sections\fR | |
66 | -output chapter and sectioning numbers. | |
83 | +\fB\-\-[no\-]number\-sections\fR | |
84 | +output chapter and sectioning numbers; | |
85 | +default is on. | |
86 | +.TP | |
87 | +\fB\-o\fR, \fB\-\-output\fR=\fI\,DEST\/\fR | |
88 | +output to DEST. | |
89 | +With split output, create DEST as a directory | |
90 | +.TP | |
91 | +and put the output files there. | |
92 | +With non\-split output, if DEST is already | |
67 | 93 | .TP |
68 | -\fB\-o\fR, \fB\-\-output\fR=\fIFILE\fR | |
69 | -output to FILE (or directory if split HTML). | |
94 | +a directory or ends with a /, | |
95 | +put the output file there. | |
96 | +.IP | |
97 | +Otherwise, DEST names the output file. | |
70 | 98 | .SS "Options for Info and plain text:" |
71 | 99 | .TP |
72 | 100 | \fB\-\-disable\-encoding\fR |
@@ -76,49 +104,63 @@ in Info output based on @documentencoding. | ||
76 | 104 | \fB\-\-enable\-encoding\fR |
77 | 105 | override \fB\-\-disable\-encoding\fR (default). |
78 | 106 | .TP |
79 | -\fB\-\-fill\-column\fR=\fINUM\fR | |
107 | +\fB\-\-fill\-column\fR=\fI\,NUM\/\fR | |
80 | 108 | break Info lines at NUM characters (default 72). |
81 | 109 | .TP |
82 | -\fB\-\-footnote\-style\fR=\fISTYLE\fR | |
110 | +\fB\-\-footnote\-style\fR=\fI\,STYLE\/\fR | |
83 | 111 | output footnotes in Info according to STYLE: |
84 | 112 | `separate' to put them in their own node; |
85 | 113 | `end' to put them at the end of the node, in |
86 | 114 | which they are defined (this is the default). |
87 | 115 | .TP |
88 | -\fB\-\-paragraph\-indent\fR=\fIVAL\fR | |
116 | +\fB\-\-paragraph\-indent\fR=\fI\,VAL\/\fR | |
89 | 117 | indent Info paragraphs by VAL spaces (default 3). |
90 | 118 | If VAL is `none', do not indent; if VAL is |
91 | 119 | `asis', preserve existing indentation. |
92 | 120 | .TP |
93 | -\fB\-\-split\-size\fR=\fINUM\fR | |
121 | +\fB\-\-split\-size\fR=\fI\,NUM\/\fR | |
94 | 122 | split Info files at size NUM (default 300000). |
95 | 123 | .SS "Options for HTML:" |
96 | 124 | .TP |
97 | -\fB\-\-css\-include\fR=\fIFILE\fR | |
125 | +\fB\-\-css\-include\fR=\fI\,FILE\/\fR | |
98 | 126 | include FILE in HTML <style> output; |
99 | 127 | read stdin if FILE is \-. |
100 | 128 | .TP |
101 | -\fB\-\-css\-ref\fR=\fIURL\fR | |
102 | -generate reference to a CSS file. | |
129 | +\fB\-\-css\-ref\fR=\fI\,URL\/\fR | |
130 | +generate CSS reference to URL. | |
103 | 131 | .TP |
104 | -\fB\-\-internal\-links\fR=\fIFILE\fR | |
132 | +\fB\-\-internal\-links\fR=\fI\,FILE\/\fR | |
105 | 133 | produce list of internal links in FILE. |
106 | 134 | .TP |
135 | +\fB\-\-split\fR=\fI\,SPLIT\/\fR | |
136 | +split at SPLIT, where SPLIT may be `chapter', | |
137 | +`section' or `node'. | |
138 | +.TP | |
107 | 139 | \fB\-\-transliterate\-file\-names\fR |
108 | -produce file names in ASCII transliteration. | |
140 | +use file names in ASCII transliteration. | |
141 | +.TP | |
142 | +\fB\-\-node\-files\fR | |
143 | +produce redirection files for nodes and | |
144 | +anchors; default is set only if split. | |
109 | 145 | .SS "Options for XML and Docbook:" |
110 | 146 | .TP |
111 | -\fB\-\-output\-indent\fR=\fIVAL\fR | |
112 | -indent XML elements by VAL spaces (default 2). | |
113 | -If VAL is 0, ignorable whitespace is dropped. | |
147 | +\fB\-\-output\-indent\fR=\fI\,VAL\/\fR | |
148 | +does nothing, retained for compatibility. | |
149 | +.SS "Options for DVI/PS/PDF:" | |
150 | +.TP | |
151 | +\fB\-\-Xopt\fR=\fI\,OPT\/\fR | |
152 | +pass OPT to texi2dvi; can be repeated. | |
114 | 153 | .SS "Input file options:" |
115 | 154 | .TP |
116 | 155 | \fB\-\-commands\-in\-node\-names\fR |
117 | -allow @ commands in node names. | |
156 | +does nothing, retained for compatibility. | |
118 | 157 | .TP |
119 | 158 | \fB\-D\fR VAR |
120 | 159 | define the variable VAR, as with @set. |
121 | 160 | .TP |
161 | +\fB\-D\fR 'VAR VAL' | |
162 | +define VAR to VAL (one shell argument). | |
163 | +.TP | |
122 | 164 | \fB\-I\fR DIR |
123 | 165 | append DIR to the @include search path. |
124 | 166 | .TP |
@@ -143,7 +185,7 @@ process @ifinfo even if not generating Info. | ||
143 | 185 | process @ifplaintext even if not generating plain text. |
144 | 186 | .TP |
145 | 187 | \fB\-\-iftex\fR |
146 | -process @iftex and @tex; implies \fB\-\-no\-split\fR. | |
188 | +process @iftex and @tex. | |
147 | 189 | .TP |
148 | 190 | \fB\-\-ifxml\fR |
149 | 191 | process @ifxml and @xml. |
@@ -169,6 +211,7 @@ do not process @ifxml and @xml text. | ||
169 | 211 | Also, for the \fB\-\-no\-ifFORMAT\fR options, do process @ifnotFORMAT text. |
170 | 212 | .P |
171 | 213 | The defaults for the @if... conditionals depend on the output format: |
214 | +if generating Docbook, \fB\-\-ifdocbook\fR is on and the others are off; | |
172 | 215 | if generating HTML, \fB\-\-ifhtml\fR is on and the others are off; |
173 | 216 | if generating Info, \fB\-\-ifinfo\fR is on and the others are off; |
174 | 217 | if generating plain text, \fB\-\-ifplaintext\fR is on and the others are off; |
@@ -178,45 +221,49 @@ if generating XML, \fB\-\-ifxml\fR is on and the others are off. | ||
178 | 221 | makeinfo foo.texi |
179 | 222 | write Info to foo's @setfilename |
180 | 223 | .TP |
181 | -makeinfo \fB\-\-html\fR foo.texi | |
224 | +makeinfo \-\-html foo.texi | |
182 | 225 | write HTML to @setfilename |
183 | 226 | .TP |
184 | -makeinfo \fB\-\-xml\fR foo.texi | |
227 | +makeinfo \-\-xml foo.texi | |
185 | 228 | write Texinfo XML to @setfilename |
186 | 229 | .TP |
187 | -makeinfo \fB\-\-docbook\fR foo.texi | |
188 | -write DocBook XML to @setfilename | |
230 | +makeinfo \-\-docbook foo.texi | |
231 | +write Docbook XML to @setfilename | |
189 | 232 | .TP |
190 | -makeinfo \fB\-\-no\-headers\fR foo.texi | |
233 | +makeinfo \-\-plaintext foo.texi | |
191 | 234 | write plain text to standard output |
192 | 235 | .TP |
193 | -makeinfo \fB\-\-html\fR \fB\-\-no\-headers\fR foo.texi | |
236 | +makeinfo \-\-pdf foo.texi | |
237 | +write PDF using texi2dvi | |
238 | +.TP | |
239 | +makeinfo \-\-html \-\-no\-headers foo.texi | |
194 | 240 | write html without node lines, menus |
195 | 241 | .TP |
196 | -makeinfo \fB\-\-number\-sections\fR foo.texi | |
242 | +makeinfo \-\-number\-sections foo.texi | |
197 | 243 | write Info with numbered sections |
198 | 244 | .TP |
199 | -makeinfo \fB\-\-no\-split\fR foo.texi | |
245 | +makeinfo \-\-no\-split foo.texi | |
200 | 246 | write one Info file however big |
201 | 247 | .SH "REPORTING BUGS" |
202 | 248 | Email bug reports to bug\-texinfo@gnu.org, |
203 | 249 | general questions and discussion to help\-texinfo@gnu.org. |
250 | +.br | |
204 | 251 | Texinfo home page: http://www.gnu.org/software/texinfo/ |
205 | 252 | .SH COPYRIGHT |
206 | -Copyright \(co 2008 Free Software Foundation, Inc. | |
253 | +Copyright \(co 2017 Free Software Foundation, Inc. | |
207 | 254 | License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html> |
208 | 255 | .br |
209 | 256 | This is free software: you are free to change and redistribute it. |
210 | 257 | There is NO WARRANTY, to the extent permitted by law. |
211 | 258 | .SH "SEE ALSO" |
212 | 259 | The full documentation for |
213 | -.B makeinfo | |
260 | +.B texi2any | |
214 | 261 | is maintained as a Texinfo manual. If the |
215 | 262 | .B info |
216 | 263 | and |
217 | -.B makeinfo | |
264 | +.B texi2any | |
218 | 265 | programs are properly installed at your site, the command |
219 | 266 | .IP |
220 | -.B info makeinfo | |
267 | +.B info texi2any | |
221 | 268 | .PP |
222 | 269 | should give you access to the complete manual. |
@@ -1,187 +1 @@ | ||
1 | -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. | |
2 | -.TH TEXI2DVI "1" "September 2008" "texi2dvi 1.135" "User Commands" | |
3 | -.SH NAME | |
4 | -texi2dvi \- convert Texinfo documents to PDF | |
5 | -.SH SYNOPSIS | |
6 | -.B texi2dvi | |
7 | -[\fIOPTION\fR]... \fIFILE\fR... | |
8 | -.SH DESCRIPTION | |
9 | -Run each Texinfo or (La)TeX FILE through TeX in turn until all | |
10 | -cross\-references are resolved, building all indices. The directory | |
11 | -containing each FILE is searched for included files. The suffix of FILE | |
12 | -is used to determine its language ((La)TeX or Texinfo). To process | |
13 | -(e)plain TeX files, set the environment variable LATEX=tex. | |
14 | -.PP | |
15 | -In order to make texi2dvi a drop\-in replacement of TeX/LaTeX in AUC\-TeX, | |
16 | -the FILE may also be composed of the following simple TeX commands. | |
17 | -.TP | |
18 | -`\einput{FILE}' | |
19 | -the actual file to compile | |
20 | -.TP | |
21 | -`\enonstopmode' | |
22 | -same as \fB\-\-batch\fR | |
23 | -.PP | |
24 | -Makeinfo is used to perform Texinfo macro expansion before running TeX | |
25 | -when needed. | |
26 | -.SS "General options:" | |
27 | -.TP | |
28 | -\fB\-b\fR, \fB\-\-batch\fR | |
29 | -no interaction | |
30 | -.TP | |
31 | -\fB\-D\fR, \fB\-\-debug\fR | |
32 | -turn on shell debugging (set \fB\-x\fR) | |
33 | -.TP | |
34 | -\fB\-h\fR, \fB\-\-help\fR | |
35 | -display this help and exit successfully | |
36 | -.TP | |
37 | -\fB\-o\fR, \fB\-\-output\fR=\fIOFILE\fR | |
38 | -leave output in OFILE (implies \fB\-\-clean\fR); | |
39 | -only one input FILE may be specified in this case | |
40 | -.TP | |
41 | -\fB\-q\fR, \fB\-\-quiet\fR | |
42 | -no output unless errors (implies \fB\-\-batch\fR) | |
43 | -.TP | |
44 | -\fB\-s\fR, \fB\-\-silent\fR | |
45 | -same as \fB\-\-quiet\fR | |
46 | -.TP | |
47 | -\fB\-v\fR, \fB\-\-version\fR | |
48 | -display version information and exit successfully | |
49 | -.TP | |
50 | -\fB\-V\fR, \fB\-\-verbose\fR | |
51 | -report on what is done | |
52 | -.SS "TeX tuning:" | |
53 | -.TP | |
54 | -\-@ | |
55 | -use @input instead of \einput for preloaded Texinfo | |
56 | -.TP | |
57 | -\fB\-\-dvi\fR | |
58 | -output a DVI file [default] | |
59 | -.TP | |
60 | -\fB\-\-dvipdf\fR | |
61 | -output a PDF file via DVI (using dvipdf) | |
62 | -.TP | |
63 | -\fB\-e\fR, \fB\-E\fR, \fB\-\-expand\fR | |
64 | -force macro expansion using makeinfo | |
65 | -.TP | |
66 | -\fB\-I\fR DIR | |
67 | -search DIR for Texinfo files | |
68 | -.TP | |
69 | -\fB\-l\fR, \fB\-\-language\fR=\fILANG\fR | |
70 | -specify LANG for FILE, either latex or texinfo | |
71 | -.TP | |
72 | -\fB\-\-no\-line\-error\fR | |
73 | -do not pass \fB\-\-file\-line\-error\fR to TeX | |
74 | -.TP | |
75 | -\fB\-p\fR, \fB\-\-pdf\fR | |
76 | -use pdftex or pdflatex for processing | |
77 | -.TP | |
78 | -\fB\-r\fR, \fB\-\-recode\fR | |
79 | -call recode before TeX to translate input | |
80 | -.TP | |
81 | -\fB\-\-recode\-from\fR=\fIENC\fR | |
82 | -recode from ENC to the @documentencoding | |
83 | -.TP | |
84 | -\fB\-\-src\-specials\fR | |
85 | -pass \fB\-\-src\-specials\fR to TeX | |
86 | -.TP | |
87 | -\fB\-t\fR, \fB\-\-command\fR=\fICMD\fR | |
88 | -insert CMD in copy of input file | |
89 | -.TP | |
90 | -or \fB\-\-texinfo\fR=\fICMD\fR | |
91 | -multiple values accumulate | |
92 | -.TP | |
93 | -\fB\-\-translate\-file\fR=\fIFILE\fR | |
94 | -use given charset translation file for TeX | |
95 | -.SS "Build modes:" | |
96 | -.TP | |
97 | -\fB\-\-build\fR=\fIMODE\fR | |
98 | -specify the treatment of auxiliary files [local] | |
99 | -.TP | |
100 | -\fB\-\-tidy\fR | |
101 | -same as \fB\-\-build\fR=\fItidy\fR | |
102 | -.TP | |
103 | -\fB\-c\fR, \fB\-\-clean\fR | |
104 | -same as \fB\-\-build\fR=\fIclean\fR | |
105 | -.TP | |
106 | -\fB\-\-build\-dir\fR=\fIDIR\fR | |
107 | -specify where the tidy compilation is performed; | |
108 | -implies \fB\-\-tidy\fR; | |
109 | -defaults to TEXI2DVI_BUILD_DIRECTORY [.] | |
110 | -.TP | |
111 | -\fB\-\-mostly\-clean\fR | |
112 | -remove the auxiliary files and directories | |
113 | -but not the output | |
114 | -.PP | |
115 | -The MODE specifies where the TeX compilation takes place, and, as a | |
116 | -consequence, how auxiliary files are treated. The build mode | |
117 | -can also be set using the environment variable TEXI2DVI_BUILD_MODE. | |
118 | -.SS "Valid MODEs are:" | |
119 | -.TP | |
120 | -`local' | |
121 | -compile in the current directory, leaving all the auxiliary | |
122 | -files around. This is the traditional TeX use. | |
123 | -.TP | |
124 | -`tidy' | |
125 | -compile in a local *.t2d directory, where the auxiliary files | |
126 | -are left. Output files are copied back to the original file. | |
127 | -.TP | |
128 | -`clean' | |
129 | -same as `tidy', but remove the auxiliary directory afterwards. | |
130 | -Every compilation therefore requires the full cycle. | |
131 | -.SS "Using the `tidy' mode brings several advantages:" | |
132 | -.TP | |
133 | -\- | |
134 | -the current directory is not cluttered with plethora of temporary files. | |
135 | -.TP | |
136 | -\- | |
137 | -clutter can be even reduced using \fB\-\-build\-dir\fR=\fIdir\fR: all the *.t2d | |
138 | -directories are stored there. | |
139 | -.TP | |
140 | -\- | |
141 | -clutter can be reduced to zero using, e.g., \fB\-\-build\-dir=\fR/tmp/$USER.t2d | |
142 | -or \fB\-\-build\-dir=\fR$HOME/.t2d. | |
143 | -.TP | |
144 | -\- | |
145 | -the output file is updated after every succesful TeX run, for | |
146 | -sake of concurrent visualization of the output. In a `local' build | |
147 | -the viewer stops during the whole TeX run. | |
148 | -.TP | |
149 | -\- | |
150 | -if the compilation fails, the previous state of the output file | |
151 | -is preserved. | |
152 | -.TP | |
153 | -\- | |
154 | -PDF and DVI compilation are kept in separate subdirectories | |
155 | -preventing any possibility of auxiliary file incompatibility. | |
156 | -.PP | |
157 | -On the other hand, because `tidy' compilation takes place in another | |
158 | -directory, occasionally TeX won't be able to find some files (e.g., when | |
159 | -using \egraphicspath): in that case use \fB\-I\fR to specify the additional | |
160 | -directories to consider. | |
161 | -.PP | |
162 | -The values of the BIBTEX, LATEX (or PDFLATEX), MAKEINDEX, MAKEINFO, | |
163 | -TEX (or PDFTEX), TEXINDEX, and THUMBPDF environment variables are used | |
164 | -to run those commands, if they are set. Any CMD strings are added | |
165 | -after @setfilename for Texinfo input, in the first line for LaTeX input. | |
166 | -.SH "REPORTING BUGS" | |
167 | -Email bug reports to <bug\-texinfo@gnu.org>, | |
168 | -general questions and discussion to <help\-texinfo@gnu.org>. | |
169 | -Texinfo home page: http://www.gnu.org/software/texinfo/ | |
170 | -.SH COPYRIGHT | |
171 | -Copyright \(co 2008 Free Software Foundation, Inc. | |
172 | -License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html> | |
173 | -.br | |
174 | -This is free software: you are free to change and redistribute it. | |
175 | -There is NO WARRANTY, to the extent permitted by law. | |
176 | -.SH "SEE ALSO" | |
177 | -The full documentation for | |
178 | -.B texi2dvi | |
179 | -is maintained as a Texinfo manual. If the | |
180 | -.B info | |
181 | -and | |
182 | -.B texi2dvi | |
183 | -programs are properly installed at your site, the command | |
184 | -.IP | |
185 | -.B info texi2dvi | |
186 | -.PP | |
187 | -should give you access to the complete manual. | |
1 | +.so man1/texi2dvi.1 |
@@ -0,0 +1,235 @@ | ||
1 | +.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35) | |
2 | +.\" | |
3 | +.\" Standard preamble: | |
4 | +.\" ======================================================================== | |
5 | +.de Sp \" Vertical space (when we can't use .PP) | |
6 | +.if t .sp .5v | |
7 | +.if n .sp | |
8 | +.. | |
9 | +.de Vb \" Begin verbatim text | |
10 | +.ft CW | |
11 | +.nf | |
12 | +.ne \\$1 | |
13 | +.. | |
14 | +.de Ve \" End verbatim text | |
15 | +.ft R | |
16 | +.fi | |
17 | +.. | |
18 | +.\" Set up some character translations and predefined strings. \*(-- will | |
19 | +.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left | |
20 | +.\" double quote, and \*(R" will give a right double quote. \*(C+ will | |
21 | +.\" give a nicer C++. Capital omega is used to do unbreakable dashes and | |
22 | +.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, | |
23 | +.\" nothing in troff, for use with C<>. | |
24 | +.tr \(*W- | |
25 | +.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' | |
26 | +.ie n \{\ | |
27 | +. ds -- \(*W- | |
28 | +. ds PI pi | |
29 | +. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch | |
30 | +. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch | |
31 | +. ds L" "" | |
32 | +. ds R" "" | |
33 | +. ds C` "" | |
34 | +. ds C' "" | |
35 | +'br\} | |
36 | +.el\{\ | |
37 | +. ds -- \|\(em\| | |
38 | +. ds PI \(*p | |
39 | +. ds L" `` | |
40 | +. ds R" '' | |
41 | +. ds C` | |
42 | +. ds C' | |
43 | +'br\} | |
44 | +.\" | |
45 | +.\" Escape single quotes in literal strings from groff's Unicode transform. | |
46 | +.ie \n(.g .ds Aq \(aq | |
47 | +.el .ds Aq ' | |
48 | +.\" | |
49 | +.\" If the F register is >0, we'll generate index entries on stderr for | |
50 | +.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index | |
51 | +.\" entries marked with X<> in POD. Of course, you'll have to process the | |
52 | +.\" output yourself in some meaningful fashion. | |
53 | +.\" | |
54 | +.\" Avoid warning from groff about undefined register 'F'. | |
55 | +.de IX | |
56 | +.. | |
57 | +.nr rF 0 | |
58 | +.if \n(.g .if rF .nr rF 1 | |
59 | +.if (\n(rF:(\n(.g==0)) \{\ | |
60 | +. if \nF \{\ | |
61 | +. de IX | |
62 | +. tm Index:\\$1\t\\n%\t"\\$2" | |
63 | +.. | |
64 | +. if !\nF==2 \{\ | |
65 | +. nr % 0 | |
66 | +. nr F 2 | |
67 | +. \} | |
68 | +. \} | |
69 | +.\} | |
70 | +.rr rF | |
71 | +.\" | |
72 | +.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). | |
73 | +.\" Fear. Run. Save yourself. No user-serviceable parts. | |
74 | +. \" fudge factors for nroff and troff | |
75 | +.if n \{\ | |
76 | +. ds #H 0 | |
77 | +. ds #V .8m | |
78 | +. ds #F .3m | |
79 | +. ds #[ \f1 | |
80 | +. ds #] \fP | |
81 | +.\} | |
82 | +.if t \{\ | |
83 | +. ds #H ((1u-(\\\\n(.fu%2u))*.13m) | |
84 | +. ds #V .6m | |
85 | +. ds #F 0 | |
86 | +. ds #[ \& | |
87 | +. ds #] \& | |
88 | +.\} | |
89 | +. \" simple accents for nroff and troff | |
90 | +.if n \{\ | |
91 | +. ds ' \& | |
92 | +. ds ` \& | |
93 | +. ds ^ \& | |
94 | +. ds , \& | |
95 | +. ds ~ ~ | |
96 | +. ds / | |
97 | +.\} | |
98 | +.if t \{\ | |
99 | +. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" | |
100 | +. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' | |
101 | +. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' | |
102 | +. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' | |
103 | +. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' | |
104 | +. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' | |
105 | +.\} | |
106 | +. \" troff and (daisy-wheel) nroff accents | |
107 | +.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' | |
108 | +.ds 8 \h'\*(#H'\(*b\h'-\*(#H' | |
109 | +.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] | |
110 | +.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' | |
111 | +.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' | |
112 | +.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] | |
113 | +.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] | |
114 | +.ds ae a\h'-(\w'a'u*4/10)'e | |
115 | +.ds Ae A\h'-(\w'A'u*4/10)'E | |
116 | +. \" corrections for vroff | |
117 | +.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' | |
118 | +.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' | |
119 | +. \" for low resolution devices (crt and lpr) | |
120 | +.if \n(.H>23 .if \n(.V>19 \ | |
121 | +\{\ | |
122 | +. ds : e | |
123 | +. ds 8 ss | |
124 | +. ds o a | |
125 | +. ds d- d\h'-1'\(ga | |
126 | +. ds D- D\h'-1'\(hy | |
127 | +. ds th \o'bp' | |
128 | +. ds Th \o'LP' | |
129 | +. ds ae ae | |
130 | +. ds Ae AE | |
131 | +.\} | |
132 | +.rm #[ #] #H #V #F C | |
133 | +.\" ======================================================================== | |
134 | +.\" | |
135 | +.IX Title "POD2TEXI 1" | |
136 | +.TH POD2TEXI 1 "2019-02-01" "perl v5.28.0" "User Contributed Perl Documentation" | |
137 | +.\" For nroff, turn off justification. Always turn off hyphenation; it makes | |
138 | +.\" way too many mistakes in technical documents. | |
139 | +.if n .ad l | |
140 | +.nh | |
141 | +.SH "NAME" | |
142 | +pod2texi \- convert Pod to Texinfo | |
143 | +.SH "SYNOPSIS" | |
144 | +.IX Header "SYNOPSIS" | |
145 | +.Vb 1 | |
146 | +\& pod2texi [OPTION]... POD... | |
147 | +.Ve | |
148 | +.SH "DESCRIPTION" | |
149 | +.IX Header "DESCRIPTION" | |
150 | +Translate Pod file(s) to Texinfo. There are two basic modes of | |
151 | +operation. First, by default, each pod is translated to a standalone | |
152 | +Texinfo manual. | |
153 | +.PP | |
154 | +Second, if \f(CW\*(C`\-\-base\-level\*(C'\fR is set higher than 0, each pod is translated | |
155 | +to a file suitable for \f(CW@include\fR, and one more file with all the | |
156 | +\&\f(CW@include\fRs is generated, intended to be \f(CW@include\fRd in turn within a | |
157 | +hand-written top-level file. | |
158 | +.SH "OPTIONS" | |
159 | +.IX Header "OPTIONS" | |
160 | +.IP "\fB\-\-appendix\-sections\fR" 4 | |
161 | +.IX Item "--appendix-sections" | |
162 | +Use appendix sectioning commands (\f(CW@appendix\fR, ...) instead of the | |
163 | +default numbered sectioning Texinfo @\-commands (\f(CW@chapter\fR, | |
164 | +\&\f(CW@section\fR, ...). | |
165 | +.IP "\fB\-\-base\-level\fR=\fINUM|NAME\fR" 4 | |
166 | +.IX Item "--base-level=NUM|NAME" | |
167 | +Sets the level of the \f(CW\*(C`head1\*(C'\fR commands. It may be an integer or a | |
168 | +Texinfo sectioning command (without the \f(CW\*(C`@\*(C'\fR): 1 corresponds to the | |
169 | +\&\f(CW@chapter\fR/\f(CW@unnumbered\fR level, 2 to the \f(CW@section\fR level, and so on. | |
170 | +The default is 0, meaning that \f(CW\*(C`head1\*(C'\fR commands are still output as | |
171 | +chapters, but the output is arranged as a standalone manual. | |
172 | +.Sp | |
173 | +If the level is not 0, the pod file is rendered as a fragment of a | |
174 | +Texinfo manual suitable for \f(CW@include\fR. In this case, each pod file | |
175 | +has an additional sectioning command covering the entire file, one level | |
176 | +above the \f(CW\*(C`\-\-base\-level\*(C'\fR value. Therefore, to make each pod file a | |
177 | +chapter in a large manual, you should use \f(CW\*(C`section\*(C'\fR as the base level. | |
178 | +.Sp | |
179 | +For an example of making Texinfo out of the Perl documentation itself, | |
180 | +see \f(CW\*(C`contrib/perldoc\-all\*(C'\fR in the Texinfo source distribution, with | |
181 | +output available at <http://www.gnu.org/software/perl/manual>. | |
182 | +.IP "\fB\-\-debug\fR=\fI\s-1NUM\s0\fR" 4 | |
183 | +.IX Item "--debug=NUM" | |
184 | +Set debugging level to \fI\s-1NUM\s0\fR. | |
185 | +.IP "\fB\-\-help\fR" 4 | |
186 | +.IX Item "--help" | |
187 | +Display help and exit. | |
188 | +.IP "\fB\-\-output\fR=\fI\s-1NAME\s0\fR" 4 | |
189 | +.IX Item "--output=NAME" | |
190 | +Name for the first manual, or the main manual if there is a main manual. | |
191 | +Default is to write to standard output. | |
192 | +.IP "\fB\-\-no\-section\-nodes\fR" 4 | |
193 | +.IX Item "--no-section-nodes" | |
194 | +Use anchors for sections instead of nodes. | |
195 | +.IP "\fB\-\-no\-fill\-section\-gaps\fR" 4 | |
196 | +.IX Item "--no-fill-section-gaps" | |
197 | +Do not fill sectioning gaps with empty \f(CW@unnumbered\fR files. | |
198 | +Ordinarily, it's good to keep the sectioning hierarchy intact. | |
199 | +.IP "\fB\-\-preamble\fR=\fI\s-1STR\s0\fR" 4 | |
200 | +.IX Item "--preamble=STR" | |
201 | +Insert \fI\s-1STR\s0\fR as top boilerplate before includes. The default is a | |
202 | +minimal beginning for a Texinfo document, and sets \f(CW@documentencoding\fR | |
203 | +to \f(CW\*(C`utf\-8\*(C'\fR (because the output is written that way). | |
204 | +.IP "\fB\-\-subdir\fR=\fI\s-1NAME\s0\fR" 4 | |
205 | +.IX Item "--subdir=NAME" | |
206 | +If there is a main manual with include files (each corresponding to | |
207 | +an input pod file), then those include files are put in directory \fI\s-1NAME\s0\fR. | |
208 | +.IP "\fB\-\-unnumbered\-sections\fR" 4 | |
209 | +.IX Item "--unnumbered-sections" | |
210 | +Use unnumbered sectioning commands (\f(CW@unnumbered\fR, ...) instead of the | |
211 | +default numbered sectioning Texinfo @\-commands (\f(CW@chapter\fR, | |
212 | +\&\f(CW@section\fR, ...). | |
213 | +.IP "\fB\-\-top\fR=\fI\s-1TOP\s0\fR" 4 | |
214 | +.IX Item "--top=TOP" | |
215 | +Name of the \f(CW@top\fR element for the main manual. May contain Texinfo code. | |
216 | +.IP "\fB\-\-version\fR" 4 | |
217 | +.IX Item "--version" | |
218 | +Display version information and exit. | |
219 | +.SH "SEE ALSO" | |
220 | +.IX Header "SEE ALSO" | |
221 | +Pod::Simple::Texinfo. perlpod. The Texinfo manual. | |
222 | +Texinfo home page: <http://www.gnu.org/software/texinfo/> | |
223 | +.SH "COPYRIGHT" | |
224 | +.IX Header "COPYRIGHT" | |
225 | +Copyright 2016 Free Software Foundation, Inc. | |
226 | +.PP | |
227 | +This program is free software; you can redistribute it and/or modify | |
228 | +it under the terms of the \s-1GNU\s0 General Public License as published by | |
229 | +the Free Software Foundation; either version 3 of the License, | |
230 | +or (at your option) any later version. | |
231 | +.PP | |
232 | +There is \s-1NO WARRANTY,\s0 to the extent permitted by law. | |
233 | +.SH "AUTHOR" | |
234 | +.IX Header "AUTHOR" | |
235 | +Patrice Dumas <bug\-texinfo@gnu.org>. |
@@ -0,0 +1 @@ | ||
1 | +.so man1/makeinfo.1 |
@@ -1,10 +1,16 @@ | ||
1 | -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. | |
2 | -.TH TEXI2DVI "1" "September 2008" "texi2dvi 1.135" "User Commands" | |
1 | +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6. | |
2 | +.TH TEXI2DVI "1" "September 2019" "texi2dvi (GNU Texinfo 6.7)" "User Commands" | |
3 | 3 | .SH NAME |
4 | -texi2dvi \- convert Texinfo documents to DVI | |
4 | +texi2dvi \- convert Texinfo documents to DVI or PDF | |
5 | 5 | .SH SYNOPSIS |
6 | 6 | .B texi2dvi |
7 | -[\fIOPTION\fR]... \fIFILE\fR... | |
7 | +[\fI\,OPTION\/\fR]... \fI\,FILE\/\fR... | |
8 | +.br | |
9 | +.B texi2pdf | |
10 | +[\fI\,OPTION\/\fR]... \fI\,FILE\/\fR... | |
11 | +.br | |
12 | +.B pdftexi2dvi | |
13 | +[\fI\,OPTION\/\fR]... \fI\,FILE\/\fR... | |
8 | 14 | .SH DESCRIPTION |
9 | 15 | Run each Texinfo or (La)TeX FILE through TeX in turn until all |
10 | 16 | cross\-references are resolved, building all indices. The directory |
@@ -12,110 +18,101 @@ containing each FILE is searched for included files. The suffix of FILE | ||
12 | 18 | is used to determine its language ((La)TeX or Texinfo). To process |
13 | 19 | (e)plain TeX files, set the environment variable LATEX=tex. |
14 | 20 | .PP |
15 | -In order to make texi2dvi a drop\-in replacement of TeX/LaTeX in AUC\-TeX, | |
16 | -the FILE may also be composed of the following simple TeX commands. | |
17 | -.TP | |
18 | -`\einput{FILE}' | |
19 | -the actual file to compile | |
20 | -.TP | |
21 | -`\enonstopmode' | |
22 | -same as \fB\-\-batch\fR | |
23 | -.PP | |
24 | -Makeinfo is used to perform Texinfo macro expansion before running TeX | |
25 | -when needed. | |
21 | +When invoked as `texi2pdf' or given the option \fB\-\-pdf\fR generate PDF output. | |
22 | +Otherwise, generate DVI. | |
26 | 23 | .SS "General options:" |
27 | 24 | .TP |
28 | -\fB\-b\fR, \fB\-\-batch\fR | |
29 | -no interaction | |
30 | -.TP | |
31 | 25 | \fB\-D\fR, \fB\-\-debug\fR |
32 | 26 | turn on shell debugging (set \fB\-x\fR) |
33 | 27 | .TP |
34 | 28 | \fB\-h\fR, \fB\-\-help\fR |
35 | 29 | display this help and exit successfully |
36 | 30 | .TP |
37 | -\fB\-o\fR, \fB\-\-output\fR=\fIOFILE\fR | |
38 | -leave output in OFILE (implies \fB\-\-clean\fR); | |
39 | -only one input FILE may be specified in this case | |
31 | +\fB\-o\fR, \fB\-\-output\fR=\fI\,OFILE\/\fR | |
32 | +leave output in OFILE; only one input FILE is allowed | |
40 | 33 | .TP |
41 | 34 | \fB\-q\fR, \fB\-\-quiet\fR |
42 | -no output unless errors (implies \fB\-\-batch\fR) | |
43 | -.TP | |
44 | -\fB\-s\fR, \fB\-\-silent\fR | |
45 | -same as \fB\-\-quiet\fR | |
35 | +no output unless errors | |
46 | 36 | .TP |
47 | 37 | \fB\-v\fR, \fB\-\-version\fR |
48 | 38 | display version information and exit successfully |
49 | 39 | .TP |
50 | 40 | \fB\-V\fR, \fB\-\-verbose\fR |
51 | 41 | report on what is done |
52 | -.SS "TeX tuning:" | |
53 | 42 | .TP |
54 | -\-@ | |
55 | -use @input instead of \einput for preloaded Texinfo | |
43 | +\fB\-\-max\-iterations\fR=\fI\,N\/\fR | |
44 | +don't process files more than N times [7] | |
45 | +.TP | |
46 | +\fB\-\-mostly\-clean\fR | |
47 | +remove auxiliary files or directories from | |
48 | +previous runs (but not the output) | |
49 | +.SS "Output format:" | |
56 | 50 | .TP |
57 | 51 | \fB\-\-dvi\fR |
58 | 52 | output a DVI file [default] |
59 | 53 | .TP |
60 | 54 | \fB\-\-dvipdf\fR |
61 | -output a PDF file via DVI (using dvipdf) | |
55 | +output a PDF file via DVI (using a dvi\-to\-pdf program) | |
56 | +.TP | |
57 | +\fB\-\-html\fR | |
58 | +output an HTML file from LaTeX, using HeVeA | |
62 | 59 | .TP |
63 | -\fB\-e\fR, \fB\-E\fR, \fB\-\-expand\fR | |
64 | -force macro expansion using makeinfo | |
60 | +\fB\-\-info\fR | |
61 | +output an Info file from LaTeX, using HeVeA | |
62 | +.TP | |
63 | +\fB\-p\fR, \fB\-\-pdf\fR | |
64 | +use pdftex or pdflatex for processing | |
65 | +.TP | |
66 | +\fB\-\-ps\fR | |
67 | +output a PostScript file via DVI (using dvips) | |
68 | +.TP | |
69 | +\fB\-\-text\fR | |
70 | +output a plain text file from LaTeX, using HeVeA | |
71 | +.SS "TeX tuning:" | |
72 | +.TP | |
73 | +\fB\-E\fR, \fB\-\-expand\fR | |
74 | +macro expansion using makeinfo | |
65 | 75 | .TP |
66 | 76 | \fB\-I\fR DIR |
67 | 77 | search DIR for Texinfo files |
68 | 78 | .TP |
69 | -\fB\-l\fR, \fB\-\-language\fR=\fILANG\fR | |
79 | +\fB\-l\fR, \fB\-\-language\fR=\fI\,LANG\/\fR | |
70 | 80 | specify LANG for FILE, either latex or texinfo |
71 | 81 | .TP |
72 | 82 | \fB\-\-no\-line\-error\fR |
73 | 83 | do not pass \fB\-\-file\-line\-error\fR to TeX |
74 | 84 | .TP |
75 | -\fB\-p\fR, \fB\-\-pdf\fR | |
76 | -use pdftex or pdflatex for processing | |
77 | -.TP | |
78 | -\fB\-r\fR, \fB\-\-recode\fR | |
79 | -call recode before TeX to translate input | |
80 | -.TP | |
81 | -\fB\-\-recode\-from\fR=\fIENC\fR | |
82 | -recode from ENC to the @documentencoding | |
85 | +\fB\-\-shell\-escape\fR | |
86 | +pass \fB\-\-shell\-escape\fR to TeX | |
83 | 87 | .TP |
84 | 88 | \fB\-\-src\-specials\fR |
85 | 89 | pass \fB\-\-src\-specials\fR to TeX |
86 | 90 | .TP |
87 | -\fB\-t\fR, \fB\-\-command\fR=\fICMD\fR | |
88 | -insert CMD in copy of input file | |
89 | -.TP | |
90 | -or \fB\-\-texinfo\fR=\fICMD\fR | |
91 | -multiple values accumulate | |
92 | -.TP | |
93 | -\fB\-\-translate\-file\fR=\fIFILE\fR | |
91 | +\fB\-\-translate\-file\fR=\fI\,FILE\/\fR | |
94 | 92 | use given charset translation file for TeX |
93 | +.TP | |
94 | +\fB\-t\fR, \fB\-\-command\fR=\fI\,CMD\/\fR | |
95 | +insert CMD in copy of input file | |
95 | 96 | .SS "Build modes:" |
96 | 97 | .TP |
97 | -\fB\-\-build\fR=\fIMODE\fR | |
98 | +\fB\-\-build\fR=\fI\,MODE\/\fR | |
98 | 99 | specify the treatment of auxiliary files [local] |
99 | 100 | .TP |
100 | 101 | \fB\-\-tidy\fR |
101 | -same as \fB\-\-build\fR=\fItidy\fR | |
102 | +same as \fB\-\-build\fR=\fI\,tidy\/\fR | |
102 | 103 | .TP |
103 | 104 | \fB\-c\fR, \fB\-\-clean\fR |
104 | -same as \fB\-\-build\fR=\fIclean\fR | |
105 | +same as \fB\-\-build\fR=\fI\,clean\/\fR | |
105 | 106 | .TP |
106 | -\fB\-\-build\-dir\fR=\fIDIR\fR | |
107 | +\fB\-\-build\-dir\fR=\fI\,DIR\/\fR | |
107 | 108 | specify where the tidy compilation is performed; |
108 | 109 | implies \fB\-\-tidy\fR; |
109 | 110 | defaults to TEXI2DVI_BUILD_DIRECTORY [.] |
110 | -.TP | |
111 | -\fB\-\-mostly\-clean\fR | |
112 | -remove the auxiliary files and directories | |
113 | -but not the output | |
114 | 111 | .PP |
115 | 112 | The MODE specifies where the TeX compilation takes place, and, as a |
116 | -consequence, how auxiliary files are treated. The build mode | |
117 | -can also be set using the environment variable TEXI2DVI_BUILD_MODE. | |
118 | -.SS "Valid MODEs are:" | |
113 | +consequence, how auxiliary files are treated. The build mode can also | |
114 | +be set using the environment variable TEXI2DVI_BUILD_MODE. | |
115 | +.SS "Valid values of MODE are:" | |
119 | 116 | .TP |
120 | 117 | `local' |
121 | 118 | compile in the current directory, leaving all the auxiliary |
@@ -128,47 +125,31 @@ are left. Output files are copied back to the original file. | ||
128 | 125 | `clean' |
129 | 126 | same as `tidy', but remove the auxiliary directory afterwards. |
130 | 127 | Every compilation therefore requires the full cycle. |
131 | -.SS "Using the `tidy' mode brings several advantages:" | |
132 | -.TP | |
133 | -\- | |
134 | -the current directory is not cluttered with plethora of temporary files. | |
135 | -.TP | |
136 | -\- | |
137 | -clutter can be even reduced using \fB\-\-build\-dir\fR=\fIdir\fR: all the *.t2d | |
138 | -directories are stored there. | |
139 | -.TP | |
140 | -\- | |
141 | -clutter can be reduced to zero using, e.g., \fB\-\-build\-dir=\fR/tmp/$USER.t2d | |
142 | -or \fB\-\-build\-dir=\fR$HOME/.t2d. | |
143 | -.TP | |
144 | -\- | |
145 | -the output file is updated after every succesful TeX run, for | |
146 | -sake of concurrent visualization of the output. In a `local' build | |
147 | -the viewer stops during the whole TeX run. | |
148 | -.TP | |
149 | -\- | |
150 | -if the compilation fails, the previous state of the output file | |
151 | -is preserved. | |
152 | -.TP | |
153 | -\- | |
154 | -PDF and DVI compilation are kept in separate subdirectories | |
155 | -preventing any possibility of auxiliary file incompatibility. | |
156 | 128 | .PP |
157 | -On the other hand, because `tidy' compilation takes place in another | |
158 | -directory, occasionally TeX won't be able to find some files (e.g., when | |
159 | -using \egraphicspath): in that case use \fB\-I\fR to specify the additional | |
160 | -directories to consider. | |
129 | +The values of these environment variables are used to run the | |
130 | +corresponding commands, if they are set: | |
131 | +.IP | |
132 | +BIBER BIBTEX DVIPDF DVIPS EGREP HEVEA LATEX MAKEINDEX MAKEINFO | |
133 | +PDFLATEX PDFTEX SED T4HT TEX TEX4HT TEXINDEX TEXINDY THUMBPDF_CMD | |
134 | +.PP | |
135 | +Regarding \fB\-\-dvipdf\fR, if DVIPDF is not set in the environment, the | |
136 | +following programs are looked for (in this order): dvipdfmx dvipdfm | |
137 | +dvipdf dvi2pdf dvitopdf. | |
138 | +.PP | |
139 | +If Texinfo is installed on your site, then the command | |
140 | +.IP | |
141 | +info texi2dvi | |
161 | 142 | .PP |
162 | -The values of the BIBTEX, LATEX (or PDFLATEX), MAKEINDEX, MAKEINFO, | |
163 | -TEX (or PDFTEX), TEXINDEX, and THUMBPDF environment variables are used | |
164 | -to run those commands, if they are set. Any CMD strings are added | |
165 | -after @setfilename for Texinfo input, in the first line for LaTeX input. | |
143 | +should give you access to more documentation. | |
166 | 144 | .SH "REPORTING BUGS" |
167 | -Email bug reports to <bug\-texinfo@gnu.org>, | |
168 | -general questions and discussion to <help\-texinfo@gnu.org>. | |
169 | -Texinfo home page: http://www.gnu.org/software/texinfo/ | |
145 | +Report bugs to bug\-texinfo@gnu.org, | |
146 | +general questions and discussion to help\-texinfo@gnu.org. | |
147 | +.br | |
148 | +GNU Texinfo home page: <http://www.gnu.org/software/texinfo/> | |
149 | +.br | |
150 | +General help using GNU software: <http://www.gnu.org/gethelp/> | |
170 | 151 | .SH COPYRIGHT |
171 | -Copyright \(co 2008 Free Software Foundation, Inc. | |
152 | +Copyright \(co 2019 Free Software Foundation, Inc. | |
172 | 153 | License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html> |
173 | 154 | .br |
174 | 155 | This is free software: you are free to change and redistribute it. |
@@ -1,187 +1 @@ | ||
1 | -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. | |
2 | -.TH TEXI2DVI "1" "September 2008" "texi2dvi 1.135" "User Commands" | |
3 | -.SH NAME | |
4 | -texi2dvi \- convert Texinfo documents to PDF | |
5 | -.SH SYNOPSIS | |
6 | -.B texi2dvi | |
7 | -[\fIOPTION\fR]... \fIFILE\fR... | |
8 | -.SH DESCRIPTION | |
9 | -Run each Texinfo or (La)TeX FILE through TeX in turn until all | |
10 | -cross\-references are resolved, building all indices. The directory | |
11 | -containing each FILE is searched for included files. The suffix of FILE | |
12 | -is used to determine its language ((La)TeX or Texinfo). To process | |
13 | -(e)plain TeX files, set the environment variable LATEX=tex. | |
14 | -.PP | |
15 | -In order to make texi2dvi a drop\-in replacement of TeX/LaTeX in AUC\-TeX, | |
16 | -the FILE may also be composed of the following simple TeX commands. | |
17 | -.TP | |
18 | -`\einput{FILE}' | |
19 | -the actual file to compile | |
20 | -.TP | |
21 | -`\enonstopmode' | |
22 | -same as \fB\-\-batch\fR | |
23 | -.PP | |
24 | -Makeinfo is used to perform Texinfo macro expansion before running TeX | |
25 | -when needed. | |
26 | -.SS "General options:" | |
27 | -.TP | |
28 | -\fB\-b\fR, \fB\-\-batch\fR | |
29 | -no interaction | |
30 | -.TP | |
31 | -\fB\-D\fR, \fB\-\-debug\fR | |
32 | -turn on shell debugging (set \fB\-x\fR) | |
33 | -.TP | |
34 | -\fB\-h\fR, \fB\-\-help\fR | |
35 | -display this help and exit successfully | |
36 | -.TP | |
37 | -\fB\-o\fR, \fB\-\-output\fR=\fIOFILE\fR | |
38 | -leave output in OFILE (implies \fB\-\-clean\fR); | |
39 | -only one input FILE may be specified in this case | |
40 | -.TP | |
41 | -\fB\-q\fR, \fB\-\-quiet\fR | |
42 | -no output unless errors (implies \fB\-\-batch\fR) | |
43 | -.TP | |
44 | -\fB\-s\fR, \fB\-\-silent\fR | |
45 | -same as \fB\-\-quiet\fR | |
46 | -.TP | |
47 | -\fB\-v\fR, \fB\-\-version\fR | |
48 | -display version information and exit successfully | |
49 | -.TP | |
50 | -\fB\-V\fR, \fB\-\-verbose\fR | |
51 | -report on what is done | |
52 | -.SS "TeX tuning:" | |
53 | -.TP | |
54 | -\-@ | |
55 | -use @input instead of \einput for preloaded Texinfo | |
56 | -.TP | |
57 | -\fB\-\-dvi\fR | |
58 | -output a DVI file [default] | |
59 | -.TP | |
60 | -\fB\-\-dvipdf\fR | |
61 | -output a PDF file via DVI (using dvipdf) | |
62 | -.TP | |
63 | -\fB\-e\fR, \fB\-E\fR, \fB\-\-expand\fR | |
64 | -force macro expansion using makeinfo | |
65 | -.TP | |
66 | -\fB\-I\fR DIR | |
67 | -search DIR for Texinfo files | |
68 | -.TP | |
69 | -\fB\-l\fR, \fB\-\-language\fR=\fILANG\fR | |
70 | -specify LANG for FILE, either latex or texinfo | |
71 | -.TP | |
72 | -\fB\-\-no\-line\-error\fR | |
73 | -do not pass \fB\-\-file\-line\-error\fR to TeX | |
74 | -.TP | |
75 | -\fB\-p\fR, \fB\-\-pdf\fR | |
76 | -use pdftex or pdflatex for processing | |
77 | -.TP | |
78 | -\fB\-r\fR, \fB\-\-recode\fR | |
79 | -call recode before TeX to translate input | |
80 | -.TP | |
81 | -\fB\-\-recode\-from\fR=\fIENC\fR | |
82 | -recode from ENC to the @documentencoding | |
83 | -.TP | |
84 | -\fB\-\-src\-specials\fR | |
85 | -pass \fB\-\-src\-specials\fR to TeX | |
86 | -.TP | |
87 | -\fB\-t\fR, \fB\-\-command\fR=\fICMD\fR | |
88 | -insert CMD in copy of input file | |
89 | -.TP | |
90 | -or \fB\-\-texinfo\fR=\fICMD\fR | |
91 | -multiple values accumulate | |
92 | -.TP | |
93 | -\fB\-\-translate\-file\fR=\fIFILE\fR | |
94 | -use given charset translation file for TeX | |
95 | -.SS "Build modes:" | |
96 | -.TP | |
97 | -\fB\-\-build\fR=\fIMODE\fR | |
98 | -specify the treatment of auxiliary files [local] | |
99 | -.TP | |
100 | -\fB\-\-tidy\fR | |
101 | -same as \fB\-\-build\fR=\fItidy\fR | |
102 | -.TP | |
103 | -\fB\-c\fR, \fB\-\-clean\fR | |
104 | -same as \fB\-\-build\fR=\fIclean\fR | |
105 | -.TP | |
106 | -\fB\-\-build\-dir\fR=\fIDIR\fR | |
107 | -specify where the tidy compilation is performed; | |
108 | -implies \fB\-\-tidy\fR; | |
109 | -defaults to TEXI2DVI_BUILD_DIRECTORY [.] | |
110 | -.TP | |
111 | -\fB\-\-mostly\-clean\fR | |
112 | -remove the auxiliary files and directories | |
113 | -but not the output | |
114 | -.PP | |
115 | -The MODE specifies where the TeX compilation takes place, and, as a | |
116 | -consequence, how auxiliary files are treated. The build mode | |
117 | -can also be set using the environment variable TEXI2DVI_BUILD_MODE. | |
118 | -.SS "Valid MODEs are:" | |
119 | -.TP | |
120 | -`local' | |
121 | -compile in the current directory, leaving all the auxiliary | |
122 | -files around. This is the traditional TeX use. | |
123 | -.TP | |
124 | -`tidy' | |
125 | -compile in a local *.t2d directory, where the auxiliary files | |
126 | -are left. Output files are copied back to the original file. | |
127 | -.TP | |
128 | -`clean' | |
129 | -same as `tidy', but remove the auxiliary directory afterwards. | |
130 | -Every compilation therefore requires the full cycle. | |
131 | -.SS "Using the `tidy' mode brings several advantages:" | |
132 | -.TP | |
133 | -\- | |
134 | -the current directory is not cluttered with plethora of temporary files. | |
135 | -.TP | |
136 | -\- | |
137 | -clutter can be even reduced using \fB\-\-build\-dir\fR=\fIdir\fR: all the *.t2d | |
138 | -directories are stored there. | |
139 | -.TP | |
140 | -\- | |
141 | -clutter can be reduced to zero using, e.g., \fB\-\-build\-dir=\fR/tmp/$USER.t2d | |
142 | -or \fB\-\-build\-dir=\fR$HOME/.t2d. | |
143 | -.TP | |
144 | -\- | |
145 | -the output file is updated after every succesful TeX run, for | |
146 | -sake of concurrent visualization of the output. In a `local' build | |
147 | -the viewer stops during the whole TeX run. | |
148 | -.TP | |
149 | -\- | |
150 | -if the compilation fails, the previous state of the output file | |
151 | -is preserved. | |
152 | -.TP | |
153 | -\- | |
154 | -PDF and DVI compilation are kept in separate subdirectories | |
155 | -preventing any possibility of auxiliary file incompatibility. | |
156 | -.PP | |
157 | -On the other hand, because `tidy' compilation takes place in another | |
158 | -directory, occasionally TeX won't be able to find some files (e.g., when | |
159 | -using \egraphicspath): in that case use \fB\-I\fR to specify the additional | |
160 | -directories to consider. | |
161 | -.PP | |
162 | -The values of the BIBTEX, LATEX (or PDFLATEX), MAKEINDEX, MAKEINFO, | |
163 | -TEX (or PDFTEX), TEXINDEX, and THUMBPDF environment variables are used | |
164 | -to run those commands, if they are set. Any CMD strings are added | |
165 | -after @setfilename for Texinfo input, in the first line for LaTeX input. | |
166 | -.SH "REPORTING BUGS" | |
167 | -Email bug reports to <bug\-texinfo@gnu.org>, | |
168 | -general questions and discussion to <help\-texinfo@gnu.org>. | |
169 | -Texinfo home page: http://www.gnu.org/software/texinfo/ | |
170 | -.SH COPYRIGHT | |
171 | -Copyright \(co 2008 Free Software Foundation, Inc. | |
172 | -License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html> | |
173 | -.br | |
174 | -This is free software: you are free to change and redistribute it. | |
175 | -There is NO WARRANTY, to the extent permitted by law. | |
176 | -.SH "SEE ALSO" | |
177 | -The full documentation for | |
178 | -.B texi2dvi | |
179 | -is maintained as a Texinfo manual. If the | |
180 | -.B info | |
181 | -and | |
182 | -.B texi2dvi | |
183 | -programs are properly installed at your site, the command | |
184 | -.IP | |
185 | -.B info texi2dvi | |
186 | -.PP | |
187 | -should give you access to the complete manual. | |
1 | +.so man1/texi2dvi.1 |
@@ -1,10 +1,10 @@ | ||
1 | -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36. | |
2 | -.TH TEXINDEX "1" "September 2008" "texindex 4.13" "User Commands" | |
1 | +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6. | |
2 | +.TH TEXINDEX "1" "September 2019" "texindex 6.7" "User Commands" | |
3 | 3 | .SH NAME |
4 | 4 | texindex \- sort Texinfo index files |
5 | 5 | .SH SYNOPSIS |
6 | 6 | .B texindex |
7 | -[\fIOPTION\fR]... \fIFILE\fR... | |
7 | +[\fI\,OPTION\/\fR]... \fI\,FILE\/\fR... | |
8 | 8 | .SH DESCRIPTION |
9 | 9 | Generate a sorted index for each TeX output FILE. |
10 | 10 | Usually FILE... is specified as `foo.??' for a document `foo.texi'. |
@@ -13,18 +13,19 @@ Usually FILE... is specified as `foo.??' for a document `foo.texi'. | ||
13 | 13 | \fB\-h\fR, \fB\-\-help\fR |
14 | 14 | display this help and exit |
15 | 15 | .TP |
16 | -\fB\-o\fR, \fB\-\-output\fR FILE | |
17 | -send output to FILE | |
18 | -.TP | |
19 | 16 | \fB\-\-version\fR |
20 | 17 | display version information and exit |
18 | +.TP | |
19 | +\fB\-\-\fR | |
20 | +end option processing | |
21 | 21 | .SH "REPORTING BUGS" |
22 | 22 | Email bug reports to bug\-texinfo@gnu.org, |
23 | 23 | general questions and discussion to help\-texinfo@gnu.org. |
24 | -Texinfo home page: http://www.gnu.org/software/texinfo/ | |
24 | +.br | |
25 | +Texinfo home page: https://www.gnu.org/software/texinfo/ | |
25 | 26 | .SH COPYRIGHT |
26 | -Copyright \(co 2008 Free Software Foundation, Inc. | |
27 | -License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html> | |
27 | +Copyright \(co 2019 Free Software Foundation, Inc. | |
28 | +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html> | |
28 | 29 | .br |
29 | 30 | This is free software: you are free to change and redistribute it. |
30 | 31 | There is NO WARRANTY, to the extent permitted by law. |
@@ -1,21 +1,10 @@ | ||
1 | 1 | .\" info(5) |
2 | -.\" $Id: info.5,v 1.3 2005/01/20 22:38:32 karl Exp $ | |
3 | 2 | .\" |
4 | -.\" Copyright (C) 1998 Free Software Foundation, Inc. | |
3 | +.\" Copyright 1998, 2005, 2011, 2019 Free Software Foundation, Inc. | |
5 | 4 | .\" |
6 | -.\" Permission is granted to make and distribute verbatim copies of this | |
7 | -.\" manual provided the copyright notice and this permission notice are | |
8 | -.\" preserved on all copies. | |
9 | -.\" | |
10 | -.\" Permission is granted to copy and distribute modified versions of | |
11 | -.\" this manual under the conditions for verbatim copying, provided that | |
12 | -.\" the entire resulting derived work is distributed under the terms of a | |
13 | -.\" permission notice identical to this one. | |
14 | -.\" | |
15 | -.\" Permission is granted to copy and distribute translations of this | |
16 | -.\" manual into another language, under the above conditions for modified | |
17 | -.\" versions, except that this permission notice may be stated in a | |
18 | -.\" translation approved by the Foundation. | |
5 | +.\" Copying and distribution of this file, with or without modification, | |
6 | +.\" are permitted in any medium without royalty provided the copyright | |
7 | +.\" notice and this notice are preserved. | |
19 | 8 | .\" |
20 | 9 | .de EX |
21 | 10 | .nf |
@@ -56,9 +45,7 @@ M-x info RET m texinfo RET | ||
56 | 45 | .EE |
57 | 46 | will get you there. |
58 | 47 | .SH AVAILABILITY |
59 | -ftp://ftp.gnu.org/pub/gnu/texinfo-<version>.tar.gz | |
60 | -.br | |
61 | -or any GNU mirror site. | |
48 | +http://www.gnu.org/software/texinfo/ | |
62 | 49 | .SH "REPORTING BUGS" |
63 | 50 | Please send bug reports to bug-texinfo@gnu.org, |
64 | 51 | general questions and discussion to help-texinfo@gnu.org. |
@@ -1,21 +1,10 @@ | ||
1 | 1 | .\" texinfo(5) |
2 | -.\" $Id: texinfo.5,v 1.3 2005/01/20 22:38:32 karl Exp $ | |
3 | 2 | .\" |
4 | -.\" Copyright (C) 1998, 1999, 2002 Free Software Foundation, Inc. | |
3 | +.\" Copyright 1998-2019 Free Software Foundation, Inc. | |
5 | 4 | .\" |
6 | -.\" Permission is granted to make and distribute verbatim copies of this | |
7 | -.\" manual provided the copyright notice and this permission notice are | |
8 | -.\" preserved on all copies. | |
9 | -.\" | |
10 | -.\" Permission is granted to copy and distribute modified versions of | |
11 | -.\" this manual under the conditions for verbatim copying, provided that | |
12 | -.\" the entire resulting derived work is distributed under the terms of a | |
13 | -.\" permission notice identical to this one. | |
14 | -.\" | |
15 | -.\" Permission is granted to copy and distribute translations of this | |
16 | -.\" manual into another language, under the above conditions for modified | |
17 | -.\" versions, except that this permission notice may be stated in a | |
18 | -.\" translation approved by the Foundation. | |
5 | +.\" Copying and distribution of this file, with or without modification, | |
6 | +.\" are permitted in any medium without royalty provided the copyright | |
7 | +.\" notice and this notice are preserved. | |
19 | 8 | .\" |
20 | 9 | .de EX |
21 | 10 | .nf |
@@ -47,7 +36,7 @@ M-x info RET m texinfo RET | ||
47 | 36 | .EE |
48 | 37 | will get you there. |
49 | 38 | .SH AVAILABILITY |
50 | -ftp://ftp.gnu.org/gnu/texinfo/ | |
39 | +http://www.gnu.org/software/texinfo/ | |
51 | 40 | .br |
52 | 41 | or any GNU mirror site. |
53 | 42 | .SH "REPORTING BUGS" |
@@ -1,10 +1,11 @@ | ||
1 | -☆:GNU texinfo:4.5=>4.13:2008/09/18:info:1:2000/08/08::man-jp@jp.FreeBSD.org:FreeBSD jpman project:http://www.jp.freebsd.org/man-jp/ | |
2 | -×:GNU texinfo:4.13:2008/09/18:infokey:1::::: | |
3 | -☆:GNU texinfo:4.5=>4.13:2008/09/18:install-info:1:2000/08/08::man-jp@jp.FreeBSD.org:FreeBSD jpman project:http://www.jp.freebsd.org/man-jp/ | |
4 | -☆:GNU texinfo:4.0=>4.13:2008/09/18:makeinfo:1:2000/08/08::man-jp@jp.FreeBSD.org:FreeBSD jpman project:http://www.jp.freebsd.org/man-jp/ | |
5 | -×:GNU texinfo:4.13:2008/09/18:pdftexi2dvi:1::::: | |
6 | -☆:GNU texinfo:4.5=>4.13:2008/09/18:texi2dvi:1:2003/04/23::lx6_ng31@zmail.ne.jp:OTSUJI Nobutaka: | |
7 | -×:GNU texinfo:4.13:2008/09/18:texi2pdf:1::::: | |
8 | -☆:GNU texinfo:4.5=>4.13:2008/09/18:texindex:1:2000/08/08::man-jp@jp.FreeBSD.org:FreeBSD jpman project:http://www.jp.freebsd.org/man-jp/ | |
9 | -☆:GNU texinfo:4.5=>4.13:2008/09/18:info:5:2000/08/08::man-jp@jp.FreeBSD.org:FreeBSD jpman project:http://www.jp.freebsd.org/man-jp/ | |
10 | -☆:GNU texinfo:4.5=>4.13:2008/09/18:texinfo:5:2000/08/08::man-jp@jp.FreeBSD.org:FreeBSD jpman project:http://www.jp.freebsd.org/man-jp/ | |
1 | +☆:GNU texinfo:4.5=>6.7:2019/09/23:info:1:2000/08/08::man-jp@jp.FreeBSD.org:FreeBSD jpman project:http://www.jp.freebsd.org/man-jp/ | |
2 | +☆:GNU texinfo:4.5=>6.7:2019/09/23:install-info:1:2000/08/08::man-jp@jp.FreeBSD.org:FreeBSD jpman project:http://www.jp.freebsd.org/man-jp/ | |
3 | +☆:GNU texinfo:4.0=>6.7:2019/09/23:makeinfo:1:2000/08/08::man-jp@jp.FreeBSD.org:FreeBSD jpman project:http://www.jp.freebsd.org/man-jp/ | |
4 | +@:GNU texinfo:6.7:2019/09/23:pdftexi2dvi:1:texi2dvi:1: | |
5 | +×:GNU texinfo:6.7:2019/02/01:pod2texi:1::::: | |
6 | +@:GNU texinfo:6.7:2019/09/23:texi2any:1:makeinfo:1: | |
7 | +☆:GNU texinfo:4.5=>6.7:2019/09/23:texi2dvi:1:2003/04/23::lx6_ng31@zmail.ne.jp:OTSUJI Nobutaka: | |
8 | +@:GNU texinfo:6.7:2019/09/23:texi2pdf:1:texi2dvi:1: | |
9 | +☆:GNU texinfo:4.5=>6.7:2019/09/23:texindex:1:2000/08/08::man-jp@jp.FreeBSD.org:FreeBSD jpman project:http://www.jp.freebsd.org/man-jp/ | |
10 | +☆:GNU texinfo:4.5=>6.7:2019/09/23:info:5:2000/08/08::man-jp@jp.FreeBSD.org:FreeBSD jpman project:http://www.jp.freebsd.org/man-jp/ | |
11 | +☆:GNU texinfo:4.5=>6.7:2019/09/23:texinfo:5:2000/08/08::man-jp@jp.FreeBSD.org:FreeBSD jpman project:http://www.jp.freebsd.org/man-jp/ |