Added some examples to man page

This commit is contained in:
Thomas Schmitt 2007-11-11 15:59:30 +00:00
parent d20b78c66c
commit 58ac3ace5f

View File

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