diff --git a/xorriso/README_gnu_xorriso b/xorriso/README_gnu_xorriso index 0a40e316..41e57cee 100644 --- a/xorriso/README_gnu_xorriso +++ b/xorriso/README_gnu_xorriso @@ -72,17 +72,15 @@ or you may execute as superuser: For general concepts, options and usage examples see info xorriso -or + info xorrisofs man 1 xorriso + man 1 xorrisofs -The documents are part of the tarball as - xorriso/xorriso.info - xorriso/xorriso.1 -Original source text of both is - xorriso/xorriso.texi You may get a first glimpse by info ./xorriso/xorriso.info + info ./xorriso/xorrisofs.info man ./xorriso/xorriso.1 + man ./xorriso/xorrisofs.1 The installation creates several alias links pointing to the xorriso binary: xorrisofs starts xorriso with -as mkisofs emulation already enabled diff --git a/xorriso/convert_man_to_html.sh b/xorriso/convert_man_to_html.sh index 4fca1392..55b40740 100755 --- a/xorriso/convert_man_to_html.sh +++ b/xorriso/convert_man_to_html.sh @@ -1,118 +1,13 @@ #!/bin/sh # -# convert_man_to_html.sh - ts A80118 +# convert_man_to_html.sh - ts B10309 # -# Generates a HTML version of man page xorriso.1 +# Generates a HTML version of man pages xorriso.1 , xorrisofs.1 # -# To be executed in the libisoburn toplevel directory (eg. ./libisoburn-0.1.0) +# To be executed in the libisoburn toplevel directory (eg. ./libisoburn-1.0.4) # -# set -x +xorriso/man_xorriso_to_html.sh +xorriso/man_xorrisofs_to_html.sh -man_dir=$(pwd)"/xorriso" -export MANPATH="$man_dir" -manpage="xorriso" -raw_html=$(pwd)/"xorriso/raw_man_1_xorriso.html" -htmlpage=$(pwd)/"xorriso/man_1_xorriso.html" - -if test -r "$man_dir"/"$manpage".1 -then - dummy=dummy -else - echo "Cannot find readable man page source $1" >&2 - exit 1 -fi - -if test -e "$man_dir"/man1 -then - dummy=dummy -else - ln -s . "$man_dir"/man1 -fi - -if test "$1" = "-work_as_filter" -then - -# set -x - - sed \ - -e 's///' \ - -e 's///' \ - -e 's/XORRISO<\/title>/<title>man 1 xorriso<\/title>/' \ - -e 's/<h1 align=center>XORRISO<\/h1>/<h1 align=center>man 1 xorriso<\/h1>/' \ - -e 's/<body>/<body BGCOLOR="#F5DEB3" TEXT=#000000 LINK=#0000A0 VLINK=#800000>/' \ - -e 's/<b>Overview of features:<\/b>/\ <BR><b>Overview of features:<\/b>/' \ - -e 's/<b>General information paragraphs:<\/b>/\ <BR><b>General information paragraphs:<\/b>/' \ - -e 's/have a look at section EXAMPLES/have a look at section <A HREF="#EXAMPLES">EXAMPLES<\/A>/' \ - -e 's/<b>Session model:<\/b>/\ <BR><b>Session model:<\/b>/' \ - -e 's/<b>Media types and states:<\/b>/\ <BR><b>Media types and states:<\/b>/' \ - -e 's/<b>Creating, Growing, Modifying, Blind/\ <BR><b>Creating, Growing, Modifying, Blind/' \ - -e 's/<b>Libburn drives:<\/b>/\ <BR><b>Libburn drives:<\/b>/' \ - -e 's/^-dev /\ \ -dev /' \ - -e 's/^-devices /\ \ -devices /' \ - -e 's/<b>Rock Ridge, POSIX, X\/Open, El Torito, ACL,/\ <BR><b>Rock Ridge, POSIX, X\/Open, El Torito, ACL,/' \ - -e 's/<b>Command processing:<\/b>/\ <BR><b>Command processing:<\/b>/' \ - -e 's/<b>Dialog, Readline, Result pager:<\/b>/\ <BR><b>Dialog, Readline, Result pager:<\/b>/' \ - -e 's/<b>Aquiring source and target drive:<\/b>/\ <BR><b>Aquiring source and target drive:<\/b><BR>\ <BR>/' \ - -e 's/<b>Influencing the behavior of image/\ <BR><b>Influencing the behavior of image/' \ - -e 's/<b>Inserting files into ISO image:<\/b>/\ <BR><b>Inserting files into ISO image:<\/b><BR>\ <BR>/' \ - -e 's/<b>File manipulations:<\/b>/\ <BR><b>File manipulations:<\/b><BR>\ <BR>/' \ - -e 's/<b>Tree traversal command -find:<\/b>/\ <BR><b>Tree traversal command -find:<\/b><BR>\ <BR>/' \ - -e 's/^<p><b>−iso_rr_pattern/<p>\ <BR><b>\−iso_rr_pattern/' \ - -e 's/EXAMPLES):<br>/<A HREF="#EXAMPLES">EXAMPLES<\/A>):<br>/' \ - -e 's/<b>Filters for data file content:<\/b>/\ <BR><b>Filters for data file content:<\/b><BR>\ <BR>/' \ - -e 's/<b>Writing the result, drive control:<\/b>/\ <BR><b>Writing the result, drive control:<\/b><BR>\ <BR>/' \ - -e 's/^-find \/ /\ \ -find \/ /' \ - -e 's/<b>Settings for file insertion:<\/b>/\ <BR><b>Settings for file insertion:<\/b><BR>\ <BR>/' \ - -e 's/^$<\/b> ln -s/\ \ $<\/b> ln -s/' \ - -e 's/<b>Settings for result writing:<\/b>/\ <BR><b>Settings for result writing:<\/b><BR>\ <BR>/' \ - -e 's/^706k = 706kB/\ \ 706k = 706kB/' \ - -e 's/^5540k = 5540kB/\ \ 5540k = 5540kB/' \ - -e 's/<b>Character sets:<\/b>/\ <BR><b>Character sets:<\/b><BR>\ <BR>/' \ - -e 's/<b>Exception processing:<\/b>/\ <BR><b>Exception processing:<\/b><BR>\ <BR>/' \ - -e 's/<b>El Torito bootable ISO images:<\/b>/\ <BR><b>El Torito bootable ISO images:<\/b><BR>\ <BR>/' \ - -e 's/<b>Jigdo Template Extraction:<\/b>/\ <BR><b>Jigdo Template Extraction:<\/b><BR>\ <BR>/' \ - -e 's/<b>Dialog mode control:<\/b>/\ <BR><b>Dialog mode control:<\/b><BR>\ <BR>/' \ - -e 's/<b>Drive and media related inquiry actions:<\/b>/\ <BR><b>Drive and media related inquiry actions:<\/b><BR>\ <BR>/' \ - -e 's/<b>Navigation in ISO image/\ <BR><b>Navigation in ISO image/' \ - -e 's/^filesystem:<\/b>/filesystem:<\/b><BR>\ <BR>/' \ - -e 's/<b>Evaluation of readability and recovery:<\/b>/\ <BR><b>Evaluation of readability and recovery:<\/b><BR>\ <BR>/' \ - -e 's/<b>osirrox ISO-to-disk restore options:<\/b>/\ <BR><b>osirrox ISO-to-disk restore options:<\/b><BR>\ <BR>/' \ - -e 's/<b>Command compatibility emulations:<\/b>/\ <BR><b>Command compatibility emulations:<\/b><BR>\ <BR>/' \ - -e 's/^<p><b>−as</<p>\ <BR><b>\−as</' \ - -e 's/<b>Scripting, dialog and/\ <BR><b>Scripting, dialog and/' \ - -e 's/^features:<\/b>/features:<\/b><BR>\ <BR>/' \ - -e 's/<b>Support for frontend/\ <BR><b>Support for frontend/' \ - -e 's/^listening at stdout:<\/b>/listening at stdout:<\/b><BR>\ <BR>/' \ - -e 's/xorriso -outdev \/dev\/sr2 \\ -blank fast \\ -pathspecs on/xorriso -outdev \/dev\/sr2 -blank fast -pathspecs on/' \ - -e 's/\\ -add \\ \/sounds=\/home\/me\/sounds \\ \/pictures \\ -- \\ -rm_r \\/ -add \/sounds=\/home\/me\/sounds \/pictures -- -rm_r /' \ - -e 's/\/sounds\/indecent \\ \’\/pictures\/\*private\*\’ \\/\/sounds\/indecent \’\/pictures\/*private*\’ /' \ - -e 's/\/pictures\/confidential \\ -- \\ -add \\/\/pictures\/confidential -- -add/' \ - -e 's/xorriso -dev \/dev\/sr2 \\ -rm_r \/sounds -- \\ -mv \\/xorriso -dev \/dev\/sr2 -rm_r \/sounds -- -mv /' \ - -e 's/\/pictures\/confidential \\ \/pictures\/restricted \\ -- \\ -chmod/\/pictures\/confidential \/pictures\/restricted -- -chmod/' \ - -e 's/go-rwx \/pictures\/restricted -- \\ -pathsspecs on \\ -add \\/go-rwx \/pictures\/restricted -- -pathsspecs on -add /' \ - -e 's/\/sounds=\/home\/me\/prepared_for_dvd\/sounds_dummy /\/sounds=\/home\/me\/prepared_for_dvd\/sounds_dummy/' \ - -e 's/\/movies=\/home\/me\/prepared_for_dvd\/movies \\ -- \\ -commit/\/movies=\/home\/me\/prepared_for_dvd\/movies -- -commit/' \ - -e 's/xorriso -indev \/dev\/sr2 \\ -rm_r \/sounds -- \\/xorriso -indev \/dev\/sr2 -rm_r \/sounds -- /' \ - -e 's/-outdev \/dev\/sr0 -blank fast \\ -commit -eject all/-outdev \/dev\/sr0 -blank fast -commit -eject all/' \ - -e 's/See section FILES/See section <A HREF="#FILES">FILES<\/A>/' \ - -e 's/See section EXAMPLES/See section <A HREF="#EXAMPLES">EXAMPLES<\/A>/' \ - -e 's/<\/body>/<BR><HR><FONT SIZE=-1><CENTER>(HTML generated from '"$manpage"'.1 on '"$(date)"' by '$(basename "$0")' )<\/CENTER><\/FONT><\/body>/' \ - <"$2" >"$htmlpage" - - set +x - - chmod u+rw,go+r,go-w "$htmlpage" - echo "Emerged file:" - ls -lL "$htmlpage" - -else - - export BROWSER='cp "%s" '"$raw_html" - man -H "$manpage" - "$0" -work_as_filter "$raw_html" - rm "$raw_html" - rm "$man_dir"/man1 - -fi diff --git a/xorriso/make_xorriso_standalone.sh b/xorriso/make_xorriso_standalone.sh index 5f7a0655..7c027688 100755 --- a/xorriso/make_xorriso_standalone.sh +++ b/xorriso/make_xorriso_standalone.sh @@ -198,6 +198,7 @@ copy_files \ xorriso/xorriso.1 \ xorriso/xorrisofs.1 \ xorriso/man_1_xorriso.html \ + xorriso/man_1_xorrisofs.html \ "$lone_dir"/xorriso copy_files COPYRIGHT "$lone_dir"/xorriso diff --git a/xorriso/man_xorriso_to_html.sh b/xorriso/man_xorriso_to_html.sh new file mode 100755 index 00000000..b8785a17 --- /dev/null +++ b/xorriso/man_xorriso_to_html.sh @@ -0,0 +1,118 @@ +#!/bin/sh + +# +# man_xorriso_to_html.sh - ts A80118 , B10309 +# +# Generates a HTML version of man page xorriso.1 +# +# To be executed in the libisoburn toplevel directory (eg. ./libisoburn-0.1.0) +# + +# set -x + +man_dir=$(pwd)"/xorriso" +export MANPATH="$man_dir" +manpage="xorriso" +raw_html=$(pwd)/"xorriso/raw_man_1_xorriso.html" +htmlpage=$(pwd)/"xorriso/man_1_xorriso.html" + +if test -r "$man_dir"/"$manpage".1 +then + dummy=dummy +else + echo "Cannot find readable man page source $1" >&2 + exit 1 +fi + +if test -e "$man_dir"/man1 +then + dummy=dummy +else + ln -s . "$man_dir"/man1 +fi + +if test "$1" = "-work_as_filter" +then + +# set -x + + sed \ + -e 's/<meta name="generator" content="groff -Thtml, see www.gnu.org">/<meta name="generator" content="groff -Thtml, via man -H, via xorriso\/convert_man_to_html.sh">/' \ + -e 's/<meta name="Content-Style" content="text\/css">/<meta name="Content-Style" content="text\/css"><META NAME="description" CONTENT="man page of xorriso"><META NAME="keywords" CONTENT="man xorriso, manual, xorriso, CD, CD-RW, CD-R, burning, cdrecord, compatible"><META NAME="robots" CONTENT="follow">/' \ + -e 's/<title>XORRISO<\/title>/<title>man 1 xorriso<\/title>/' \ + -e 's/<h1 align=center>XORRISO<\/h1>/<h1 align=center>man 1 xorriso<\/h1>/' \ + -e 's/<body>/<body BGCOLOR="#F5DEB3" TEXT=#000000 LINK=#0000A0 VLINK=#800000>/' \ + -e 's/<b>Overview of features:<\/b>/\ <BR><b>Overview of features:<\/b>/' \ + -e 's/<b>General information paragraphs:<\/b>/\ <BR><b>General information paragraphs:<\/b>/' \ + -e 's/have a look at section EXAMPLES/have a look at section <A HREF="#EXAMPLES">EXAMPLES<\/A>/' \ + -e 's/<b>Session model:<\/b>/\ <BR><b>Session model:<\/b>/' \ + -e 's/<b>Media types and states:<\/b>/\ <BR><b>Media types and states:<\/b>/' \ + -e 's/<b>Creating, Growing, Modifying, Blind/\ <BR><b>Creating, Growing, Modifying, Blind/' \ + -e 's/<b>Libburn drives:<\/b>/\ <BR><b>Libburn drives:<\/b>/' \ + -e 's/^-dev /\ \ -dev /' \ + -e 's/^-devices /\ \ -devices /' \ + -e 's/<b>Rock Ridge, POSIX, X\/Open, El Torito, ACL,/\ <BR><b>Rock Ridge, POSIX, X\/Open, El Torito, ACL,/' \ + -e 's/<b>Command processing:<\/b>/\ <BR><b>Command processing:<\/b>/' \ + -e 's/<b>Dialog, Readline, Result pager:<\/b>/\ <BR><b>Dialog, Readline, Result pager:<\/b>/' \ + -e 's/<b>Aquiring source and target drive:<\/b>/\ <BR><b>Aquiring source and target drive:<\/b><BR>\ <BR>/' \ + -e 's/<b>Influencing the behavior of image/\ <BR><b>Influencing the behavior of image/' \ + -e 's/<b>Inserting files into ISO image:<\/b>/\ <BR><b>Inserting files into ISO image:<\/b><BR>\ <BR>/' \ + -e 's/<b>File manipulations:<\/b>/\ <BR><b>File manipulations:<\/b><BR>\ <BR>/' \ + -e 's/<b>Tree traversal command -find:<\/b>/\ <BR><b>Tree traversal command -find:<\/b><BR>\ <BR>/' \ + -e 's/^<p><b>−iso_rr_pattern/<p>\ <BR><b>\−iso_rr_pattern/' \ + -e 's/EXAMPLES):<br>/<A HREF="#EXAMPLES">EXAMPLES<\/A>):<br>/' \ + -e 's/<b>Filters for data file content:<\/b>/\ <BR><b>Filters for data file content:<\/b><BR>\ <BR>/' \ + -e 's/<b>Writing the result, drive control:<\/b>/\ <BR><b>Writing the result, drive control:<\/b><BR>\ <BR>/' \ + -e 's/^-find \/ /\ \ -find \/ /' \ + -e 's/<b>Settings for file insertion:<\/b>/\ <BR><b>Settings for file insertion:<\/b><BR>\ <BR>/' \ + -e 's/^$<\/b> ln -s/\ \ $<\/b> ln -s/' \ + -e 's/<b>Settings for result writing:<\/b>/\ <BR><b>Settings for result writing:<\/b><BR>\ <BR>/' \ + -e 's/^706k = 706kB/\ \ 706k = 706kB/' \ + -e 's/^5540k = 5540kB/\ \ 5540k = 5540kB/' \ + -e 's/<b>Character sets:<\/b>/\ <BR><b>Character sets:<\/b><BR>\ <BR>/' \ + -e 's/<b>Exception processing:<\/b>/\ <BR><b>Exception processing:<\/b><BR>\ <BR>/' \ + -e 's/<b>El Torito bootable ISO images:<\/b>/\ <BR><b>El Torito bootable ISO images:<\/b><BR>\ <BR>/' \ + -e 's/<b>Jigdo Template Extraction:<\/b>/\ <BR><b>Jigdo Template Extraction:<\/b><BR>\ <BR>/' \ + -e 's/<b>Dialog mode control:<\/b>/\ <BR><b>Dialog mode control:<\/b><BR>\ <BR>/' \ + -e 's/<b>Drive and media related inquiry actions:<\/b>/\ <BR><b>Drive and media related inquiry actions:<\/b><BR>\ <BR>/' \ + -e 's/<b>Navigation in ISO image/\ <BR><b>Navigation in ISO image/' \ + -e 's/^filesystem:<\/b>/filesystem:<\/b><BR>\ <BR>/' \ + -e 's/<b>Evaluation of readability and recovery:<\/b>/\ <BR><b>Evaluation of readability and recovery:<\/b><BR>\ <BR>/' \ + -e 's/<b>osirrox ISO-to-disk restore options:<\/b>/\ <BR><b>osirrox ISO-to-disk restore options:<\/b><BR>\ <BR>/' \ + -e 's/<b>Command compatibility emulations:<\/b>/\ <BR><b>Command compatibility emulations:<\/b><BR>\ <BR>/' \ + -e 's/^<p><b>−as</<p>\ <BR><b>\−as</' \ + -e 's/<b>Scripting, dialog and/\ <BR><b>Scripting, dialog and/' \ + -e 's/^features:<\/b>/features:<\/b><BR>\ <BR>/' \ + -e 's/<b>Support for frontend/\ <BR><b>Support for frontend/' \ + -e 's/^listening at stdout:<\/b>/listening at stdout:<\/b><BR>\ <BR>/' \ + -e 's/xorriso -outdev \/dev\/sr2 \\ -blank fast \\ -pathspecs on/xorriso -outdev \/dev\/sr2 -blank fast -pathspecs on/' \ + -e 's/\\ -add \\ \/sounds=\/home\/me\/sounds \\ \/pictures \\ -- \\ -rm_r \\/ -add \/sounds=\/home\/me\/sounds \/pictures -- -rm_r /' \ + -e 's/\/sounds\/indecent \\ \’\/pictures\/\*private\*\’ \\/\/sounds\/indecent \’\/pictures\/*private*\’ /' \ + -e 's/\/pictures\/confidential \\ -- \\ -add \\/\/pictures\/confidential -- -add/' \ + -e 's/xorriso -dev \/dev\/sr2 \\ -rm_r \/sounds -- \\ -mv \\/xorriso -dev \/dev\/sr2 -rm_r \/sounds -- -mv /' \ + -e 's/\/pictures\/confidential \\ \/pictures\/restricted \\ -- \\ -chmod/\/pictures\/confidential \/pictures\/restricted -- -chmod/' \ + -e 's/go-rwx \/pictures\/restricted -- \\ -pathsspecs on \\ -add \\/go-rwx \/pictures\/restricted -- -pathsspecs on -add /' \ + -e 's/\/sounds=\/home\/me\/prepared_for_dvd\/sounds_dummy /\/sounds=\/home\/me\/prepared_for_dvd\/sounds_dummy/' \ + -e 's/\/movies=\/home\/me\/prepared_for_dvd\/movies \\ -- \\ -commit/\/movies=\/home\/me\/prepared_for_dvd\/movies -- -commit/' \ + -e 's/xorriso -indev \/dev\/sr2 \\ -rm_r \/sounds -- \\/xorriso -indev \/dev\/sr2 -rm_r \/sounds -- /' \ + -e 's/-outdev \/dev\/sr0 -blank fast \\ -commit -eject all/-outdev \/dev\/sr0 -blank fast -commit -eject all/' \ + -e 's/See section FILES/See section <A HREF="#FILES">FILES<\/A>/' \ + -e 's/See section EXAMPLES/See section <A HREF="#EXAMPLES">EXAMPLES<\/A>/' \ + -e 's/<\/body>/<BR><HR><FONT SIZE=-1><CENTER>(HTML generated from '"$manpage"'.1 on '"$(date)"' by '$(basename "$0")' )<\/CENTER><\/FONT><\/body>/' \ + <"$2" >"$htmlpage" + + set +x + + chmod u+rw,go+r,go-w "$htmlpage" + echo "Emerged file:" + ls -lL "$htmlpage" + +else + + export BROWSER='cp "%s" '"$raw_html" + man -H "$manpage" + "$0" -work_as_filter "$raw_html" + rm "$raw_html" + rm "$man_dir"/man1 + +fi diff --git a/xorriso/man_xorrisofs_to_html.sh b/xorriso/man_xorrisofs_to_html.sh new file mode 100755 index 00000000..ca09a523 --- /dev/null +++ b/xorriso/man_xorrisofs_to_html.sh @@ -0,0 +1,79 @@ +#!/bin/sh + +# +# man_xorrisofs_to_html.sh - ts A80118 , B10309 +# +# Generates a HTML version of man page xorrisofs.1 +# +# To be executed in the libisoburn toplevel directory (eg. ./libisoburn-0.1.0) +# + +# set -x + +man_dir=$(pwd)"/xorriso" +export MANPATH="$man_dir" +manpage="xorrisofs" +raw_html=$(pwd)/"xorriso/raw_man_1_xorrisofs.html" +htmlpage=$(pwd)/"xorriso/man_1_xorrisofs.html" + +if test -r "$man_dir"/"$manpage".1 +then + dummy=dummy +else + echo "Cannot find readable man page source $1" >&2 + exit 1 +fi + +if test -e "$man_dir"/man1 +then + dummy=dummy +else + ln -s . "$man_dir"/man1 +fi + +if test "$1" = "-work_as_filter" +then + +# set -x + + sed \ + -e 's/<meta name="generator" content="groff -Thtml, see www.gnu.org">/<meta name="generator" content="groff -Thtml, via man -H, via xorriso\/convert_man_to_html.sh">/' \ + -e 's/<meta name="Content-Style" content="text\/css">/<meta name="Content-Style" content="text\/css"><META NAME="description" CONTENT="man page of xorriso"><META NAME="keywords" CONTENT="man xorrisofs, manual, xorrisofs, ISO 9660, mkisofs, compatible"><META NAME="robots" CONTENT="follow">/' \ + -e 's/<title>XORRISOFS<\/title>/<title>man 1 xorrisofs<\/title>/' \ + -e 's/<h1 align=center>XORRISOFS<\/h1>/<h1 align=center>man 1 xorrisofs<\/h1>/' \ + -e 's/<body>/<body BGCOLOR="#F5DEB3" TEXT=#000000 LINK=#0000A0 VLINK=#800000>/' \ + -e 's/<b>ISO 9660, Rock Ridge, Joliet:<\/b>/\ <BR><b>ISO 9660, Rock Ridge, Joliet:<\/b>/' \ + -e 's/<b>Inserting files into the ISO image:<\/b>/\ <BR><b>Inserting files into the ISO image:<\/b>/' \ + -e 's/<b>Relation to program xorriso:<\/b>/\ <BR><b>Relation to program xorriso:<\/b>/' \ + -e 's/EXAMPLES):<br>/<A HREF="#EXAMPLES">EXAMPLES<\/A>):<br>/' \ + -e 's/<b>Image loading:<\/b>/\ <BR><b>Image loading:<\/b><BR>\ <BR>/' \ + -e 's/<b>Settings for file insertion:<\/b>/\ <BR><b>Settings for file insertion:<\/b><BR>\ <BR>/' \ + -e 's/<b>Settings for image production:<\/b>/\ <BR><b>Settings for image production:<\/b><BR>\ <BR>/' \ + -e 's/<b>Settings for standards compliance:<\/b>/\ <BR><b>Settings for standards compliance:<\/b><BR>\ <BR>/' \ + -e 's/<b>Settings for standards extensions:<\/b>/\ <BR><b>Settings for standards extensions:<\/b><BR>\ <BR>/' \ + -e 's/<b>Settings for file hiding:<\/b>/\ <BR><b>Settings for file hiding:<\/b><BR>\ <BR>/' \ + -e 's/<b>ISO image ID strings:<\/b>/\ <BR><b>ISO image ID strings:<\/b><BR>\ <BR>/' \ + -e 's/<b>El Torito Bootable ISO images:<\/b>/\ <BR><b>El Torito Bootable ISO images:<\/b><BR>\ <BR>/' \ + -e 's/<b>System Area, MBR, other boot blocks:<\/b>/\ <BR><b>System Area, MBR, other boot blocks:<\/b><BR>\ <BR>/' \ + -e 's/<b>Character sets:<\/b>/\ <BR><b>Character sets:<\/b><BR>\ <BR>/' \ + -e 's/<b>Jigdo Template Extraction:<\/b>/\ <BR><b>Jigdo Template Extraction:<\/b><BR>\ <BR>/' \ + -e 's/<b>Miscellaneous options:<\/b>/\ <BR><b>Miscellaneous options:<\/b><BR>\ <BR>/' \ +\ + -e 's/<\/body>/<BR><HR><FONT SIZE=-1><CENTER>(HTML generated from '"$manpage"'.1 on '"$(date)"' by '$(basename "$0")' )<\/CENTER><\/FONT><\/body>/' \ + <"$2" >"$htmlpage" + + set +x + + chmod u+rw,go+r,go-w "$htmlpage" + echo "Emerged file:" + ls -lL "$htmlpage" + +else + + export BROWSER='cp "%s" '"$raw_html" + man -H "$manpage" + "$0" -work_as_filter "$raw_html" + rm "$raw_html" + rm "$man_dir"/man1 + +fi diff --git a/xorriso/xorriso_eng.html b/xorriso/xorriso_eng.html index ea177e6c..aa370daa 100644 --- a/xorriso/xorriso_eng.html +++ b/xorriso/xorriso_eng.html @@ -607,6 +607,8 @@ cdrecord and mkisofs.</DT> </LI> <LI>isohybrid image size was not aligned to cylinder boundary </LI> +<LI>Compilation without zlib failed +</LI> <!-- <LI>- none yet -</LI> --> @@ -639,6 +641,7 @@ Own man page and info document for xorrisofs <DD><A HREF="xorrisofs_help_devel">xorriso-1.0.3 -as mkisofs -help</A></DD> <DD><A HREF="xorrecord_help_devel">xorriso-1.0.3 -as cdrecord -help</A></DD> <DD><A HREF="man_1_xorriso_devel.html">man xorriso (as of 1.0.3)</A></DD> +<DD><A HREF="man_1_xorrisofs_devel.html">man xorrisofs (as of 1.0.3)</A></DD> <DD> </DD> <DT>If you want to distribute development versions of xorriso, then use this tarball which produces static linking between xorriso and the diff --git a/xorriso/xorrisofs.1 b/xorriso/xorrisofs.1 index 15b4b290..d6ef7497 100644 --- a/xorriso/xorrisofs.1 +++ b/xorriso/xorrisofs.1 @@ -211,6 +211,7 @@ type can enclose the marks of the other type. A trailing backslash \\ outside quotations or an open quotation cause the next input line to be appended. .TP \fB\-f\fR +.br Resolve symbolic links on disk rather than storing them as symbolic links in the ISO image. .TP @@ -233,6 +234,7 @@ It is possible to give more than one -m option. Alias of -m. .TP \fB\-x\fR +.br Alias of -m. .TP \fB\-old-exclude\fR @@ -242,6 +244,7 @@ Alias of -m. Perform -m using each line out of file disk_path as argument disk_pattern. .TP \fB\-z\fR +.br Enable recognition and proper processing of zisofs compressed files as produced by program mkzftree. These files will get equipped with the necessary meta data so that a Linux kernel will recognize them and @@ -361,6 +364,7 @@ list of statements of the form [ugoa]*[+-=][rwxst]* . E.g. ug=rx,a-rwx Like -dir-mode but for all regular data files in the image. .TP \fB\-pad\fR +.br Add 300 KiB to the end of the produced ISO image. This circumvents possible read errors from ISO images which have been written to CD media in TAO mode. The additional bytes are claimed as part of the ISO image if not --emul-toc @@ -405,6 +409,7 @@ of directories. On the other hand, some bootable GNU/Linux images depend on this bad habit. .TP \fB\-U\fR +.br This option allows ISO file names without dot and up to 37 characters, ISO file paths longer than 255 characters, and all ASCII characters in file names. Further it omits the semicolon and the version numbers at the end @@ -428,6 +433,7 @@ Allow lowercase character in ISO file names. This violates ISO 9660 specs. .TP \fB\-d\fR +.br Do not add trailing dot to ISO file names without dot. .br This violates ISO 9660 specs. @@ -436,6 +442,7 @@ This violates ISO 9660 specs. Alias of -d. .TP \fB\-l\fR +.br Allow up to 37 characters in ISO file names. .br This violates ISO 9660 specs. @@ -447,6 +454,7 @@ Alias of -l. Alias of -l. .TP \fB\-N\fR +.br Omit the semicolon and the version numbers at the end of ISO names. .br This violates ISO 9660 specs. @@ -457,13 +465,16 @@ Alias of -N. .B Settings for standards extensions: .TP \fB\-R\fR +.br With mkisofs this option enables Rock Ridge extensions. xorrisofs produces them unconditionally. .TP \fB\-rock\fR +.br Alias of -R. .TP \fB\-r\fR +.br Set Rock Ridge user and group id of all files in the ISO image to 0. Grant r-permissions to all. Deny all w-permissions. If any x-permission is set, grant x-permission to all. @@ -478,17 +489,20 @@ Enable options which improve backup fidelity: --hardlinks. .TP \fB--acl\fR +.br Enable recording and loading of GNU/Linux ACLs (see man getfacl, man acl). They will not be in effect with mounted ISO images. But xorriso can restore them when extracting files from the ISO image. .TP \fB--xattr\fR +.br Enable recording and loading of GNU/Linux extended attributes in user namespace (see man getfattr, man attr). They will not be in effect with mounted ISO images. But xorriso can restore them when extracting files from the ISO image. .TP \fB--md5\fR +.br Enable recording of MD5 checksums for the overall ISO image and for each single data file in the image. xorriso can check the content of an ISO image with these sums and eventually raise alert on mismatch. @@ -517,6 +531,7 @@ and record. Program scdbackup_verify will recognize and verify tag resp. record. .TP \fB\-J\fR +.br Enable the production of an additional Joliet directory tree along with the ISO 9660 Rock Ridge tree. .TP @@ -1020,14 +1035,17 @@ prevents reading and interpretation of eventual startup files. See section FILES below. .TP \fB\-help\fR +.br List supported options to stderr. Original mkisofs options bear their original mkisofs description texts. .TP \fB\-quiet\fR +.br Suppress most messages of the program run, except those which indicate problems or errors. .TP \fB\-v\fR +.br Enable the output of informational program messages. .TP \fB\-verbose\fR diff --git a/xorriso/xorrisofs.texi b/xorriso/xorrisofs.texi index 8f0b9472..8c2d2c3d 100644 --- a/xorriso/xorrisofs.texi +++ b/xorriso/xorrisofs.texi @@ -347,6 +347,7 @@ quotations or an open quotation cause the next input line to be appended. @item -f @kindex -f follow symbolic links on disk @cindex Links, follow on disk, -f, -follow-links +@* Resolve symbolic links on disk rather than storing them as symbolic links in the ISO image. @c man .TP @@ -376,6 +377,7 @@ Alias of -m. @c man .TP @item -x @kindex -x exclude disk files from inserting +@* Alias of -m. @c man .TP @item -old-exclude @@ -390,6 +392,7 @@ Perform -m using each line out of file disk_path as argument disk_pattern. @item -z @kindex -z enable recognition of zisofs files @cindex zisofs file, enable recognition, -z, -transparent-compression +@* Enable recognition and proper processing of zisofs compressed files as produced by program mkzftree. These files will get equipped with the necessary meta data so that a Linux kernel will recognize them and @@ -542,6 +545,7 @@ Like -dir-mode but for all regular data files in the image. @item -pad @kindex -pad add 300 KiB of zeros to ISO tree @cindex Padding, 300 KiB, -pad +@* Add 300 KiB to the end of the produced ISO image. This circumvents possible read errors from ISO images which have been written to CD media in TAO mode. The additional bytes are claimed as part of the ISO image if not --emul-toc @@ -603,6 +607,7 @@ this bad habit. @item -U @kindex -U very relaxed filename rules @cindex ISO file names, very relaxed rules, -U, -untranslated-filenames +@* This option allows ISO file names without dot and up to 37 characters, ISO file paths longer than 255 characters, and all ASCII characters in file names. Further it omits the semicolon and the version numbers at the end @@ -633,6 +638,7 @@ This violates ISO 9660 specs. @item -d @kindex -d omit trailing dot in ISO file names @cindex ISO file names, omit trailing dot, -d, -omit-period +@* Do not add trailing dot to ISO file names without dot. @* This violates ISO 9660 specs. @@ -644,6 +650,7 @@ Alias of -d. @item -l @kindex -l allow 37 characters in ISO file names @cindex ISO file names, allow 37 characters, -l, -full-iso9660-filenames, -max-iso9660-filenames +@* Allow up to 37 characters in ISO file names. @* This violates ISO 9660 specs. @@ -659,6 +666,7 @@ Alias of -l. @item -N @kindex -N omit version number in ISO file names @cindex ISO file names, omit version number, -N, -omit-version-number +@* Omit the semicolon and the version numbers at the end of ISO names. @* This violates ISO 9660 specs. @@ -677,16 +685,19 @@ Alias of -N. @item -R @kindex -R Rock Ridge (is always enabled) @cindex Rock Ridge, (always enabled), -R, -rock +@* With mkisofs this option enables Rock Ridge extensions. xorrisofs produces them unconditionally. @c man .TP @item -rock @kindex -rock Rock Ridge (is always enabled) +@* Alias of -R. @c man .TP @item -r @kindex -r Rock Ridge with altered owner and permission @cindex Rock Ridge, altered owner and permission, -r, -rational-rock +@* Set Rock Ridge user and group id of all files in the ISO image to 0. Grant r-permissions to all. Deny all w-permissions. If any x-permission is set, grant x-permission to all. @@ -706,6 +717,7 @@ Enable options which improve backup fidelity: @item @minus{}@minus{}acl @kindex @minus{}@minus{}acl Recording of ACLs @cindex ACL, record and load, @minus{}@minus{}acl +@* Enable recording and loading of GNU/Linux ACLs (see man getfacl, man acl). They will not be in effect with mounted ISO images. But xorriso can restore them when extracting files from the ISO image. @@ -713,6 +725,7 @@ restore them when extracting files from the ISO image. @item @minus{}@minus{}xattr @kindex @minus{}@minus{}xattr Recording of xattr @cindex xattr, record and load, @minus{}@minus{}xattr +@* Enable recording and loading of GNU/Linux extended attributes in user namespace (see man getfattr, man attr). They will not be in effect with mounted ISO images. But xorriso can @@ -721,6 +734,7 @@ restore them when extracting files from the ISO image. @item @minus{}@minus{}md5 @kindex @minus{}@minus{}md5 Recording of MD5 checksums @cindex MD5, record and load, @minus{}@minus{}md5 +@* Enable recording of MD5 checksums for the overall ISO image and for each single data file in the image. xorriso can check the content of an ISO image with these sums and eventually raise alert on mismatch. @@ -755,6 +769,7 @@ Program scdbackup_verify will recognize and verify tag resp. record. @item -J @kindex -J enable production of Joliet directory tree @cindex Joliet, enable, -J, -joliet +@* Enable the production of an additional Joliet directory tree along with the ISO 9660 Rock Ridge tree. @c man .TP @@ -1417,18 +1432,21 @@ files. See section FILES below. @item -help @kindex -help list supported options @cindex Options, list, -help +@* List supported options to stderr. Original mkisofs options bear their original mkisofs description texts. @c man .TP @item -quiet @kindex -quiet suppress most messages @cindex Message output, suppress, -quiet +@* Suppress most messages of the program run, except those which indicate problems or errors. @c man .TP @item -v @kindex -v enable verbous messages @cindex Verbosity, high, -v, -verbose +@* Enable the output of informational program messages. @c man .TP @item -verbose