debian/patches/10_fix-manpage-lilo-conf-5.patch

   1 Package:     lilo
   2 Subject:     fix manpage lilo.conf.5
   3 Author:      Bjarni Ingi Gislason <bjarniig at rhi.hi.is>
   4 Bug-Debian:  https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=919741
   5 Forwarded:   no
   6 Last-Update: 2019-12-10
   7 ---
   8
   9 diff -urN s09/man/lilo.conf.5 s10/man/lilo.conf.5
  10 --- s09/man/lilo.conf.5 2018-09-09 16:29:07.000000000 +0200
  11 +++ s10/man/lilo.conf.5 2019-12-10 23:29:54.262691441 +0100
  12 @@ -74,8 +74,8 @@
  13  to use lilo, and the interaction with other operating systems,
  14  see html/user_21-5.html inside the old documentation.)
  15  .LP
  16 -When booting, the boot loader will issue its
  17 -.I "boot:"
  18 +When booting, the boot loader will issue its
  19 +.B boot:
  20  prompt and wait for you to enter the label of the kernel (and any
  21  options) which you wish to boot. At any time you may hit [Tab] to
  22  see a list of kernel/other labels.
  23 @@ -140,7 +140,7 @@
  24  One way is the use of header information in the bitmap image (*.bmp) file:
  25  From a text file with all the information about 'bmp-colors', 'bmp-table'
  26  and 'bmp-timer' options together with the 'bitmap' option are stored in
  27 -the special LILO  header of the bitmap image file by the
  28 +the special LILO header of the bitmap image file by the
  29  .B lilo \-E
  30  command. Another way works without these special header information: All
  31  the information about 'bmp-colors', 'bmp-table' and 'bmp-timer' options
  32 @@ -200,7 +200,7 @@
  33  is for the root options.
  34  .sp
  35  If your boot device is a hard disk you need a special ID, which is supported
  36 -by udev. You find the right ID in the directory /dev/disks/by-id, i. e.:
  37 +by udev. You find the right ID in the directory /dev/disk/by-id, i.e.:
  38  .IP
  39  .nf
  40      boot = /dev/disk/by-id/ata-SAMSUNG_SV1604N_S01FJ10X999999
  41 @@ -255,7 +255,7 @@
  42  When `delay' is non-zero, the boot loader will wait for an interrupt for the
  43  specified interval. If an interrupt is received, or
  44  is already waiting, the \fBboot:\fP
  45 -prompt will be be issued, and no automatic boot will take place. The setting
  46 +prompt will be issued, and no automatic boot will take place. The setting
  47  of CAPS LOCK or SCROLL LOCK, or any of the
  48  keys ALT, CTRL, or SHIFT, when held down, are taken as interrupts.
  49
  50 @@ -317,16 +317,16 @@
  51  .sp
  52  In cases where there is no
  53  kernel partition information available, such as on loopback devices,
  54 -the 'disk=' specification may include paritition start information;
  55 +the 'disk=' specification may include partition start information;
  56  viz.,
  57  .sp
  58  .nf
  59         disk=/dev/loop0
  60              bios=0x80                  # use this BIOS code
  61              max-partitions=7           # declare partitionable
  62 -            paritition=/dev/loop1
  63 +            partition=/dev/loop1
  64                   start=63              # offset from sector 0
  65 -            paritition=/dev/loop2
  66 +            partition=/dev/loop2
  67                   start=102400          # offset from sector 0
  68  .fi
  69  .sp
  70 @@ -376,7 +376,7 @@
  71  .TP
  72  .BI "install=" <user-interface>
  73  Selects the user interface which will be seen at boot time.  One of the
  74 -following three options may be specified:  \fBtext\fP, \fBmenu\fP, or
  75 +following three options may be specified: \fBtext\fP, \fBmenu\fP, or
  76  \fBbmp\fP. The traditional LILO interface is `text'; but `menu' is now the
  77  default, unless the configuration file contains the `bitmap='
  78  specification.  The \fItext\fP interface is strictly a command-line
  79 @@ -391,9 +391,9 @@
  80  .TP
  81  .B large-memory
  82  Normally any initial ramdisk (initrd) loaded with a kernel is loaded as
  83 -high in memory as possible, but never above 15Mb.  This is due to a BIOS
  84 +high in memory as possible, but never above 15\~MB.  This is due to a BIOS
  85  limitation on older systems.  On newer systems, this option enables using
  86 -memory above 15Mb (up to a kernel imposed limit, around 768Mb) for
  87 +memory above 15\~MB (up to a kernel imposed limit, around 768\~MB) for
  88  passing the initrd to the kernel.  The presence of this option merely
  89  indicates that your system does not have the old BIOS limitation.
  90
  91 @@ -452,7 +452,7 @@
  92  title replaces the default "LILO Boot Menu" title string. If
  93  .I menu
  94  is not installed as the boot loader (see
  95 -.I "install="
  96 +.B install=
  97  option), then this line has no effect.
  98  .TP
  99  .BI "menu-scheme=" <color-scheme>
 100 @@ -474,7 +474,7 @@
 101  \fBB\fPlue, \fBG\fPreen, \fBC\fPyan, \fBR\fPed,
 102  \fBM\fPagenta, \fBY\fPellow, and \fBW\fPhite: upper case for
 103  intense (fg only), lower case for dim.
 104 -Legal color-scheme strings would be
 105 +Valid color-scheme strings would be
 106  .sp
 107  .nf
 108      menu-scheme=Wm     intense white on magenta
 109 @@ -483,7 +483,7 @@
 110  .fi
 111  .sp
 112  If
 113 -.I "menu"
 114 +.B menu
 115  is not installed as the boot loader, then this line has no effect.
 116  .TP
 117  .BI "message=" <message-file>
 118 @@ -528,8 +528,8 @@
 119  The per-image option `optional' (see below) applies to all images.
 120  .TP
 121  .BI "password=" <password>
 122 -The per-image option `password=...' (see below) applies to all images. This
 123 -option may prevent unattended booting, if the default image is `password='
 124 +The per-image option `password=.\|.\|.\&' (see below) applies to all images.
 125 +This option may prevent unattended booting, if the default image is `password='
 126  protected at the default level `mandatory', which is a level higher than
 127  `restricted'.
 128  .TP
 129 @@ -585,20 +585,20 @@
 130      <port>[,<bps>[<parity>[<bits>]]]
 131  .fi
 132  .sp
 133 -<port>:  the number of the serial port, zero-based. 0 corresponds to
 134 +<port>: the number of the serial port, zero-based. Zero (0) corresponds to
 135  COM1 alias /dev/ttyS0, etc. All four ports can be used (if present).
 136  .sp
 137 -<bps>:  the baud rate of the serial port. The following baud rates are
 138 -supported: 110, 150, 300, 600, 1200, 2400(default), 4800, 9600, plus the
 139 -extended rates 19200, 38400, and 57600(56000).  115200 is allowed, but may
 140 -not work with all COMx port hardware.
 141 -.sp
 142 -<parity>:  the parity used on the serial line. The boot loader ignores input
 143 -parity and strips the 8th bit. The following (upper or lower case)
 144 -characters are used to describe the parity:  "n" for no parity, "e"
 145 +<bps>: the baud rate of the serial port. The following baud rates are
 146 +supported: 110, 150, 300, 600, 1200, 2400 (default), 4800, 9600, plus the
 147 +extended rates 19200, 38400, and 57600 (56000).
 148 +The rate 115200 is allowed, but may not work with all COMx port hardware.
 149 +.sp
 150 +<parity>: the parity used on the serial line. The boot loader ignores input
 151 +parity and strips the 8th bit. The following (upper or lower case)
 152 +characters are used to describe the parity: "n" for no parity, "e"
 153  for even parity and "o" for odd parity.
 154  .sp
 155 -<bits>:  the number of bits in a character. Only 7 and 8 bits are
 156 +<bits>: the number of bits in a character. Only 7 and 8 bits are
 157  supported. Default is 8 if parity is "none", 7 if parity is "even"
 158  or "odd".
 159  .sp
 160 @@ -658,7 +658,10 @@
 161  .TP
 162  .BI "verbose=" <number>
 163  Turns on lots of progress reporting. Higher numbers give more verbose
 164 -output. If  \-v  is additionally specified on the lilo command line,
 165 +output.
 166 +If
 167 +.B \-v
 168 +is additionally specified on the lilo command line,
 169  the level is increased accordingly. The maximum verbosity level is 5.
 170  .TP
 171  .BI "vmdefault=" <name>
 172 @@ -712,19 +715,19 @@
 173  .BI "addappend=" <string>
 174  The kernel parameters of this string are concatenated to the
 175  parameter(s) from an
 176 -.B "append="
 177 +.B append=
 178  option (see below).
 179  The string of addappend must be enclosed within double quotes.
 180  Usually, the previous
 181 -.B "append="
 182 -will set parameters common to all kernels by appearing in the global
 183 +.B append=
 184 +will set parameters common to all kernels by appearing in the global
 185  section of the configuration file and
 186 -.B "addappend="
 187 +.B addappend=
 188  will be used to add local parameter(s) to an individual image.
 189  The addappend option may be used only once per "image=" section.
 190  .sp
 191 -If the string is a very long line, this line can be divided
 192 -in more lines using "\\" as last character of a line, e.g.
 193 +If the string is a very long line, this line can be divided
 194 +in more lines using "\e" as last character of a line, e.g.,
 195  .sp
 196  .nf
 197      addappend="noapic acpi=off pci=usepirqmask \\
 198 @@ -746,13 +749,14 @@
 199       append="mem=96M hd=576,64,32 console=ttyS1,9600"
 200  .fi
 201  .sp
 202 -If the string is a very long line, this line can be divided in more lines
 203 -using "\\" as last character of a line. See example of addappend option.
 204 +If the string is a very long line, this line can be divided in more lines
 205 +using "\e" as last character of a line. See example of addappend option.
 206  .TP
 207  .BI "initrd=" <name>
 208  Specifies the initial ramdisk image to be loaded with the kernel.  The
 209  image will contain modules needed at boot time, such as network and scsi
 210 -drivers. See man pages for \fImkinitrd(8)\fP.
 211 +drivers. See man pages for
 212 +.BR mkinitrd (8).
 213  .TP
 214  .BI "literal=" <string>
 215  Like `append', but removes all other options (e.g. setting of the root
 216 @@ -761,8 +765,8 @@
 217  this option cannot be set in the global options section.
 218  .TP
 219  .BI "ramdisk=" <size>
 220 -This specifies the size (e.g., "4096k") of the optional RAM disk. A value of
 221 -zero indicates that no RAM disk should be created. If this variable is
 222 +This specifies the size (e.g. "4096k") of the optional RAM disk. A value of
 223 +zero indicates that no RAM disk should be created. If this variable is
 224  omitted, the RAM disk size configured into the boot image is used.
 225  .TP
 226  .B read-only
 227 @@ -781,7 +785,8 @@
 228  If the special name
 229  .B current
 230  is used, the root device is set to the device on which the root file
 231 -system is currently mounted. If the root has been changed with  \-r ,
 232 +system is currently mounted. If the root has been changed with
 233 +.BR \-r ,
 234  the respective device is used. If the variable `root' is omitted,
 235  the root device setting contained in the running kernel image is used.
 236  Warning: This can induce to an unbootable system!
 237 @@ -800,7 +805,7 @@
 238       root="UUID=5472fd8e-9089-4256-bcaa-ceab4f01a439"
 239  .fi
 240  .sp
 241 -Note:  The command line
 242 +Note: The command line
 243  .I root=
 244  parameter passed to the kernel will be: 'root=LABEL=MyDisk'; i.e., without
 245  the quotation marks. If the
 246 @@ -838,7 +843,9 @@
 247  If this variable is omitted, the VGA mode setting contained in the
 248  kernel image is used. (And that is set at compile time using the
 249  SVGA_MODE variable in the kernel Makefile, and can later be changed with
 250 -the rdev(8) program.)
 251 +the
 252 +.BR rdev (8)
 253 +program.)
 254
 255  .SH "ALTERNATE SYSTEM (other=)"
 256  .LP
 257 @@ -872,8 +879,8 @@
 258  This keyword starts a section which describes how primary partition IDs are
 259  changed, and how primary partitions are activated and deactivated.  If
 260  .B change
 261 -is omitted, change rules are generated as though the
 262 -.I "automatic"
 263 +is omitted, change rules are generated as though the
 264 +.B automatic
 265  keyword were specified. The keyword
 266  .B change
 267  alone, without any rules following, will suppress automatic change-rules.
 268 @@ -987,7 +994,7 @@
 269  .BI "alias=" <name>
 270  A second name for the same entry can be used by specifying an alias.
 271  .TP
 272 -.B "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 @@ -1005,7 +1012,7 @@
 278  different (supposedly stable) kernel. The command line stored by the fallback
 279  mechanism is cleared by removing or changing the default command line
 280  with the
 281 -.I \-R
 282 +.B \-R
 283  option, which should be a part of the boot startup scripts.
 284  .TP
 285  .B lock
 286 @@ -1048,7 +1055,7 @@
 287  .TP
 288  .B restricted
 289  A password is only required to boot the image if kernel parameters
 290 -are specified on the command line (e.g. 'single').  May be used
 291 +are specified on the command line (e.g.\& 'single').  May be used
 292  on a single `image=' or `other=' to override a different global setting.
 293  .TP
 294  .B vmwarn
 295 @@ -1061,9 +1068,10 @@
 296  displayed as a boot option.  The image is only bootable in real mode.  See
 297  .I vmdefault
 298  above.
 299 -
 300 -.LP
 301 -
 302  .SH "SEE ALSO"
 303 -lilo(8), mkinitrd(8), mknod(1), mkrescue(8), rdev(8).
 304 +.BR lilo (8),
 305 +.BR mkinitrd (8),
 306 +.BR mknod (1),
 307 +.BR mkrescue (8),
 308 +.BR rdev (8).
 309