From: Joachim Wiedorn Date: Fri, 11 Mar 2011 19:37:20 +0000 (+0100) Subject: Fix: reformatting mkrescue manpage X-Git-Tag: debian/23.1-2~19 X-Git-Url: https://git.rrq.au/?a=commitdiff_plain;h=fab87308e2f50e1bea709d9f3876856965439e32;p=rrq%2Fmaintain_lilo.git Fix: reformatting mkrescue manpage --- diff --git a/debian/changelog b/debian/changelog index 5338b11..ac57a9d 100644 --- a/debian/changelog +++ b/debian/changelog @@ -4,6 +4,8 @@ lilo (1:23.1-2) unstable; urgency=low - Remove dependency to lilo in package lilo-doc. (Closes: #613753) * Fix: save errno for second command (device.c). * Fix: save file permissions for converted lilo.conf. (Closes: #615103) + * Reformatting of mkrescue manpage (thanks to M.E. Schauer). + (Closes: #617282) * debconf scripts: - Fix typos in some debconf translation files. (Closes: #504733) - Use better style in debconf translations. (Closes: #312451, #504733) diff --git a/debian/patches/13_reformatted-mkrescue-manpage.patch b/debian/patches/13_reformatted-mkrescue-manpage.patch new file mode 100644 index 0000000..359dae8 --- /dev/null +++ b/debian/patches/13_reformatted-mkrescue-manpage.patch @@ -0,0 +1,268 @@ +Package: lilo +Subject: reformatted mkrescue manpage +Author: Martin Eberhard Schauer +Forwarded: yes +Last-Update: 2011-03-07 + +The formatting did not obey the recommendations of man (7) and +man-pages (7). +--- + +diff -urN s12/man/mkrescue.8 s13/man/mkrescue.8 +--- s12/man/mkrescue.8 2010-11-01 17:13:41.000000000 +0100 ++++ s13/man/mkrescue.8 2011-03-07 21:25:53.000000000 +0100 +@@ -2,130 +2,155 @@ + .\" @(#)mkrescue.8 1.0 20011031 jrc + .\" This page is part of the LILO package, which is released by + .\" the author(s) under a BSD license. See the file COPYING +-.\" in the LILO source directory for the License and Disclaimer. ++.\" in the LILO source directory for the license and disclaimer. + .\" + .\" Original version, John Coffman 2001-10-31 + .\" Updated to version 2.0 & lilo 22.5.4, John Coffman 2003-05-24 +-.\" + .\" Updated to version 3.0 & lilo 22.6.1, John Coffman 2004-11-16 +-.\" +-.TH MKRESCUE 8 "16 Nov 2004" ++.\" Reformatted to better match Linux man-pages conventions ++.\" Martin Eberhard Schauer 2011-03-06 ++ ++.TH MKRESCUE 8 "6 Mar 2011" ++ + .SH NAME +-mkrescue \- make rescue floppy ++mkrescue \- make rescue floppy or CD ++ + .SH SYNOPSIS +-.LP +-.B "/usr/sbin/mkrescue" +-\- make a bootable rescue floppy or CD using the default kernel specified +-in \fIlilo.conf\fP. ++.B /sbin/mkrescue ++makes a bootable rescue floppy or CD using the default kernel specified in ++.IR lilo.conf . ++ + .SH DESCRIPTION +-.LP +-.B mkrescue +-takes its specification for the kernel from the default image specified in +-\fB/etc/lilo.conf\fP. If the actual default is an \fIother=\fP specification, +-then use the first \fIimage=\fP specification. +-Any associated initial ramdisk (initrd=), and \fIappend=\fP +-options will also be used. The root directory will be taken to be the +-\fIcurrent\fP root. A bootable floppy or CD-image will be created using LILO version ++\fBmkrescue\fP takes its specifation 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. ++Any associated initial ramdisk (\fIinitrd=\fP), and \fIappend=\fP options ++will also be used. ++The root directory will be taken to be the \fIcurrent\fP root. ++A bootable floppy or CD-image will be created using LILO version + 22.5.5 or later. +-.B mkrescue +-normally requires no options, unless a CD-image is desired (\fI--iso\fP). ++\fBmkrescue\fP normally requires no options, unless a CD-image is desired ++(\fB--iso\fP). ++ + .SH OPTIONS +-.LP ++ + .TP +-.BI "--append " +-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 with: \fB--append ""\fP, the null string. +-.TP +-.BI "--debug" +-Provide verbose output of the operation of "mkrescue", pausing to allow +-the setting of internal operating parameters to be viewed. "" must +-be hit to proceed from these pauses. +-.TP +-.BI "--device " +-Make the floppy on a device other than /dev/fd0. 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 +-.BI "--fast" +-Use a faster method of creating the boot floppy. This involves first +-creating a file of "\-\-size" 1k blocks (default is 1440) +-mounted using a loopback device, creating the bootable floppy, ++\fB--append\fP ++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). ++ ++.TP ++.B --debug ++Provide verbose output of the operation of ++.BR mkrescue , ++pausing to allow the setting of internal operating parameters to be viewed. ++ must be hit to proceed from these pauses. ++ ++.TP ++\fB--device\fP ++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 ++Use a faster method of creating the boot floppy. ++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 +-.BI "--fs [ ext2 | msdos | minix ]" ++\fB--fs\fP [ \fIext2\fP | \fImsdos\fP | \fIminix\fP ] + Specify the type of filesystem to create on the drive. +-.B ext2 +-is the default, but "msdos" and "minix" allow slightly more disk sectors +-for really big kernels. ++\fIext2\fP is the default, but \fImsdos\fP and \fIminix\fP allow ++slightly more disk sectors for really big kernels. ++ + .TP +-.BI "--help" ++.B --help + Print a short usage synopsis, including a list of command options. ++ + .TP +-.BI "--image