From b23b454de63883a545b8c71838d54ee06122bee3 Mon Sep 17 00:00:00 2001
From: Thomas Schmitt <scdbackup@gmx.net>
Date: Sun, 11 Nov 2007 15:59:30 +0000
Subject: [PATCH] Added some examples to man page

---
 libisoburn/trunk/test/xorriso.1 | 102 +++++++++++++++++++++++++++++++-
 1 file changed, 100 insertions(+), 2 deletions(-)

diff --git a/libisoburn/trunk/test/xorriso.1 b/libisoburn/trunk/test/xorriso.1
index 300a88cd..6f53dd0b 100644
--- a/libisoburn/trunk/test/xorriso.1
+++ b/libisoburn/trunk/test/xorriso.1
@@ -2,7 +2,7 @@
 .\" First parameter, NAME, should be all caps
 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 .\" other parameters are allowed: see man(7), man(1)
-.TH XORRISO 1 "October 30, 2007"
+.TH XORRISO 1 "November 11, 2007"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -771,8 +771,106 @@ Use text as this program's name and perform -help.
 .br
 .SH EXAMPLES
 .SS
->>> more to come
+.B As superuser learn about available drives
+Consider to give rw permissions to those users or groups
+which shall be able to use the drives with xorriso.
 .br
+\fB$\fR xorriso -devices
+.br
+0  -dev '/dev/sr0' rwrw-- :  '_NEC    ' 'DVD_RW ND-4570A'
+.br
+1  -dev '/dev/sr1' rwrw-- :  'HL-DT-ST' 'DVDRAM GSA-4082B' 
+.br
+2  -dev '/dev/sr2' rwrw-- :  'PHILIPS ' 'SPD3300L' 
+.SS
+.B Blank media and compose a new ISO image as batch run
+Aquire drive /dev/sr2, blank media resp. invalidate existing ISO image.
+Add the files from hard disk directories /home/me/sounds and /pictures.
+Omit some unwanted stuff by removing it from the image directory tree.
+Re-add some wanted stuff.
+.br
+Because no -dialog "on" is given the program will then end by committing the
+session to media.
+.br
+\fB$\fR xorriso -dev /dev/sr2 \\
+ -blank fast \\
+ -graft-points \\
+ -add \\
+ /sounds=/home/me/sounds \\
+ /pictures \\
+ -- \\
+ -rm_r \\
+ /sounds/indecent \\
+ '/pictures/*private*' \\
+ /pictures/confidential \\
+ -- \\
+ -add \\
+ /pictures/confidential/work*
+.br
+Note that '/pictures/*private*' is a pattern for iso_rr_paths
+while /pictures/confidential/work* gets expanded by the shell
+with addresses from the hard disk.
+.SS
+.B A dialog session doing about the same
+.br
+-graft-points is already given as start argument. The other activities
+are done as dialog input. The pager gets set to 20 lines of 80 chracters.
+.br
+In order to be able to eject the media, the session needs to be committed
+explicitely.
+.br
+\fB$\fR xorriso -graft-points -dialog on -page 20 80
+.br
+enter option and arguments :
+.br
+.B \-dev /dev/sr2
+.br
+enter option and arguments :
+.br
+.B \-blank fast
+.br
+enter option and arguments :
+.br
+.B \-add /sounds=/home/me/sounds /pictures
+.br
+enter option and arguments :
+.br
+.B \-rm_r /sounds/indecent /pictures/*private* /pictures/confidential
+.br
+enter option and arguments :
+.br
+.B \-add /pictures/confidential/work_office /pictures/confidential/work_factory
+.br
+enter option and arguments :
+.br
+.B \-du /
+.br
+enter option and arguments :
+.br
+.B \-commit -eject -end
+.br
+.SS
+.B Modifying an existing ISO image
+Remove (i.e. hide) directory /sounds and its subordinates.
+Rename directory /pictures/confidential to /pictures/restricted.
+Change access permissions of directory /pictures/restricted.
+Add dummy as replacement of /pictures/confidential.
+Add new directory tree /movies. Burn to DVD and eject.
+.br
+\fB$\fR xorriso -dev /dev/sr2 \\
+ -rm_r /sounds -- \\
+ -mv \\
+ /pictures/confidential \\
+ /pictures/restricted \\
+ -- \\
+ -chmod go-rwx /pictures/restricted -- \\
+ -graft-points \\
+ -add \\
+ /sounds=/home/me/prepared_for_dvd/sounds_dummy \\
+ /movies=/home/me/prepared_for_dvd/movies \\
+ -- \\
+ -commit \\
+ -eject
 .SS
 .B Examples of input timestrings
 .br