Applied patch from Michael Prokop <mika@grml.org> to migrate live-snapshot.en.1 and...
authorDaniel Baumann <daniel@debian.org>
Sun, 23 Sep 2007 13:11:37 +0000 (15:11 +0200)
committerDaniel Baumann <daniel@debian.org>
Wed, 9 Mar 2011 16:31:05 +0000 (17:31 +0100)
manpages/Makefile
manpages/live-snapshot.en.1 [deleted file]
manpages/live-snapshot.en.1.txt [new file with mode: 0644]
manpages/live-snapshot.it.1 [deleted file]
manpages/live-snapshot.it.1.txt [new file with mode: 0644]

index 5d29263..c2ddc94 100644 (file)
@@ -4,18 +4,25 @@ doc: doc_man doc_html
 
 doc_html: html-stamp
 
-html-stamp: live-initramfs.en.7.txt
-       asciidoc -b xhtml11 -a icons live-initramfs.en.7.txt
+html-stamp: live-initramfs.en.7.txt live-snapshot.en.1.txt
+       asciidoc -b xhtml11 live-initramfs.en.7.txt
+       asciidoc -b xhtml11 live-snapshot.en.1.txt
        touch html-stamp
 
 doc_man: man-stamp
 
-man-stamp: live-initramfs.en.7.txt
-
+man-stamp: live-initramfs.en.7.txt live-snapshot.en.1.txt
+       # live-initramfs:
        asciidoc -d manpage -b docbook live-initramfs.en.7.txt
        xsltproc /usr/share/xml/docbook/stylesheet/nwalsh/manpages/docbook.xsl live-initramfs.en.7.xml
        mv live-initramfs.7 live-initramfs.en.7
+       # live-snapshot:
+       asciidoc -d manpage -b docbook live-snapshot.en.1.txt
+       xsltproc /usr/share/xml/docbook/stylesheet/nwalsh/manpages/docbook.xsl live-snapshot.en.1.xml
+       mv live-snapshot.1 live-snapshot.en.1
        touch man-stamp
 
 clean:
-       rm -f live-initramfs.en.7.html live-initramfs.en.7.xml live-initramfs.en.7 html-stamp man-stamp
+       rm -f live-initramfs.en.7.html live-initramfs.en.7.xml live-initramfs.en.7
+       rm -f live-snapshot.en.1.html live-snapshot.en.1.xml live-snapshot.en.1
+       rm -f html-stamp man-stamp
diff --git a/manpages/live-snapshot.en.1 b/manpages/live-snapshot.en.1
deleted file mode 100644 (file)
index 93ab3c1..0000000
+++ /dev/null
@@ -1,71 +0,0 @@
-.TH LIVE\-SNAPSHOT 1 "2007\-09\-17" "1.99.3" "live\-initramfs"
-
-.SH NAME
-live\-snapshot \- a simple script to ease persistence usage
-
-.SH SYNOPSIS
-.B live\-snapshot
-.RB [\| \-c \||\| \-\-cow
-.IR DIRECTORY ]
-.RB [\| \-d \||\| \-\-device
-.IR DEVICE \|]
-.RB [\| \-e \||\| \-\-exclude\-list
-.IR FILE \|]
-.RB [\| \-o \||\| \-\-output
-.IR FILE \|]
-.RB [\| \-t \||\| \-\-type
-.IR TYPE \|]
-.PP
-.B live\-snapshot
-.RB [\| \-r \||\| \-\-resync\-string
-.IR STRING \|]
-.PP
-.B live\-snapshot
-.RB [\| \-h \||\| \-\-help \|]
-.br
-.B live\-snapshot
-.RB [\| \-u \||\| \-\-usage \|]
-.br
-.B live-snapshot
-.RB [\| \-v \||\| \-\-version \|]
-
-.SH DESCRIPTION
-live\-snapshot is a script which can be used to build the right types of persistent image files supported by \fIlive\-initramfs\fR(7). It is also used on exit by the live\-initramfs init script to resync the boot-found snapshots devices.
-
-.SH OPTIONS
-.IP "\fB\-c, \-\-cow\fR \fIDIRECTORY\fR" 4
-specifies the input directory to be cloned in the image file.
-Its default value "/live/cow" should be right for most uses. However it could be handy to specify "/home" and type ext2 for the type to prepare an image file suited to be directly mounted by live-initramfs as home.
-.IP "\fB\-d, \-\-device\fR \fIDEVICE\fR" 4
-sets the device where the media which the snapshot/persistence file/partition will be put. If it is not specified, a tmpfs will be used and linked to the user's desktop to move it where it is needed. If the device has no filesystem, an ext2 fs will be automatically created and labelled according to the values specified after the "--output" value or with a sane default.
-.IP "\fB\-e, \-\-exclude\-list\fR \fIFILE\fR" 4
-a file containing a list of filenames/paths that should not be saved. This exclude list will be remebered on the target snapshot media for reuse.
-.IP "\fB\-o, \-\-output\fR \fIFILE\fR" 4
-the filename/label used for the output file/partition. If left blank, live-snapshot will search for a proper file on the device or use the whole partition.
-.IP "\fB\-r, \-\-resync\-string\fR \fISTRING\fR" 4
-internally used on resyncs.
-.IP "\fB\-t, \-\-type\fR \fITYPE\fR" 4
-Type could be one of "cpio", "squashfs" or "ext2".
-.PP
-.IP "\fB\-h, \-\-help\fR" 4
-display help and exit
-.IP "\fB\-u, \-\-usage\fR" 4
-show usage and exit
-.IP "\fB\-v, \-\-version\fR" 4
-output version information and exit
-
-.SH SEE ALSO
-\fIlive\-initramfs\fR(8)
-.PP
-This program is a part of live\-initramfs.
-
-.SH BUGS
-Report bugs against live\-initramfs <\fIhttp://packages.qa.debian.org/live\-initramfs\fR>.
-
-.SH HOMEPAGE
-More information about the Debian Live project can be found at <\fIhttp://debian\-live.alioth.debian.org/\fR> and <\fIhttp://wiki.debian.org/DebianLive/\fR>.
-
-.SH AUTHORS
-live\-initramfs is maintained by Daniel Baumann <\fIdaniel@debian.org\fR> for the Debian project.
-.PP
-live\-initramfs is a fork of casper <\fIhttp://packages.ubuntu.com/casper/\fR>. casper was originally written by Tollef Fog Heen <\fItfheen@canonical.com\fR> and Matt Zimmerman <\fImdz@canonical.com\fR>.
diff --git a/manpages/live-snapshot.en.1.txt b/manpages/live-snapshot.en.1.txt
new file mode 100644 (file)
index 0000000..7cebed5
--- /dev/null
@@ -0,0 +1,100 @@
+live-snapshot(1)
+================
+
+Name
+----
+live-snapshot - a simple script to ease persistence usage
+
+Synopsis
+--------
+live-snapshot [-c|--cow **DIRECTORY**s] [-d|--device **DEVICE**] [-e|--exclude-list **FILE**] [-o|--output **FILE**] [-t|--type **TYPE**]
+
+live-snapshot [-r|--resync-string **STRING**]
+
+live-snapshot [-h|--help]
+
+live-snapshot [-u|--usage]
+
+live-snapshot [-v|--version]
+
+Description
+-----------
+
+live-snapshot is a script which can be used to build the right types of
+persistent image files supported by live-initramfs(7). It is also used on
+exit by the live-initramfs init script to resync the boot-found snapshots
+devices.
+
+Options
+-------
+
+  -c, --cow **DIRECTORY**::
+
+specifies the input directory to be cloned in the image file. Its default value
+"/live/cow" should be right for most uses. However it could be handy to specify
+"/home" and type ext2 for the type to prepare an image file suited to be
+directly mounted by live-initramfs as home.
+
+  -d, --device **DEVICE**::
+
+sets the device where the media which the snapshot/persistence file/partition
+will be put. If it is not specified, a tmpfs will be used and linked to the
+user's desktop to move it where it is needed. If the device has no filesystem,
+an ext2 fs will be automatically created and labelled according to the values
+specified after the "--output" value or with a sane default.
+
+  -e, --exclude-list **FILE**::
+
+a file containing a list of filenames/paths that should not be saved. This exclude list will be remebered on the target snapshot media for reuse.
+
+  -o, --output **FILE**::
+
+the filename/label used for the output file/partition. If left blank, live-snapshot will search for a proper file on the device or use the whole partition.
+
+  -r, --resync-string **STRING**::
+
+internally used on resyncs.
+
+  -t, --type **TYPE**::
+
+Type could be one of "cpio", "squashfs" or "ext2".
+
+  -h, --help::
+
+display help and exit
+
+  -u, --usage::
+
+show usage and exit
+
+  -v, --version::
+
+output version information and exit
+
+See also
+--------
+
+live-initramfs(8)
+
+This program is a part of live-initramfs.
+
+Bugs
+----
+
+Report bugs against live-initramfs
+link:http://packages.qa.debian.org/live-initramfs[http://packages.qa.debian.org/live-initramfs].
+
+Homepage
+--------
+
+More information about the Debian Live project can be found at
+link:http://debian-live.alioth.debian.org/[http://debian-live.alioth.debian.org/] and
+link:http://wiki.debian.org/DebianLive/[http://wiki.debian.org/DebianLive/].
+
+Authors
+-------
+
+live-initramfs is maintained by Daniel Baumann <daniel@debian.org> for the
+Debian project. live-initramfs is a fork of
+link:http://packages.ubuntu.com/casper/[casper]. casper was originally written
+by Tollef Fog Heen <tfheen@canonical.com> and Matt Zimmerman <mdz@canonical.com>.
diff --git a/manpages/live-snapshot.it.1 b/manpages/live-snapshot.it.1
deleted file mode 100644 (file)
index d5a7163..0000000
+++ /dev/null
@@ -1,70 +0,0 @@
-.TH LIVE\-SNAPSHOT 1 "02.07.2007" "1.91.3" "live\-initramfs"
-
-.SH NAME
-live\-snapshot \- uno script per facilitare l'uso della persistenza sui sistemi live
-
-.SH SYNOPSIS
-.B live\-snapshot
-.RB [\| \-c \||\| \-\-cow
-.IR DIRECTORY ]
-.RB [\| \-d \||\| \-\-device
-.IR DEVICE \|]
-.RB [\| \-e \||\| \-\-exclude\-list
-.IR FILE \|]
-.RB [\| \-o \||\| \-\-output
-.IR FILE \|]
-.RB [\| \-t \||\| \-\-type
-.IR TYPE \|]
-.PP
-.B live\-snapshot
-.RB [\| \-r \||\| \-\-resync\-string
-.IR STRING \|]
-.PP
-.B live\-snapshot
-.RB [\| \-h \||\| \-\-help \|]
-.br
-.B live\-snapshot
-.RB [\| \-u \||\| \-\-usage \|]
-.br
-.B live-snapshot
-.RB [\| \-v \||\| \-\-version \|]
-
-.SH DESCRIPTION
-live\-snapshot \[`e] uno script che pu\[`o] essere usato per costruire un file immagine formattato correttamente per essere usato da \fIlive\-initramfs\fR(7); viene inoltre usato dallo script di init di live\-initramfs in uscita per sincronizzare i device di snapshot riconosciuti al boot.
-
-.SH OPTIONS
-.IP "\fB\-c, \-\-cow\fR \fIDIRECTORY\fR" 4
-specifica la directory da clonare nel file immagine. Il valore di default \[`e] lo stesso default usato da live\-initramfs per la sua directory COW (copy on write, un tempo situata in "/live/cow") ed \[`e] sufficiente per gli usi comuni. Pu\[`o] essere utile tuttavia specificare "/home" e come tipo "ext2" per preparare un file immagine adatto per essere montato da live\-initramfs come "/home" al boot.
-.IP "\fB\-d, \-\-device\fR \fIDEVICE\fR" 4
-seleziona il device dove il file/partizione di snapshot o persistenza dovr\[`a] essere sistemato. Se il device non ha un filesystem, ne verr\[`a] creato uno automaticamente, di tipo ext2 ed etichettato (label) in base al valore specificato nell'opzione "--output" o con un default. Se non viene specificato nessun device, verr\[`a] usato un "tmpfs" linkato sul desktop dell'utente, in modo che port\[`a] essere mosso dove si vuole.
-.IP "\fB\-e, \-\-exclude\-list\fR \fIFILE\fR" 4
-un file contenente una lista di file e percorsi che NON devono essere salvati. Questa lista verr\[`a] inclusa nello snapshot per essere riutilizzata.
-.IP "\fB\-o, \-\-output\fR \fIFILE\fR" 4
-il nome del file o l'etichetta (label) da usare per il file o la partizione di snapshot. Se non specificata, live\-snapshot cercher\[`a] un file all'interno del device oppure user\[`a] l'intera partizione.
-.IP "\fB\-r, \-\-resync\-string\fR \fISTRING\fR" 4
-usato internamente nelle sincronizzazioni dallo script di init di live\-initramfs. Il formato pu\[`o] cambiare, usatelo a vostro rischio.
-.IP "\fB\-t, \-\-type\fR \fITYPE\fR" 4
-il tipo pu\[`o] essere "cpio", "squashfs" o "ext2".
-.PP
-.IP "\fB\-h, \-\-help\fR" 4
-mostra l'aiuto ed esce
-.IP "\fB\-u, \-\-usage\fR" 4
-mostra l'utilizzo ed esce
-.IP "\fB\-v, \-\-version\fR" 4
-da informazioni sulla versione ed esce
-
-.SH SEE ALSO
-\fIlive\-initramfs\fR(8)
-.PP
-Questo programma fa parte di live\-initramfs.
-
-.SH BUGS
-Riportate i bug sul pacchetto live\-initramfs <\fIhttp://packages.qa.debian.org/live\-initramfs\fR>.
-
-.SH HOMEPAGE
-Ulteriori informazioni su progetto Debian Live possono essere trovate su <\fIhttp://debian\-live.alioth.debian.org/\fR> e <\fIhttp://wiki.debian.org/DebianLive/\fR>.
-
-.SH AUTHORS
-live\-initramfs \[`e] mantenuto da Daniel Baumann <\fIdaniel@debian.org\fR> per il progetto Debian.
-.PP
-live\-initramfs \[`e] un fork di casper <\fIhttp://packages.ubuntu.com/casper\fR>. casper \[`e] stato scritto originariamente da Tollef Fog Heen <\fItfheen@canonical.com\fR> e Matt Zimmerman <\fImdz@canonical.com\fR>.
diff --git a/manpages/live-snapshot.it.1.txt b/manpages/live-snapshot.it.1.txt
new file mode 100644 (file)
index 0000000..e396efe
--- /dev/null
@@ -0,0 +1,107 @@
+live-snapshot(1)
+================
+
+Name
+----
+live-snapshot - uno script per facilitare l'uso della persistenza sui sistemi live
+
+Synopsis
+--------
+live-snapshot [-c|--cow **DIRECTORY**s] [-d|--device **DEVICE**] [-e|--exclude-list **FILE**] [-o|--output **FILE**] [-t|--type **TYPE**]
+
+live-snapshot [-r|--resync-string **STRING**]
+
+live-snapshot [-h|--help]
+
+live-snapshot [-u|--usage]
+
+live-snapshot [-v|--version]
+
+Description
+-----------
+
+live-snapshot `e uno script che pu`o essere usato per costruire un file immagine formattato
+correttamente per essere usato da live-initramfs(7); viene inoltre usato dallo script di
+init di live-initramfs in uscita per sincronizzare i device di snapshot riconosciuti al boot.
+
+Options
+-------
+
+  -c, --cow **DIRECTORY**::
+
+specifica la directory da clonare nel file immagine. Il valore di default `e
+lo stesso default usato da live-initramfs per la sua directory COW (copy on
+write, un tempo situata in "/live/cow") ed `e sufficiente per gli usi comuni.
+Pu`o essere utile tuttavia specificare "/home" e come tipo "ext2" per
+preparare un file immagine adatto per essere montato da live-initramfs come
+"/home" al boot.
+
+  -d, --device **DEVICE**::
+
+seleziona il device dove il file/partizione di snapshot o persistenza dovr`a
+essere sistemato. Se il device non ha un filesystem, ne verr`a creato uno
+automaticamente, di tipo ext2 ed etichettato (label) in base al valore
+specificato nell'opzione "--output" o con un default. Se non viene specificato
+nessun device, verr`a usato un "tmpfs" linkato sul desktop dell'utente, in
+modo che port`a essere mosso dove si vuole.
+
+  -e, --exclude-list **FILE**::
+
+un file contenente una lista di file e percorsi che NON devono essere salvati.
+Questa lista verr`a inclusa nello snapshot per essere riutilizzata.
+
+  -o, --output **FILE**::
+
+il nome del file o l'etichetta (label) da usare per il file o la partizione di
+snapshot. Se non specificata, live-snapshot cercher\`a un file all'interno
+del device oppure user`a l'intera partizione.
+
+  -r, --resync-string **STRING**::
+
+usato internamente nelle sincronizzazioni dallo script di init di
+live-initramfs. Il formato pu\`o cambiare, usatelo a vostro rischio.
+
+  -t, --type **TYPE**::
+
+il tipo pu`o essere "cpio", "squashfs" o "ext2".
+
+  -h, --help::
+
+mostra l'aiuto ed esce
+
+  -u, --usage::
+
+mostra l'utilizzo ed esce
+
+  -v, --version::
+
+da informazioni sulla versione ed esce
+
+See also
+--------
+
+live-initramfs(8)
+
+Questo programma fa parte di live-initramfs.
+
+Bugs
+----
+
+Riportate i bug sul pacchetto live-initramfs
+link:http://packages.qa.debian.org/live-initramfs[http://packages.qa.debian.org/live-initramfs].
+
+Homepage
+--------
+
+Ulteriori informazioni su progetto Debian Live possono essere trovate su
+link:http://debian-live.alioth.debian.org/[http://debian-live.alioth.debian.org/] e
+link:http://wiki.debian.org/DebianLive/[http://wiki.debian.org/DebianLive/].
+
+Authors
+-------
+
+live-initramfs `e mantenuto da Daniel Baumann <daniel@debian.org> per il
+progetto Debian. live-initramfs `e un fork di
+link:http://packages.ubuntu.com/casper[casper]. casper `e stato scritto
+originariamente da Tollef Fog Heen <tfheen@canonical.com> e Matt Zimmerman
+<mdz@canonical.com>.