1INSTALL-INFO(1) User Commands INSTALL-INFO(1)
2
3
4
6 install-info - update info/dir entries
7
9 install-info [OPTION]... [INFO-FILE [DIR-FILE]]
10
12 Add or remove entries in INFO-FILE from the Info directory DIR-FILE.
13 INFO-FILE and DIR-FILE are required unless the --info-file or
14 --dir-file (or --info-dir) options are given, respectively.
15
17 --add-once
18 add only to first matching section, not all.
19
20 --align=COL
21 start description of new entries at column COL.
22
23 --calign=COL
24 format second and subsequent description lines to start at col‐
25 umn COL.
26
27 --debug
28 report what is being done.
29
30 --delete
31 delete existing entries for INFO-FILE from DIR-FILE; don't in‐
32 sert any new entries.
33
34 --defsection=TEXT
35 like --section, but only use TEXT if no sections are present in
36 INFO-FILE (replacing "Miscellaneous").
37
38 --description=TEXT
39 the description of the entry is TEXT; used with the --name op‐
40 tion to become synonymous with the --entry option.
41
42 --dir-file=NAME
43 specify file name of Info directory file; equivalent to using
44 the DIR-FILE argument.
45
46 --dry-run
47 same as --test.
48
49 --entry=TEXT
50 insert TEXT as an Info directory entry, overriding any corre‐
51 sponding entry from DIR-FILE. TEXT is written as an Info menu
52 item line followed
53
54 by zero or more extra lines starting with whitespace.
55 If you specify more than one entry, all are added. If you don't
56 specify any entries, they are determined
57
58 from information in the Info file itself.
59
60 --help display this help and exit.
61
62 --info-dir=DIR
63 same as --dir-file=DIR/dir.
64
65 --info-file=FILE
66 specify Info file to install in the directory; equivalent to us‐
67 ing the INFO-FILE argument.
68
69 --item=TEXT
70 same as --entry=TEXT.
71
72 --keep-old
73 do not replace entries, or remove empty sections.
74
75 --maxwidth, --max-width=COL
76 wrap description at column COL.
77
78 --menuentry=TEXT
79 same as --name=TEXT.
80
81 --name=TEXT
82 the name of the entry is TEXT; used with --description to become
83 synonymous with the --entry option.
84
85 --no-indent
86 do not format new entries in the DIR file.
87
88 --quiet
89 suppress warnings.
90
91 --regex=R
92 put this file's entries in all sections that match the regular
93 expression R (ignoring case).
94
95 --remove
96 same as --delete.
97
98 --remove-exactly
99 only remove if the info file name matches exactly; suffixes such
100 as .info and .gz are not ignored.
101
102 --section=SEC
103 put entries in section SEC of the directory. If you specify
104 more than one section, all the entries
105
106 are added in each of the sections.
107 If you don't specify any sections, they are determined
108
109 from information in the Info file itself;
110 if nothing is available there, the --defsection value is used;
111 if that is not specified, the final default is "Miscellaneous".
112
113 --section R SEC
114 equivalent to --regex=R --section=SEC --add-once.
115
116 --silent
117 suppress warnings.
118
119 --test suppress updating of DIR-FILE.
120
121 --version
122 display version information and exit.
123
125 Email bug reports to bug-texinfo@gnu.org, general questions and discus‐
126 sion to help-texinfo@gnu.org.
127 Texinfo home page: http://www.gnu.org/software/texinfo/
128
130 Copyright © 2023 Free Software Foundation, Inc. License GPLv3+: GNU
131 GPL version 3 or later <http://gnu.org/licenses/gpl.html>
132 This is free software: you are free to change and redistribute it.
133 There is NO WARRANTY, to the extent permitted by law.
134
136 The full documentation for install-info is maintained as a Texinfo man‐
137 ual. If the info and install-info programs are properly installed at
138 your site, the command
139
140 info install-info
141
142 should give you access to the complete manual.
143
144
145
146GNU texinfo 7.0.3 July 2023 INSTALL-INFO(1)