Overhauled info paragraphs of man page

This commit is contained in:
Thomas Schmitt 2007-10-31 17:54:54 +00:00
parent 44a3b060ec
commit d711377086

View File

@ -41,18 +41,20 @@ Operates on an existing ISO image or creates a new one.
.br .br
Copies files from filesystem into the ISO image. Copies files from filesystem into the ISO image.
.br .br
> Renames or deletes file objects in the ISO image. Renames or deletes file objects in the ISO image.
.br .br
> Changes file properties in the ISO image. > Changes file properties in the ISO image.
.br .br
> Writes result as completely new image to optical media or filesystem objects. > Can write result as completely new image to optical media or filesystem objects.
.br .br
Writes result as add-on session to appendable multi-session media, Can write result as add-on session to appendable multi-session media,
to overwriteable media, to regular files, and to block devices. to overwriteable media, to regular files, and to block devices.
.br .br
Scans for optical drives, blanks re-useable optical media. Scans for optical drives, blanks re-useable optical media.
.br .br
Reads its instructions from command line arguments, dialog, and batch files. Reads its instructions from command line arguments, dialog, and batch files.
.br
Provides navigation commands for interactive ISO image manipulation.
.SS .SS
.B General information paragraphs: .B General information paragraphs:
.br .br
@ -70,7 +72,7 @@ Unlike other filesystems, ISO 9660 is not intended for read-write operation but
rather for being generated in a single sweep and being written to media as a rather for being generated in a single sweep and being written to media as a
.B session . .B session .
.br .br
The data content of a session if called filesystem The data content of a session is called filesystem
.B image . .B image .
.PP .PP
The written image in its session can then be mounted by the operating system The written image in its session can then be mounted by the operating system
@ -90,7 +92,7 @@ which governs the data contents in all recorded sessions.
The multi-session model of the MMC standard applies to CD-R[W], to DVD-R, to The multi-session model of the MMC standard applies to CD-R[W], to DVD-R, to
certain states of DVD-RW, and to DVD+R. But it does not apply to overwriteable certain states of DVD-RW, and to DVD+R. But it does not apply to overwriteable
MMC media like DVD-RAM, DVD+RW, formatted DVD-RW, and of course not to disk MMC media like DVD-RAM, DVD+RW, formatted DVD-RW, and of course not to disk
files or block devices. files or non-CD/DVD block devices.
Program growisofs by Andy Polyakov showed how to extend this functionality Program growisofs by Andy Polyakov showed how to extend this functionality
to overwriteable media or disk files which carry valid ISO 9660 filesystems. to overwriteable media or disk files which carry valid ISO 9660 filesystems.
These two expansion methods are referred as "growing" in this text. These two expansion methods are referred as "growing" in this text.
@ -150,8 +152,10 @@ the path of their block device or of their generic character device. E.g.
Get a list of accessible drives by command Get a list of accessible drives by command
-devices -devices
.br .br
It might be necessary to do this as superuser in order to see all drives It might be necessary to do this as
and to then allow rw-access for the intended users. .B superuser
in order to see all drives and to then allow rw-access for the intended users.
Consider to bundle the authorized users in a group like old "floppy".
.PP .PP
Filesystem objects of nearly any type can be addressed by prefix "stdio:" and Filesystem objects of nearly any type can be addressed by prefix "stdio:" and
their path in the filesystem. E.g.: their path in the filesystem. E.g.:
@ -198,6 +202,13 @@ with a fixed list length.
Command and parameter words are either read from program arguments, where one Command and parameter words are either read from program arguments, where one
argument is one word, or from input lines where words are recognized similar argument is one word, or from input lines where words are recognized similar
to the quotation rules of a shell parser. to the quotation rules of a shell parser.
.br
xorriso is not a shell, although it might appear so on first glimpse.
Be aware that the interaction of quotation marks and pattern symbols like "*"
differs from the usual shell parsers. In xorriso, a quotation mark does not
make a pattern symbol literal. Pattern expansion is a property of some
particular commands and not a general feature.
.PP
When the program begins then it first looks for its startup files and When the program begins then it first looks for its startup files and
eventually reads their content as command input lines. Then it interprets eventually reads their content as command input lines. Then it interprets
the program arguments as commands and parameters and finally it enters the program arguments as commands and parameters and finally it enters