From d89487e3643744bec9a30906cb065776925d61c3 Mon Sep 17 00:00:00 2001 From: Thomas Schmitt Date: Sat, 19 Jan 2008 13:49:17 +0000 Subject: [PATCH] Some polishing of xorriso documentation --- libisoburn/trunk/test/README | 15 ++++++++------- libisoburn/trunk/test/xorriso.1 | 20 +++++++++++--------- libisoburn/trunk/test/xorriso_eng.html | 21 +++++++++++++++++++-- 3 files changed, 38 insertions(+), 18 deletions(-) diff --git a/libisoburn/trunk/test/README b/libisoburn/trunk/test/README index f79b722e..ec18ee8e 100644 --- a/libisoburn/trunk/test/README +++ b/libisoburn/trunk/test/README @@ -21,8 +21,8 @@ A special property of xorriso is that it needs neither an external ISO 9660 formatter program nor an external burn program for CD or DVD but rather incorporates the libraries of libburnia-project.org . -By using this software you agree to the disclaimer at the end of this text -"This software is provided as is. There is no warranty implied and ..." +By using this software you agree to the disclaimer at the end of this text: +"... without even the implied warranty ..." Compilation, First Glimpse, Installation @@ -31,8 +31,8 @@ The most simple way to get xorriso is the xorriso standalone tarball. Prerequisites: The tarball contains anything that is needed except libc and libpthread. -libreadline and the libreadline-development headers will make dialog mode -more convenient but are not mandatory. +libreadline and the libreadline-dev headers will make dialog mode +more convenient, but are not mandatory. Obtain xorriso-0.1.0.tar.gz, take it to a directory of your choice and do: @@ -60,12 +60,13 @@ For general concepts, options and usage examples see This man page is part of the tarball as xorriso/xorriso.1 -It gets installed with "make install" but may also be place manually in the -./man1 directory below one of the the directories mentioned in environment -variable $MANPATH. You may get a first glimpse by man ./xorriso/xorriso.1 +It gets installed with "make install" but may also be placed manually in the +./man1 directory below one of the directories mentioned in environment +variable $MANPATH. + Drives and Disk File Objects diff --git a/libisoburn/trunk/test/xorriso.1 b/libisoburn/trunk/test/xorriso.1 index 4b923cec..a78d6423 100644 --- a/libisoburn/trunk/test/xorriso.1 +++ b/libisoburn/trunk/test/xorriso.1 @@ -108,7 +108,7 @@ Adding a session to an existing ISO image is in this text referred as The multi-session model of the MMC standard does not apply to all media types. But program growisofs by Andy Polyakov showed how to extend this functionality to overwriteable media or disk files which carry valid ISO 9660 -filesystems. This expansion method is referred as as emulated growing. +filesystems. This expansion method is referred as emulated growing. .PP xorriso provides both ways of growing as well as an own method named \fBmodifying\fR which produces a completely new ISO image from the old @@ -466,6 +466,8 @@ Setting "on" enables it for all those commands. .br Setting "ls" enables it only for those which are marked by "disk_pattern [***]". +.br +Default is "ls". .TP \fB\-add\fR pathspec [...] | disk_path [***] Insert the given files or directory trees from filesystem @@ -624,7 +626,7 @@ may have specific parameters. See also their particular descriptions. "chgrp" and "chgrp_r" change the group attribute and get the group id as param. E.g.: .br - -find / name 'news*' -type d --exec chgrp_r staff + -find / name 'news*' -type d -exec chgrp_r staff .br "chmod" and "chmod_r" change access permissions and get a mode string as param. E.g.: @@ -676,7 +678,7 @@ Switch from eventual modifiying mode to growing mode. (A subsequent -outdev will activate modification mode.) -commit is performed automatically at end of program if there are uncommitted manipulations pending. -So to perform a final write operation with no new -dev +So, to perform a final write operation with no new -dev and no new loading of image, rather execute option -end. To suppress a final write, execute -rollback -end. .br @@ -688,7 +690,7 @@ minutes after all data have been transmitted. xorriso and the drives are in a client-server relationship. The drives have much freedom about what to do with the media. Some combinations of drives and media simply do not work, -despite the promises by vendors of drives and media. +despite the promises by their vendors. If writing fails - or even the drive gets stuck and you need to reboot - then try other media or another drive. The reason for such failure is hardly ever in the code of the various @@ -849,7 +851,7 @@ Set the burn speed. Default is 0 = maximum speed. Speed can be given in media dependent numbers or as a desired throughput per second in MMC compliant kB (= 1000) or MB (= 1000 kB). Media x-speed factor can be set explicity -by "c" for CD and "d" for "DVD". Example speeds: +by "c" for CD and "d" for DVD. Example speeds: .br 706k = 706kB/s = 4c = 4xCD .br @@ -1047,15 +1049,15 @@ Recursively list size of directories and files in the ISO image which match one of the patterns. similar to shell command du -k. .TP -\fB\-dux\fR disk_pattern [***] -Recursively list size of directories and files in the local filesystem -which match one of the patterns, similar to shell command du -k. -.TP \fB\-dus\fR iso_rr_pattern [***] List size of directories and files in the ISO image which match one of the patterns. Similar to shell command du -sk. .TP +\fB\-dux\fR disk_pattern [***] +Recursively list size of directories and files in the local filesystem +which match one of the patterns, similar to shell command du -k. +.TP \fB\-dusx\fR disk_pattern [***] List size of directories and files in the local filesystem which match one of the patterns. diff --git a/libisoburn/trunk/test/xorriso_eng.html b/libisoburn/trunk/test/xorriso_eng.html index a5cabb02..433f2757 100644 --- a/libisoburn/trunk/test/xorriso_eng.html +++ b/libisoburn/trunk/test/xorriso_eng.html @@ -124,7 +124,7 @@ Provides navigation commands for interactive ISO image manipulation.

-

Commands:

+

Command Examples:

Get an overview of drives and their addresses
# xorriso -devices
@@ -173,7 +173,7 @@ write it to media, eject media.
  -rm_r /sounds/indecent '/pictures/*private*' -- \
  -add /pictures/private/horses=/home/me/pictures/private/horses -- \
  -chmod_r a+r,a-w / -- \
-
  -find / -type d -exec chmod a+x \
+
  -find / -type d -exec chmod a+x -- \
  -volid SOUNDS_PICS_2008_01_16 \
  -commit -eject all
@@ -216,6 +216,23 @@ Important: -indev and -outdev have to be different drives.
+
Dialog mode accepts one or more options per line. An option and all its +arguments have to be given in one single line. Command -end stops a program +run. It would write eventually pending changes to media, if that had not +already been done by -commit.
+
$ xorriso -dialog on
+
enter option and arguments :
+
-dev /dev/sr0 -pathspecs on
+
enter option and arguments :
+
-add /sounds=/home/me/prepared_for_dvd/sounds_dummy /movies=/home/me/prepared_for_dvd/movies
+
Available navigation commands: -cd, -ls, -du, -find
+
enter option and arguments :
+
-commit -eject all -end
+ +
+
+
+
Get overview of the options:
$ xorriso -help