From d711377086f9bc2763e98d250fd439f600507f11 Mon Sep 17 00:00:00 2001 From: Thomas Schmitt Date: Wed, 31 Oct 2007 17:54:54 +0000 Subject: [PATCH] Overhauled info paragraphs of man page --- libisoburn/trunk/test/xorriso.1 | 25 ++++++++++++++++++------- 1 file changed, 18 insertions(+), 7 deletions(-) diff --git a/libisoburn/trunk/test/xorriso.1 b/libisoburn/trunk/test/xorriso.1 index 2a1e6d07..ea3fc281 100644 --- a/libisoburn/trunk/test/xorriso.1 +++ b/libisoburn/trunk/test/xorriso.1 @@ -41,18 +41,20 @@ Operates on an existing ISO image or creates a new one. .br Copies files from filesystem into the ISO image. .br - > Renames or deletes file objects in the ISO image. +Renames or deletes file objects in the ISO image. .br > Changes file properties in the ISO image. .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 -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. .br Scans for optical drives, blanks re-useable optical media. .br Reads its instructions from command line arguments, dialog, and batch files. +.br +Provides navigation commands for interactive ISO image manipulation. .SS .B General information paragraphs: .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 .B session . .br -The data content of a session if called filesystem +The data content of a session is called filesystem .B image . .PP 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 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 -files or block devices. +files or non-CD/DVD block devices. Program growisofs by Andy Polyakov showed how to extend this functionality to overwriteable media or disk files which carry valid ISO 9660 filesystems. 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 -devices .br -It might be necessary to do this as superuser in order to see all drives -and to then allow rw-access for the intended users. +It might be necessary to do this as +.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 Filesystem objects of nearly any type can be addressed by prefix "stdio:" and 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 argument is one word, or from input lines where words are recognized similar 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 eventually reads their content as command input lines. Then it interprets the program arguments as commands and parameters and finally it enters