50c6a842d1420d8ba146c798985aa80a632c962c
[rrq/maintain_lilo.git] / debian / patches / 09_fix-manpage-lilo-conf-5.patch
1 Package:     lilo
2 Subject:     fix for manpage lilo.conf.5
3 Author:      Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
4 Bug-Debian:  https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=902711
5 Forwarded:   yes
6 Last-Update: 2018-09-09
7
8 Fix the warning: (macro BI): only 1 argument, but more are expected.
9 ---
10
11 diff -urN s08/man/lilo.conf.5 s09/man/lilo.conf.5
12 --- s08/man/lilo.conf.5 2016-07-15 22:02:52.000000000 +0200
13 +++ s09/man/lilo.conf.5 2018-09-09 15:41:31.019967938 +0200
14 @@ -141,7 +141,7 @@
15  From a text file with all the information about 'bmp-colors', 'bmp-table' 
16  and 'bmp-timer' options together with the 'bitmap' option are stored in 
17  the special LILO  header of the bitmap image file by the
18 -.BI "lilo -E"
19 +.B lilo \-E
20  command. Another way works without these special header information: All
21  the information about 'bmp-colors', 'bmp-table' and 'bmp-timer' options
22  together with the 'bitmap' option are stored in the configuration file.
23 @@ -158,7 +158,7 @@
24  then "none" is assumed.  The list entries are separated by commas, with no
25  spaces.
26  .TP
27 -.BI "bmp-retain"
28 +.B bmp-retain
29  Option applies to all 'image=' and 'other=' sections.
30  (See COMMON OPTIONS, below.)
31  .TP
32 @@ -206,7 +206,7 @@
33      boot = /dev/disk/by-id/ata-SAMSUNG_SV1604N_S01FJ10X999999
34  .fi
35  .TP
36 -.BI "change-rules"
37 +.B change-rules
38  Defines boot-time changes to partition type numbers (`hiding').
39  .IP
40  .nf
41 @@ -235,7 +235,7 @@
42  See section "Partition type change rules" of html/user_21-5.html inside 
43  the old documentation for more details.
44  .TP
45 -.BI "compact"
46 +.B compact
47  Tries to merge read requests for adjacent sectors into a single 
48  read request. This drastically reduces load time and keeps the map file
49  smaller. Using `compact' is especially recommended when booting
50 @@ -299,7 +299,7 @@
51  .sp
52  probably only useful for floppy disks and loopback devices,
53  because for hard disks the
54 -.BI lba32
55 +.B lba32
56  disk addressing option ignores disk geometry.
57  .sp
58  Developers who have implemented a disk driver for a new block storage
59 @@ -337,12 +337,12 @@
60  .I /etc/disktab
61  if `disktab' is omitted. The use of disktabs is discouraged.
62  .TP
63 -.BI "el-torito-bootable-CD"
64 +.B el-torito-bootable-CD
65  Flag second stage loader to terminate disk emulation when booting
66  from an El Torito Bootable CD. This option is used by the
67  \fBmkrescue\fP utility when the "\-\-iso" switch is specified.
68  .TP
69 -.BI "fix-table"
70 +.B fix-table
71  This allows lilo to adjust 3D addresses in partition tables. Each 
72  partition entry contains a 3D (cylinder/head/sector) and a linear 
73  address of the first and the last sector of the partition. If a 
74 @@ -364,14 +364,14 @@
75  Operation is identical to \fBbackup=\fP above, except an existing backup
76  file is unconditionally overwritten if it exists.
77  .TP
78 -.BI "geometric"
79 +.B geometric
80  Force disk addressing which is compatible with older versions of LILO. 
81  Geometric addressing uses cylinder/head/sector addresses, and is limited to
82  disk cylinders up to 1023.  If inaccessible cylinders are referenced,
83  diagnostics will be issued at boot-install time, rather than boot-time. 
84  With a newer BIOS, use of 'lba32' is recommended.
85  .TP
86 -.BI "ignore-table"
87 +.B ignore-table
88  tells lilo to ignore corrupt partition tables. 
89  .TP
90  .BI "install=" <user-interface>
91 @@ -389,7 +389,7 @@
92  (Prior to LILO version 22.3, `install=' specified the user interface as
93  a file in the `/boot' directory.)
94  .TP
95 -.BI "large-memory"
96 +.B large-memory
97  Normally any initial ramdisk (initrd) loaded with a kernel is loaded as
98  high in memory as possible, but never above 15Mb.  This is due to a BIOS
99  limitation on older systems.  On newer systems, this option enables using
100 @@ -403,7 +403,7 @@
101  kernel documentation for the kernel command line parameter
102  "mem=" for limiting the memory used by the kernel.)
103  .TP
104 -.BI "lba32"
105 +.B lba32
106  Generate 32-bit Logical Block Addresses instead of cylinder/head/sector 
107  addresses. If the BIOS supports packet addressing, then packet calls will be
108  used to access the disk. This allows booting from any partition on disks
109 @@ -415,7 +415,7 @@
110  all post-1998 systems.  Beginning with LILO version 22, 'lba32' is the
111  default disk addressing scheme.
112  .TP
113 -.BI "linear"
114 +.B linear
115  Generate 24-bit linear sector addresses instead of cylinder/head/sector 
116  (geometric) addresses. Linear addresses are translated at run time to
117  geometric addresses, and are limited to cylinders <= 1023. When using
118 @@ -426,12 +426,12 @@
119  recent BIOS (post-1998).  The 'linear' option is considered obsolete,
120  and its use is strongly discouraged.
121  .TP
122 -.BI "lock"
123 +.B lock
124  Enables automatic recording of boot command lines as the defaults 
125  for the following boots. This way, lilo "locks" on a choice until it is 
126  manually overridden.
127  .TP
128 -.BI "mandatory"
129 +.B mandatory
130  The per-image password option `mandatory' (see below) applies to all images.
131  .TP
132  .BI "map=" <map-file>
133 @@ -497,7 +497,7 @@
134  message file is changed or moved.  'message=' and 'bitmap=' are mutually
135  exclusive.
136  .TP
137 -.BI "nodevcache"
138 +.B nodevcache
139  (22.8)
140  Disables pre-loading of the internal device cache. May be needed for
141  Linux distributions which use non-standard device naming conventions;
142 @@ -513,7 +513,7 @@
143  The keyboard detection codes cannot detect the presence or absence of
144  a newer USB keyboard.
145  .TP
146 -.BI "noraid"
147 +.B noraid
148  Disables the automatic marking of disk volumes which are components of
149  RAID arrays as \fBinaccessible\fP.  This allows the user to edit the \fBdisk=\fP
150  / \fBinaccessible\fP declarations into the configuration file himself.  Without
151 @@ -521,10 +521,10 @@
152  confusing situations at boot-time, and possible failure to boot.  The use
153  of this keyword is generally not necessary.
154  .TP
155 -.BI "nowarn"
156 +.B nowarn
157  Disables warnings about possible future dangers.
158  .TP
159 -.BI "optional"
160 +.B optional
161  The per-image option `optional' (see below) applies to all images.
162  .TP
163  .BI "password=" <password>
164 @@ -533,7 +533,7 @@
165  protected at the default level `mandatory', which is a level higher than
166  `restricted'.
167  .TP
168 -.BI "prompt"
169 +.B prompt
170  Automatic booting (see `delay' above) will not take place unless a locked or
171  pre-stored ("lilo \-R") command line is present. Instead, the boot
172  loader will issue the 
173 @@ -568,7 +568,7 @@
174  one way to have it written. Use of \fImbr\fP is the other way to force
175  writing to the MBR of device 0x80.
176  .TP
177 -.BI "restricted"
178 +.B restricted
179  The per-image password option `restricted' (see below) applies to all images.
180  .TP
181  .BI "serial=" <parameters>
182 @@ -606,13 +606,13 @@
183  .sp
184  Example: "serial=0,2400n8" initializes COM1 with the default parameters.
185  .TP
186 -.BI "single-key"
187 +.B single-key
188  This option specifies that boot images or 'other's are to be selected and
189  launched with a single keystroke.  Selection is based upon the first
190  character of each name, which must be unique.  This option should not be
191  used with the menu or bitmap user interface ("install=").
192  .TP
193 -.BI "static-BIOS-codes"
194 +.B static-BIOS-codes
195  Causes the operation of the boot installer and boot loader to bypass the
196  use of Volume-ID information, and to revert to a mode of operation of
197  versions of LILO from 22.4 backward.  With Volume-ID booting (22.5 and later),
198 @@ -632,7 +632,7 @@
199  In general, this option should
200  never be used, except as a bug workaround.
201  .TP
202 -.BI "suppress-boot-time-BIOS-data"
203 +.B suppress-boot-time-BIOS-data
204  This global option suppresses the boot-time real mode collection of BIOS data
205  on systems which hang on certain BIOS calls.  It is equivalent to using the
206  boot-time switch 'nobd'.
207 @@ -649,7 +649,7 @@
208  If no key is pressed for the specified time, the default image is 
209  automatically booted. The default timeout is infinite.
210  .TP
211 -.BI "unattended"
212 +.B unattended
213  (22.6) Alters the operation of the "timeout" parameter in a manner which
214  is useful on
215  noisy serial lines.  Each typed (or noise) character restarts the "timeout"
216 @@ -765,13 +765,13 @@
217  zero indicates that no RAM disk should be created. If this variable is 
218  omitted, the RAM disk size configured into the boot image is used.
219  .TP
220 -.BI "read-only"
221 +.B read-only
222  This specifies that the root file system should be mounted read-only.
223  It may be specified as a global option.
224  Typically, the system startup procedure re-mounts the root 
225  file system read-write later (e.g. after fsck'ing it).
226  .TP
227 -.BI "read-write"
228 +.B read-write
229  This specifies that the root file system should be mounted read-write.
230  It may be specified as a global option.
231  .TP
232 @@ -868,7 +868,7 @@
233  Note that /sbin/lilo must be re-run if a partition table mapped referenced
234  with `table' is modified.
235  .TP
236 -.BI "change"
237 +.B change
238  This keyword starts a section which describes how primary partition IDs are
239  changed, and how primary partitions are activated and deactivated.  If
240  .B change
241 @@ -924,7 +924,7 @@
242  interfere with floppy disk BIOS device codes; "boot-as=" is then used as a
243  local option to override "master-boot" as necessary.
244  .TP
245 -.BI "master-boot"
246 +.B master-boot
247  This flag (LILO version 22.5) indicates a DOS/Windows or other
248  system which will only boot from BIOS device 0x80, the "C:" drive, or BIOS
249  device 0, the A: drive. When this
250 @@ -959,7 +959,7 @@
251  This option is largely
252  rendered obsolete by "boot-as=", introduced with LILO version 22.5.
253  .TP
254 -.BI "unsafe"
255 +.B unsafe
256  Do not access the boot sector at map creation time. This disables 
257  some sanity checks, including a partition table check. If the boot 
258  sector is on a fixed-format floppy disk device, using UNSAFE avoids the 
259 @@ -975,7 +975,7 @@
260  .BR image= " and " other=
261  cases, the following options apply.
262  .TP
263 -.BI "bypass"
264 +.B bypass
265  No password is required to boot this image. Used to indicate that the global
266  password does not apply to this `image=' or `other='.  See 'password=' below.
267  .TP
268 @@ -987,7 +987,7 @@
269  .BI "alias=" <name>
270  A second name for the same entry can be used by specifying an alias.
271  .TP
272 -.BI "bmp-retain"
273 +.B "bmp-retain
274  The bitmap graphic (install=bmp) is retained when control is passed to the
275  loaded kernel image, or other= bootloader; i.e., the screen is not
276  blanked to alphanumeric mode before starting the kernel.  This feature is
277 @@ -999,19 +999,19 @@
278  command line if the current image is booted. This is useful when 
279  experimenting with kernels which may crash before allowing interaction 
280  with the system. If using the
281 -.BI fallback
282 +.B fallback
283  option, the next reboot (e.g. 
284  triggered by a manual reset or by a watchdog timer) will load a 
285  different (supposedly stable) kernel. The command line stored by the fallback 
286  mechanism is cleared by removing or changing the default command line 
287  with the
288 -.IR "-R"
289 +.I \-R
290  option, which should be a part of the boot startup scripts.
291  .TP
292 -.BI "lock"
293 +.B lock
294  (See above.)
295  .TP
296 -.BI "optional"
297 +.B optional
298  Omit the image if it is not available at map creation time.
299  It may be specified as a global option.
300  This is useful to specify test kernels that are not always present.
301 @@ -1032,11 +1032,11 @@
302  will be issued telling you to re-run \fIlilo \-p\fP to force re-creation of the
303  password cache file.
304  .TP
305 -.BI "mandatory"
306 +.B mandatory
307  A password is required to boot this image. This is the default. May be used
308  on a single `image=' or `other=' to override a different global setting.
309  .TP
310 -.BI "nokbdisable"
311 +.B nokbdisable
312  (22.7.2)
313  The specified descriptor is not bootable if the IBM-PC keyboard is not present.
314  This option is really only useful if the "serial=" boot terminal is in use.
315 @@ -1046,17 +1046,17 @@
316  .I nokbdefault
317  above.
318  .TP
319 -.BI "restricted"
320 +.B restricted
321  A password is only required to boot the image if kernel parameters
322  are specified on the command line (e.g. 'single').  May be used
323  on a single `image=' or `other=' to override a different global setting.
324  .TP
325 -.BI "vmwarn"
326 +.B vmwarn
327  If booting under a virtual monitor such as VMware(tm), the image with this
328  label will cause a cautionary warning to be issued at boot time, and user
329  intervention will be required to continue or to abort the boot process.
330  .TP
331 -.BI "vmdisable"
332 +.B vmdisable
333  If booting under a virtual monitor, the image with this label will not be
334  displayed as a boot option.  The image is only bootable in real mode.  See
335  .I vmdefault