From 7a39b9a572926961d3c4203e8c889815a5d5609a Mon Sep 17 00:00:00 2001 From: Joachim Wiedorn Date: Sun, 20 Mar 2011 15:41:37 +0100 Subject: [PATCH] Add new manpage for new liloconfig --- debian/changelog | 3 +- debian/manpages/lilo-uuid-diskid.8 | 10 +- debian/manpages/lilo-uuid-diskid.pod | 10 +- debian/manpages/liloconfig.8 | 155 +++++++++++++++++++++++++++ debian/manpages/liloconfig.pod | 109 +++++++++++++++++++ debian/manpages/update-lilo.8 | 25 ++--- debian/manpages/update-lilo.pod | 8 +- 7 files changed, 288 insertions(+), 32 deletions(-) create mode 100644 debian/manpages/liloconfig.pod diff --git a/debian/changelog b/debian/changelog index b2b2654..cc2a6d5 100644 --- a/debian/changelog +++ b/debian/changelog @@ -28,8 +28,9 @@ lilo (1:23.1-2) unstable; urgency=low - Update of Swedish translation (sv.po). (Closes: #618620) * Add new script liloconfig, using template with comments, works with UUID, LABEL and disk-id for root and boot options. + * Add new manpage for liloconfig, update of other manpages. - -- Joachim Wiedorn Sat, 19 Mar 2011 23:50:00 +0100 + -- Joachim Wiedorn Sun, 20 Mar 2011 00:15:54 +0100 lilo (1:23.1-1) unstable; urgency=low diff --git a/debian/manpages/lilo-uuid-diskid.8 b/debian/manpages/lilo-uuid-diskid.8 index d601435..2329820 100644 --- a/debian/manpages/lilo-uuid-diskid.8 +++ b/debian/manpages/lilo-uuid-diskid.8 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pod::Man 2.1801 (Pod::Simple 3.07) +.\" Automatically generated by Pod::Man 2.22 (Pod::Simple 3.07) .\" .\" Standard preamble: .\" ======================================================================== @@ -62,7 +62,7 @@ .\" ======================================================================== .\" .IX Title "LILO-UUID-DISKID 8" -.TH LILO-UUID-DISKID 8 "2010-07-24" "23.0" "lilo documentation" +.TH LILO-UUID-DISKID 8 "2011-03-20" "23.1" "lilo documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -71,7 +71,7 @@ lilo\-uuid\-diskid \- convert boot / root options to diskid and uuid in lilo.conf. .SH "SYNOPSIS" .IX Header "SYNOPSIS" -lilo-uuid-diskid [\-h] [\-v] [lilo.conf] +\&\fBlilo-uuid-diskid\fR [\fB\-h\fR] [\fB\-v\fR] [\fBlilo.conf\fR] .SH "DESCRIPTION" .IX Header "DESCRIPTION" This script looks for the boot block device or boot partition and create the @@ -102,7 +102,7 @@ Lines in the configuration file /etc/lilo.conf: .Ve .SH "COPYRIGHT and LICENSE" .IX Header "COPYRIGHT and LICENSE" -Copyright (C) 2010 Joachim Wiedorn +Copyright (C) 2010\-2011 Joachim Wiedorn .PP This script is free software; you can redistribute it and/or modify it under the terms of the \s-1GNU\s0 General Public License as published by @@ -119,4 +119,4 @@ This manual page was written by Joachim Wiedorn for the Debian project (and may be used by others). .SH "SEE ALSO" .IX Header "SEE ALSO" -\&\fBlilo\fR(8), \fBupdate-lilo\fR(8) +\&\fBlilo\fR(8), \fBupdate-lilo\fR(8), \fBliloconfig\fR(8) diff --git a/debian/manpages/lilo-uuid-diskid.pod b/debian/manpages/lilo-uuid-diskid.pod index a741bfe..64ce587 100644 --- a/debian/manpages/lilo-uuid-diskid.pod +++ b/debian/manpages/lilo-uuid-diskid.pod @@ -2,8 +2,8 @@ manpage: LILO-UUID-DISKID section: 8 title: lilo documentation -version: 23.0 -datum: 2010-07-24 +version: 23.1 +datum: 2011-03-20 =encoding utf8 @@ -13,7 +13,7 @@ lilo-uuid-diskid - convert boot / root options to diskid and uuid in lilo.conf. =head1 SYNOPSIS -lilo-uuid-diskid [-h] [-v] [lilo.conf] +B [B<-h>] [B<-v>] [B] =head1 DESCRIPTION @@ -51,7 +51,7 @@ Lines in the configuration file /etc/lilo.conf: =head1 COPYRIGHT and LICENSE -Copyright (C) 2010 Joachim Wiedorn +Copyright (C) 2010-2011 Joachim Wiedorn This script is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by @@ -70,6 +70,6 @@ for the Debian project (and may be used by others). =head1 SEE ALSO -B(8), B(8) +B(8), B(8), B(8) =cut diff --git a/debian/manpages/liloconfig.8 b/debian/manpages/liloconfig.8 index e69de29..5ccceb7 100644 --- a/debian/manpages/liloconfig.8 +++ b/debian/manpages/liloconfig.8 @@ -0,0 +1,155 @@ +.\" Automatically generated by Pod::Man 2.22 (Pod::Simple 3.07) +.\" +.\" Standard preamble: +.\" ======================================================================== +.de Sp \" Vertical space (when we can't use .PP) +.if t .sp .5v +.if n .sp +.. +.de Vb \" Begin verbatim text +.ft CW +.nf +.ne \\$1 +.. +.de Ve \" End verbatim text +.ft R +.fi +.. +.\" Set up some character translations and predefined strings. \*(-- will +.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left +.\" double quote, and \*(R" will give a right double quote. \*(C+ will +.\" give a nicer C++. Capital omega is used to do unbreakable dashes and +.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, +.\" nothing in troff, for use with C<>. +.tr \(*W- +.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' +.ie n \{\ +. ds -- \(*W- +. ds PI pi +. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch +. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch +. ds L" "" +. ds R" "" +. ds C` "" +. ds C' "" +'br\} +.el\{\ +. ds -- \|\(em\| +. ds PI \(*p +. ds L" `` +. ds R" '' +'br\} +.\" +.\" Escape single quotes in literal strings from groff's Unicode transform. +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" +.\" If the F register is turned on, we'll generate index entries on stderr for +.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index +.\" entries marked with X<> in POD. Of course, you'll have to process the +.\" output yourself in some meaningful fashion. +.ie \nF \{\ +. de IX +. tm Index:\\$1\t\\n%\t"\\$2" +.. +. nr % 0 +. rr F +.\} +.el \{\ +. de IX +.. +.\} +.\" ======================================================================== +.\" +.IX Title "LILOCONFIG 8" +.TH LILOCONFIG 8 "2011-03-20" "23.1" "liloconfig documentation" +.\" For nroff, turn off justification. Always turn off hyphenation; it makes +.\" way too many mistakes in technical documents. +.if n .ad l +.nh +.SH "NAME" +liloconfig \- create new lilo.conf file (with diskid and uuid) +.SH "SYNOPSIS" +.IX Header "SYNOPSIS" +\&\fBliloconfig\fR [\fB\-h\fR] [\fB\-v\fR] [\fB\-f\fR] [\fBlilo.conf\fR] +.SH "DESCRIPTION" +.IX Header "DESCRIPTION" +liloconfig is an simple program for creating a new lilo.conf file. +After creating the new configuration file you must execute '/sbin/lilo'. +.PP +liloconfig use the lilo.example.conf file as template. In the final +lilo.conf file you find many useful comments for custom changes. +.SH "OPTIONS" +.IX Header "OPTIONS" +.IP "\fB\-h\fR" 4 +.IX Item "-h" +Print a brief help. +.IP "\fB\-v\fR" 4 +.IX Item "-v" +Print verbose messages. +.IP "\fB\-f\fR" 4 +.IX Item "-f" +Force overriding existing lilo.conf. +.SH "EXAMPLES" +.IX Header "EXAMPLES" +Lines in the configuration file /etc/lilo.conf: +.PP +.Vb 1 +\& ### LILO global section ### +\& +\& #large\-memory +\& lba32 +\& boot = /dev/sda +\& map = /boot/map +\& install = menu +\& menu\-scheme = Wb:Yr:Wb:Wb +\& prompt +\& timeout = 100 +\& vga = normal +\& #default = Linux +\& +\& ### LILO per\-image section ### +\& +\& #boot = /dev/sda +\& boot = /dev/disk/by\-id/ata\-SAMSUNG_SV1604N_S01FJ10X999999 +\& +\& image = /boot/vmlinuz\-2.6.32\-5book\-686 +\& label = "Linux" +\& #root = /dev/sda1 +\& root = "UUID=18843936\-00f9\-4df0\-a373\-000d05a5dd44" +\& read\-only +\& # restricted +\& # alias = 1 +\& # optional +\& initrd = /boot/initrd.img\-2.6.32\-5book\-686 +\& +\& image = /boot/vmlinuz\-2.6.32\-5\-686 +\& label = "Linux Old" +\& #root = /dev/sda1 +\& root = "UUID=18843936\-00f9\-4df0\-a373\-000d05a5dd44" +\& read\-only +\& # restricted +\& # alias = 2 +\& # optional +\& initrd = /boot/initrd.img\-2.6.32\-5\-686 +.Ve +.SH "COPYRIGHT and LICENSE" +.IX Header "COPYRIGHT and LICENSE" +Copyright (C) 2011 Joachim Wiedorn +.PP +This script is free software; you can redistribute it and/or modify +it under the terms of the \s-1GNU\s0 General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. +.PP +On Debian systems, the complete text of the \s-1GNU\s0 General Public +License version 2 can be found in `/usr/share/common\-licenses/GPL\-2'. +.SH "AUTHOR" +.IX Header "AUTHOR" +\&\fBlilconfig\fR was written by Joachim Wiedorn. +.PP +This manual page was written by Joachim Wiedorn +for the Debian project (and may be used by others). +.SH "SEE ALSO" +.IX Header "SEE ALSO" +\&\fBlilo\fR(8), \fBupdate-lilo\fR(8), \fBlilo-uuid-diskid\fR(8) diff --git a/debian/manpages/liloconfig.pod b/debian/manpages/liloconfig.pod new file mode 100644 index 0000000..0c3c9d8 --- /dev/null +++ b/debian/manpages/liloconfig.pod @@ -0,0 +1,109 @@ +=for header +manpage: LILOCONFIG +section: 8 +title: liloconfig documentation +version: 23.1 +datum: 2011-03-20 + +=encoding utf8 + +=head1 NAME + +liloconfig - create new lilo.conf file (with diskid and uuid) + +=head1 SYNOPSIS + +B [B<-h>] [B<-v>] [B<-f>] [B] + +=head1 DESCRIPTION + +liloconfig is an simple program for creating a new lilo.conf file. +After creating the new configuration file you must execute '/sbin/lilo'. + +liloconfig use the lilo.example.conf file as template. In the final +lilo.conf file you find many useful comments for custom changes. + +=head1 OPTIONS + +=over 4 + +=item B<-h> + +Print a brief help. + +=item B<-v> + +Print verbose messages. + +=item B<-f> + +Force overriding existing lilo.conf. + +=back + +=head1 EXAMPLES + +Lines in the configuration file /etc/lilo.conf: + + ### LILO global section ### + + #large-memory + lba32 + boot = /dev/sda + map = /boot/map + install = menu + menu-scheme = Wb:Yr:Wb:Wb + prompt + timeout = 100 + vga = normal + #default = Linux + + ### LILO per-image section ### + + #boot = /dev/sda + boot = /dev/disk/by-id/ata-SAMSUNG_SV1604N_S01FJ10X999999 + + image = /boot/vmlinuz-2.6.32-5book-686 + label = "Linux" + #root = /dev/sda1 + root = "UUID=18843936-00f9-4df0-a373-000d05a5dd44" + read-only + # restricted + # alias = 1 + # optional + initrd = /boot/initrd.img-2.6.32-5book-686 + + image = /boot/vmlinuz-2.6.32-5-686 + label = "Linux Old" + #root = /dev/sda1 + root = "UUID=18843936-00f9-4df0-a373-000d05a5dd44" + read-only + # restricted + # alias = 2 + # optional + initrd = /boot/initrd.img-2.6.32-5-686 + +=head1 COPYRIGHT and LICENSE + +Copyright (C) 2011 Joachim Wiedorn + +This script is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +On Debian systems, the complete text of the GNU General Public +License version 2 can be found in `/usr/share/common-licenses/GPL-2'. + +=head1 AUTHOR + +B was written by Joachim Wiedorn. + +This manual page was written by Joachim Wiedorn +for the Debian project (and may be used by others). + +=head1 SEE ALSO + +B(8), B(8), B(8) + +=cut diff --git a/debian/manpages/update-lilo.8 b/debian/manpages/update-lilo.8 index f608786..6346cfc 100644 --- a/debian/manpages/update-lilo.8 +++ b/debian/manpages/update-lilo.8 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pod::Man 2.1801 (Pod::Simple 3.07) +.\" Automatically generated by Pod::Man 2.22 (Pod::Simple 3.07) .\" .\" Standard preamble: .\" ======================================================================== @@ -62,31 +62,22 @@ .\" ======================================================================== .\" .IX Title "UPDATE-LILO 8" -.TH UPDATE-LILO 8 "2010-07-24" "23.0" "lilo documentation" +.TH UPDATE-LILO 8 "2011-03-20" "23.1" "lilo documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" -update\-lilo \- short description +update\-lilo \- execute lilo in special debconf mode .SH "SYNOPSIS" .IX Header "SYNOPSIS" -means a example usage (with all options) +\&\fBupdate-lilo\fR .SH "DESCRIPTION" .IX Header "DESCRIPTION" -contains a long description of what the program does and lists functions -.SH "OPTIONS" -.IX Header "OPTIONS" -show each option and deklare there sense -.SH "DIAGNOSTICS" -.IX Header "DIAGNOSTICS" -show some ways of diagnostics -.SH "EXAMPLES" -.IX Header "EXAMPLES" -show some examples for using +This special script only execute lilo with sending all output to >$2 .SH "COPYRIGHT and LICENSE" .IX Header "COPYRIGHT and LICENSE" -Copyright (C) 2010 Joachim Wiedorn +Copyright (C) 2010\-2011 Joachim Wiedorn .PP This script is free software; you can redistribute it and/or modify it under the terms of the \s-1GNU\s0 General Public License as published by @@ -97,10 +88,10 @@ On Debian systems, the complete text of the \s-1GNU\s0 General Public License version 2 can be found in `/usr/share/common\-licenses/GPL\-2'. .SH "AUTHOR" .IX Header "AUTHOR" -\&\fBlilo-uuid-diskid\fR was written by Joachim Wiedorn. +\&\fBupdate-lilo\fR was written by Joachim Wiedorn. .PP This manual page was written by Joachim Wiedorn for the Debian project (and may be used by others). .SH "SEE ALSO" .IX Header "SEE ALSO" -\&\fBlilo\fR(8), \fBlilo-uuid-diskid\fR(1). +\&\fBlilo\fR(8), \fBlilo-uuid-diskid\fR(1), \fBliloconfig\fR(8) diff --git a/debian/manpages/update-lilo.pod b/debian/manpages/update-lilo.pod index 3e6856e..f37a68c 100644 --- a/debian/manpages/update-lilo.pod +++ b/debian/manpages/update-lilo.pod @@ -2,8 +2,8 @@ manpage: UPDATE-LILO section: 8 title: lilo documentation -version: 23.0 -datum: 2010-07-24 +version: 23.1 +datum: 2011-03-20 =encoding utf8 @@ -21,7 +21,7 @@ This special script only execute lilo with sending all output to >$2 =head1 COPYRIGHT and LICENSE -Copyright (C) 2010 Joachim Wiedorn +Copyright (C) 2010-2011 Joachim Wiedorn This script is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by @@ -40,6 +40,6 @@ for the Debian project (and may be used by others). =head1 SEE ALSO -B(8), B(1). +B(8), B(1), B(8) =cut -- 2.39.2