Some polishing of xorriso documentation

master
Thomas Schmitt 15 years ago
parent f3c4f142c2
commit 9a85568c29
  1. 15
      test/README
  2. 20
      test/xorriso.1
  3. 21
      test/xorriso_eng.html

@ -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

@ -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.

@ -124,7 +124,7 @@ Provides navigation commands for interactive ISO image manipulation.
</P>
<P>
<H2>Commands:</H2>
<H2>Command Examples:</H2>
<DL>
<DT>Get an overview of drives and their addresses</DT>
<DD>#<KBD>&nbsp;xorriso -devices</KBD></DD>
@ -173,7 +173,7 @@ write it to media, eject media.
<DD><KBD>&nbsp;&nbsp;-rm_r /sounds/indecent '/pictures/*private*' -- \</KBD></DD>
<DD><KBD>&nbsp;&nbsp;-add /pictures/private/horses=/home/me/pictures/private/horses -- \</KBD></DD>
<DD><KBD>&nbsp;&nbsp;-chmod_r a+r,a-w / -- \</KBD></DD>
<DD><KBD>&nbsp;&nbsp;-find / -type d -exec chmod a+x \</KBD></DD>
<DD><KBD>&nbsp;&nbsp;-find / -type d -exec chmod a+x -- \</KBD></DD>
<DD><KBD>&nbsp;&nbsp;-volid SOUNDS_PICS_2008_01_16 \</KBD></DD>
<DD><KBD>&nbsp;&nbsp;-commit -eject all</KBD></DD>
@ -216,6 +216,23 @@ Important: -indev and -outdev have to be different drives.
<HR>
</DT>
<DT>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.</DT>
<DD>$<KBD>&nbsp;xorriso -dialog on</KBD></DD>
<DD><KBD>enter option and arguments :</KBD></DD>
<DD><KBD><B>-dev /dev/sr0 -pathspecs on</B></KBD></DD>
<DD><KBD>enter option and arguments :</KBD></DD>
<DD><KBD><B>-add /sounds=/home/me/prepared_for_dvd/sounds_dummy /movies=/home/me/prepared_for_dvd/movies</B></KBD></DD>
<DD>Available navigation commands: -cd, -ls, -du, -find</DD>
<DD><KBD>enter option and arguments :</KBD></DD>
<DD><KBD><B>-commit -eject all -end</B></KBD></DD>
<DT>
<HR>
</DT>
<DT>Get overview of the options:</DT>
<DD>$<KBD>&nbsp;<A HREF="xorriso_help">xorriso -help</A></KBD></DD>

Loading…
Cancel
Save