Add manual page.

diff --git a/vmdebootstrap b/vmdebootstrap
index be3169b7e9276adfd8ad366c4db3d55d5c6d6edc..84ee0079749ebbd98ba2b1af76ae3a89670db3c5 100755 (executable)
--- a/vmdebootstrap
+++ b/vmdebootstrap
@@ -41,6 +41,7 @@ class VmDebootstrap(cliapp.Application):
         self.settings.add_string_setting(['mirror'],
                                          'use MIRROR as package source '
                                             '(%default)',
+                                         metavar='URL',
                                      default='http://cdn.debian.net/debian/')
         self.settings.add_string_setting(['arch'],
                                          'architecture to use '

diff --git a/vmdebootstrap.8 b/vmdebootstrap.8
new file mode 100644 (file)
index 0000000..ecfb8a2
--- /dev/null
+++ b/vmdebootstrap.8
@@ -0,0 +1,103 @@
+.\" Copyright 2011 Lars Wirzenius <liw@liw.fi>
+.\" 
+.\" This program 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 3 of the License, or
+.\" (at your option) any later version.
+.\" 
+.\" This program is distributed in the hope that it will be useful,
+.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
+.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+.\" GNU General Public License for more details.
+.\" 
+.\" You should have received a copy of the GNU General Public License
+.\" along with this program.  If not, see <http://www.gnu.org/licenses/>.
+.\"
+.TH VMDEBOOTSTRAP 8
+.SH NAME
+vmdebootstrap \- install basic Debian system into virtual disk image
+.SH SYNOPSIS
+.B vmdebootstrap
+.BR \-\-image =\fIFILE
+.RB [ options ]
+.SH DESCRIPTION
+.B vmdebootstrap
+installs a basic Debian system into a virtual disk image,
+for use with virtual machines,
+such as KVM, Qemu, or VirtualBox.
+It is like
+.BR debootstrap (8),
+which does the same thing, but puts the system into a directory,
+for use with
+.BR chroot (8).
+(In fact,
+.B vmdebootstrap
+is a wrapper around
+.BR debootstrap ).
+.PP
+You need to run
+.B vmdebootstrap
+as root.
+.SH OPTIONS
+.TP
+.BR \-\-help
+Show full list of options (this manual page may be incomplete).
+.TP
+.BR \-\-verbose
+Report what is going on.
+.TP
+.BR \-\-log =\fIFILE
+Write log to 
+.IR FILE .
+.TP
+.BR \-\-log\-level =\fILEVEL
+Write log messages of the given
+.I LEVEL
+or higher.
+Level is one of 
+.IR debug ,
+.IR info ,
+.IR warning ,
+.IR error ,
+.IR critical ,
+.IR fatal ,
+and defaults to
+.IR info .
+.TP
+.BR \-\-image =\fIFILE
+Put created disk image in
+.IR FILE .
+.TP
+.BR \-\-size =\fISIZE
+Create a disk image of the given
+.IR SIZE ,
+which can be given in bytes,
+kilobytes,
+gigabytes,
+etc,
+using the appropriate suffix.
+.TP
+.BR \-\-mirror =\fIURL
+Use the Debian mirror at
+.IR URL .
+You probably want to specify a local mirror, if you have one.
+Defaults to
+.IR http://cdn.debian.net/debian/ ,
+which should work fairly well for most people without a local mirror.
+.TP
+.BR \-\-arch =\fIARCH
+Use a given architecture.
+This only works if the host system can run binaries for the architecture,
+e.g., you can build an i386 image on amd64, but not arm.
+.TP
+.BR \-\-distribution =\fINAME
+Use a given release of Debian.
+.SH EXAMPLE
+To create an image for the stable release of Debian:
+.nf
+.IP
+sudo ./vmdebootstrap --image test.img --size 1g \\
+    --log test.log --log-level debug --verbose \\
+    --mirror http://mirror.lan/debian/
+.SH "SEE ALSO"
+.BR debootstrap (8).