Package: lilo Version: 1:24.2-5 Severity: minor Tags: patch Input file is mkrescue.8
There is no table in the file, so remove first line. An empty line befor the first macro ".TH" produces an empty page (troff). Use '.' instead of an empty line to make "paragraphs" in the source. Empty lines create an empty line in the output. Test nr. 2: Enable and fix warnings from 'test-groff'. Output is from: test-groff -b -e -mandoc -T utf8 -rF0 -t -w w -z [ "test-groff" is a developmental version of "groff" ] <mkrescue.8>:98 (macro BI): only 1 argument, but more are expected <mkrescue.8>:107 (macro BI): only 1 argument, but more are expected <mkrescue.8>:114 (macro BI): only 1 argument, but more are expected <mkrescue.8>:141 (macro BI): only 1 argument, but more are expected #### Test nr. 7: Use an unpaddable space between number and its unit. 94:default on 1.2MB and 1.44MB floppy disks, and \fImenu\fP is the default 95:on 2.88MB floppies and HD emulation on CD-R media. 127:The default floppy disk size is \fI1440\fP, meaning a 1.44MB floppy. 130:a 1.2MB, 1.44MB or 2.88MB floppy, respectively. 134:the \fB--iso\fP option, to indicate a 16MB hard disk is to be generated ##### Test nr. 13: Change -- in x--y to \(em (em-dash), or, if an option, to \-\- 34:(\fB--iso\fP). 39:\fB--append\fP <string> 43:null string (\fB--append ""\fP). 46:.B --debug 53:\fB--device\fP <device> 59:.B --fast 61:This involves first creating a file of \fB--size\fP 1k blocks (default 66:\fB--fs\fP [ \fIext2\fP | \fImsdos\fP | \fIminix\fP ] 72:.B --help 76:\fB--image\fP <label> 82:\fB--initrd\fP \fI<filepath>\fP and \fB--kernel\fP \fI<filepath>\fP 88:specify \fB--initrd ""\fP, meaning a null pathname. 91:\fB--install\fP [ \fItext\fP | \fImenu\fP ] 98:.BI --iso 100:burning to a CD-R or CD-RW. The \fB--device\fP specification defaults to 101:the filename \fIrescue.iso\fP, and the \fB--size\fP defaults to 2880. 104:With this ISO option, the \fB--size\fP \fIHD\fP option is allowed. 107:.BI --nocompact 114:.BI --noformat 118:same filesystem as specified by \fB--fs\fP \fIXXX\fP (default is \fIext2\fP). 121:\fB--root\fP \fI<device>\fP 126:\fB--size\fP [ \fI1440\fP | \fI1200\fP | \fI2880\fP | \fIHD\fP ] 128:When \fB--iso\fP is specified, the default size is \fI2880\fP. 134:the \fB--iso\fP option, to indicate a 16MB hard disk is to be generated 141:.BI --version ##### Test nr. 25: Change a HYPHEN-MINUS (code 0x55, 2D) to a minus (\-), if in front of a name for an option. 110:This option will disable map compaction by omitting the lilo \fB-c\fP ##### Test nr. 36: Wrong distance between sentences or protect the indicator. a) Separate the sentences and subordinate clauses; each begins on a new line. See man-pages(7) and "info groff". Or b) Adjust space between sentences (two spaces), c) or protect the indicator by adding "\&" after it. The "indicator" is an "end-of-sentence character" (.!?). The amount of space in the output can then be controlled with the ".ss" request. 93:bootloader (configuration file "install=" option). \fItext\fP is the ##### Fix spelling of "specifation". #### Patch: --- mkrescue.8 2019-12-10 22:41:00.000000000 +0000 +++ mkrescue.8.new 2020-01-29 22:22:47.000000000 +0000 @@ -1,4 +1,3 @@ -'\" t .\" @(#)mkrescue.8 .\" This page is part of the LILO package, which is released by .\" the author(s) under a BSD license. See the file COPYING @@ -9,19 +8,19 @@ .\" Updated for lilo 22.6.1, John Coffman 2004-11-16 .\" Updated for lilo 23.1, Martin Eberhard Schauer 2011-03-06 .\" (Reformatted to better match Linux man-pages conventions) - +. .TH MKRESCUE 8 "6 Mar 2011" - +. .SH NAME mkrescue \- make rescue floppy or CD - +. .SH SYNOPSIS .B /sbin/mkrescue makes a bootable rescue floppy or CD using the default kernel specified in .IR lilo.conf . - +. .SH DESCRIPTION -\fBmkrescue\fP takes its specifation for the kernel from the default image +\fBmkrescue\fP takes its specification for the kernel from the default image specified in \fI/etc/lilo.conf\fP. If the actual default is an \fIother=\fP specification, then use the first \fIimage=\fP specification. @@ -31,116 +30,118 @@ The root directory will be taken to be t A bootable floppy or CD-image will be created using LILO version 22.5.5 or later. \fBmkrescue\fP normally requires no options, unless a CD-image is desired -(\fB--iso\fP). - +(\fB\-\-iso\fP). +. .SH OPTIONS - +. .TP -\fB--append\fP <string> +\fB\-\-append\fP <string> Override any \fIappend=\fP options taken from the default image. If there is any doubt about whether the \fIlilo.conf\fP options are correct, then specify no kernel parameters by providing the -null string (\fB--append ""\fP). - +null string (\fB\-\-append ""\fP). +. .TP -.B --debug +.B \-\-debug Provide verbose output of the operation of .BR mkrescue , pausing to allow the setting of internal operating parameters to be viewed. <CR> must be hit to proceed from these pauses. - +. .TP -\fB--device\fP <device> +\fB\-\-device\fP <device> Make the floppy on a device other than \fI/dev/fd0\fP. The floppy disk will always be made to boot on BIOS device code 0x00 (A: drive), without regard to the drive on which it is created. - +. .TP -.B --fast +.B \-\-fast Use a faster method of creating the boot floppy. -This involves first creating a file of \fB--size\fP 1k blocks (default +This involves first creating a file of \fB\-\-size\fP 1k blocks (default is 1440) mounted using a loopback device, creating the bootable floppy, then copying the entire file to the disk. - +. .TP -\fB--fs\fP [ \fIext2\fP | \fImsdos\fP | \fIminix\fP ] +\fB\-\-fs\fP [ \fIext2\fP | \fImsdos\fP | \fIminix\fP ] Specify the type of filesystem to create on the drive. \fIext2\fP is the default, but \fImsdos\fP and \fIminix\fP allow slightly more disk sectors for really big kernels. - +. .TP -.B --help +.B \-\-help Print a short usage synopsis, including a list of command options. - +. .TP -\fB--image\fP <label> +\fB\-\-image\fP <label> Specifies the label or alias of the particular image from which the append, initial ramdisk, root, keytable, and kernel information is to be taken. - +. .TP -\fB--initrd\fP \fI<filepath>\fP and \fB--kernel\fP \fI<filepath>\fP +\fB\-\-initrd\fP \fI<filepath>\fP and \fB\-\-kernel\fP \fI<filepath>\fP These options, which must be used together, allow specification of an arbitrary kernel file and initial ramdisk file to be used on the created boot floppy. Be sure you know what you are doing before you use these options. If no initial ramdisk is needed with a particular kernel, then you MUST -specify \fB--initrd ""\fP, meaning a null pathname. - +specify \fB\-\-initrd ""\fP, meaning a null pathname. +. .TP -\fB--install\fP [ \fItext\fP | \fImenu\fP ] +\fB\-\-install\fP [ \fItext\fP | \fImenu\fP ] Allows overriding the default human interface used with the rescue -bootloader (configuration file "install=" option). \fItext\fP is the -default on 1.2MB and 1.44MB floppy disks, and \fImenu\fP is the default -on 2.88MB floppies and HD emulation on CD-R media. - +bootloader (configuration file "install=" option). +\fItext\fP is the default on 1.2\ MB and +1.44\ MB floppy disks, +and \fImenu\fP is the default on 2.88\ MB floppies and +HD emulation on CD-R media. +. .TP -.BI --iso +.B \-\-iso Create an ISO-9660 bootable CD image (El Torito Format) suitable for -burning to a CD-R or CD-RW. The \fB--device\fP specification defaults to -the filename \fIrescue.iso\fP, and the \fB--size\fP defaults to 2880. +burning to a CD-R or CD-RW. The \fB\-\-device\fP specification defaults to +the filename \fIrescue.iso\fP, and the \fB\-\-size\fP defaults to 2880. A utility such as "wodim" may be used to burn the ISO file to a recordable CD medium. -With this ISO option, the \fB--size\fP \fIHD\fP option is allowed. - +With this ISO option, the \fB\-\-size\fP \fIHD\fP option is allowed. +. .TP -.BI --nocompact +.B \-\-nocompact For faster kernel loading from a floppy, LILO map compaction is normally enabled. -This option will disable map compaction by omitting the lilo \fB-c\fP +This option will disable map compaction by omitting the lilo \fB\-c\fP switch. - +. .TP -.BI --noformat +.B \-\-noformat Suppresses creation of a new filesystem on the boot floppy. This option may be used ONLY when you know that the floppy you will be writing upon is formatted with the -same filesystem as specified by \fB--fs\fP \fIXXX\fP (default is \fIext2\fP). - +same filesystem as specified by \fB\-\-fs\fP \fIXXX\fP (default is \fIext2\fP). +. .TP -\fB--root\fP \fI<device>\fP +\fB\-\-root\fP \fI<device>\fP Specify the root filesystem for the kernel on the boot floppy. The currently mounted root is taken as the default specification. - +. .TP -\fB--size\fP [ \fI1440\fP | \fI1200\fP | \fI2880\fP | \fIHD\fP ] -The default floppy disk size is \fI1440\fP, meaning a 1.44MB floppy. -When \fB--iso\fP is specified, the default size is \fI2880\fP. +\fB\-\-size\fP [ \fI1440\fP | \fI1200\fP | \fI2880\fP | \fIHD\fP ] +The default floppy disk size is \fI1440\fP, meaning a 1.44\ MB floppy. +When \fB\-\-iso\fP is specified, the default size is \fI2880\fP. Allowed specifications are \fI1200\fP, \fI1440\fP, or \fI2880\fP, meaning -a 1.2MB, 1.44MB or 2.88MB floppy, respectively. +a 1.2\ MB, 1.44\ MB or 2.88\ MB floppy, respectively. No other floppy disk sizes are supported. .sp The \fIHD\fP specification, meaning "hard disk", may only be used with -the \fB--iso\fP option, to indicate a 16MB hard disk is to be generated +the \fB\-\-iso\fP option, to indicate a 16\ MB hard disk is to be generated for emulation. This allows for very large kernel/initial ramdisk combinations on CD-R. The hard disk image is created using loopback devices \fI/dev/loop0\fP and \fI/dev/loop1\fP, which must be free to utilize this size option. - +. .TP -.BI --version +.B \-\-version Print the version number of \fBmkrescue\fP, then terminate. - +. .SH "SEE ALSO" .BR cdrecord (1), .BR dd (1), @@ -151,6 +152,6 @@ Print the version number of \fBmkrescue\ .BR mkinitrd (8), .BR mkisofs (8), .BR mount (8) - +. .\" .SH "AUTHOR" .\" John Coffman <[email protected]> -- System Information: Debian Release: bullseye/sid APT prefers testing APT policy: (500, 'testing'), (500, 'stable') Architecture: amd64 (x86_64) Kernel: Linux 5.4.13-1 (SMP w/2 CPU cores) Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), LANGUAGE=is_IS.iso88591 (charmap=ISO-8859-1) Shell: /bin/sh linked to /bin/dash Init: sysvinit (via /sbin/init) Versions of packages lilo depends on: ii debconf [debconf-2.0] 1.5.73 ii dpkg 1.19.7 ii libc6 2.29-9 ii libdevmapper1.02.1 2:1.02.167-1 ii perl 5.30.0-9 lilo recommends no packages. Versions of packages lilo suggests: ii e2fsprogs 1.45.5-2 -- debconf information excluded -- Bjarni I. Gislason
