HTML version of man xorrisofs

This commit is contained in:
Thomas Schmitt 2011-03-10 07:15:51 +00:00
parent c1a24e71f1
commit c8fcb2fb3d
8 changed files with 246 additions and 116 deletions

View File

@ -72,17 +72,15 @@ or you may execute as superuser:
For general concepts, options and usage examples see For general concepts, options and usage examples see
info xorriso info xorriso
or info xorrisofs
man 1 xorriso 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 You may get a first glimpse by
info ./xorriso/xorriso.info info ./xorriso/xorriso.info
info ./xorriso/xorrisofs.info
man ./xorriso/xorriso.1 man ./xorriso/xorriso.1
man ./xorriso/xorrisofs.1
The installation creates several alias links pointing to the xorriso binary: The installation creates several alias links pointing to the xorriso binary:
xorrisofs starts xorriso with -as mkisofs emulation already enabled xorrisofs starts xorriso with -as mkisofs emulation already enabled

View File

@ -1,118 +1,13 @@
#!/bin/sh #!/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/<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>/\&nbsp;<BR><b>Overview of features:<\/b>/' \
-e 's/<b>General information paragraphs:<\/b>/\&nbsp;<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>/\&nbsp;<BR><b>Session model:<\/b>/' \
-e 's/<b>Media types and states:<\/b>/\&nbsp;<BR><b>Media types and states:<\/b>/' \
-e 's/<b>Creating, Growing, Modifying, Blind/\&nbsp;<BR><b>Creating, Growing, Modifying, Blind/' \
-e 's/<b>Libburn drives:<\/b>/\&nbsp;<BR><b>Libburn drives:<\/b>/' \
-e 's/^-dev /\&nbsp;\&nbsp;-dev /' \
-e 's/^-devices /\&nbsp;\&nbsp;-devices /' \
-e 's/<b>Rock Ridge, POSIX, X\/Open, El Torito, ACL,/\&nbsp;<BR><b>Rock Ridge, POSIX, X\/Open, El Torito, ACL,/' \
-e 's/<b>Command processing:<\/b>/\&nbsp;<BR><b>Command processing:<\/b>/' \
-e 's/<b>Dialog, Readline, Result pager:<\/b>/\&nbsp;<BR><b>Dialog, Readline, Result pager:<\/b>/' \
-e 's/<b>Aquiring source and target drive:<\/b>/\&nbsp;<BR><b>Aquiring source and target drive:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Influencing the behavior of image/\&nbsp;<BR><b>Influencing the behavior of image/' \
-e 's/<b>Inserting files into ISO image:<\/b>/\&nbsp;<BR><b>Inserting files into ISO image:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>File manipulations:<\/b>/\&nbsp;<BR><b>File manipulations:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Tree traversal command -find:<\/b>/\&nbsp;<BR><b>Tree traversal command -find:<\/b><BR>\&nbsp;<BR>/' \
-e 's/^<p><b>&minus;iso_rr_pattern/<p>\&nbsp;<BR><b>\&minus;iso_rr_pattern/' \
-e 's/EXAMPLES):<br>/<A HREF="#EXAMPLES">EXAMPLES<\/A>):<br>/' \
-e 's/<b>Filters for data file content:<\/b>/\&nbsp;<BR><b>Filters for data file content:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Writing the result, drive control:<\/b>/\&nbsp;<BR><b>Writing the result, drive control:<\/b><BR>\&nbsp;<BR>/' \
-e 's/^-find \/ /\&nbsp;\&nbsp;-find \/ /' \
-e 's/<b>Settings for file insertion:<\/b>/\&nbsp;<BR><b>Settings for file insertion:<\/b><BR>\&nbsp;<BR>/' \
-e 's/^$<\/b> ln -s/\&nbsp;\&nbsp;$<\/b> ln -s/' \
-e 's/<b>Settings for result writing:<\/b>/\&nbsp;<BR><b>Settings for result writing:<\/b><BR>\&nbsp;<BR>/' \
-e 's/^706k = 706kB/\&nbsp;\&nbsp;706k = 706kB/' \
-e 's/^5540k = 5540kB/\&nbsp;\&nbsp;5540k = 5540kB/' \
-e 's/<b>Character sets:<\/b>/\&nbsp;<BR><b>Character sets:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Exception processing:<\/b>/\&nbsp;<BR><b>Exception processing:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>El Torito bootable ISO images:<\/b>/\&nbsp;<BR><b>El Torito bootable ISO images:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Jigdo Template Extraction:<\/b>/\&nbsp;<BR><b>Jigdo Template Extraction:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Dialog mode control:<\/b>/\&nbsp;<BR><b>Dialog mode control:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Drive and media related inquiry actions:<\/b>/\&nbsp;<BR><b>Drive and media related inquiry actions:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Navigation in ISO image/\&nbsp;<BR><b>Navigation in ISO image/' \
-e 's/^filesystem:<\/b>/filesystem:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Evaluation of readability and recovery:<\/b>/\&nbsp;<BR><b>Evaluation of readability and recovery:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>osirrox ISO-to-disk restore options:<\/b>/\&nbsp;<BR><b>osirrox ISO-to-disk restore options:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Command compatibility emulations:<\/b>/\&nbsp;<BR><b>Command compatibility emulations:<\/b><BR>\&nbsp;<BR>/' \
-e 's/^<p><b>&minus;as</<p>\&nbsp;<BR><b>\&minus;as</' \
-e 's/<b>Scripting, dialog and/\&nbsp;<BR><b>Scripting, dialog and/' \
-e 's/^features:<\/b>/features:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Support for frontend/\&nbsp;<BR><b>Support for frontend/' \
-e 's/^listening at stdout:<\/b>/listening at stdout:<\/b><BR>\&nbsp;<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 \\ \&rsquo;\/pictures\/\*private\*\&rsquo; \\/\/sounds\/indecent \&rsquo;\/pictures\/*private*\&rsquo; /' \
-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

View File

@ -198,6 +198,7 @@ copy_files \
xorriso/xorriso.1 \ xorriso/xorriso.1 \
xorriso/xorrisofs.1 \ xorriso/xorrisofs.1 \
xorriso/man_1_xorriso.html \ xorriso/man_1_xorriso.html \
xorriso/man_1_xorrisofs.html \
"$lone_dir"/xorriso "$lone_dir"/xorriso
copy_files COPYRIGHT "$lone_dir"/xorriso copy_files COPYRIGHT "$lone_dir"/xorriso

118
xorriso/man_xorriso_to_html.sh Executable file
View File

@ -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>/\&nbsp;<BR><b>Overview of features:<\/b>/' \
-e 's/<b>General information paragraphs:<\/b>/\&nbsp;<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>/\&nbsp;<BR><b>Session model:<\/b>/' \
-e 's/<b>Media types and states:<\/b>/\&nbsp;<BR><b>Media types and states:<\/b>/' \
-e 's/<b>Creating, Growing, Modifying, Blind/\&nbsp;<BR><b>Creating, Growing, Modifying, Blind/' \
-e 's/<b>Libburn drives:<\/b>/\&nbsp;<BR><b>Libburn drives:<\/b>/' \
-e 's/^-dev /\&nbsp;\&nbsp;-dev /' \
-e 's/^-devices /\&nbsp;\&nbsp;-devices /' \
-e 's/<b>Rock Ridge, POSIX, X\/Open, El Torito, ACL,/\&nbsp;<BR><b>Rock Ridge, POSIX, X\/Open, El Torito, ACL,/' \
-e 's/<b>Command processing:<\/b>/\&nbsp;<BR><b>Command processing:<\/b>/' \
-e 's/<b>Dialog, Readline, Result pager:<\/b>/\&nbsp;<BR><b>Dialog, Readline, Result pager:<\/b>/' \
-e 's/<b>Aquiring source and target drive:<\/b>/\&nbsp;<BR><b>Aquiring source and target drive:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Influencing the behavior of image/\&nbsp;<BR><b>Influencing the behavior of image/' \
-e 's/<b>Inserting files into ISO image:<\/b>/\&nbsp;<BR><b>Inserting files into ISO image:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>File manipulations:<\/b>/\&nbsp;<BR><b>File manipulations:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Tree traversal command -find:<\/b>/\&nbsp;<BR><b>Tree traversal command -find:<\/b><BR>\&nbsp;<BR>/' \
-e 's/^<p><b>&minus;iso_rr_pattern/<p>\&nbsp;<BR><b>\&minus;iso_rr_pattern/' \
-e 's/EXAMPLES):<br>/<A HREF="#EXAMPLES">EXAMPLES<\/A>):<br>/' \
-e 's/<b>Filters for data file content:<\/b>/\&nbsp;<BR><b>Filters for data file content:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Writing the result, drive control:<\/b>/\&nbsp;<BR><b>Writing the result, drive control:<\/b><BR>\&nbsp;<BR>/' \
-e 's/^-find \/ /\&nbsp;\&nbsp;-find \/ /' \
-e 's/<b>Settings for file insertion:<\/b>/\&nbsp;<BR><b>Settings for file insertion:<\/b><BR>\&nbsp;<BR>/' \
-e 's/^$<\/b> ln -s/\&nbsp;\&nbsp;$<\/b> ln -s/' \
-e 's/<b>Settings for result writing:<\/b>/\&nbsp;<BR><b>Settings for result writing:<\/b><BR>\&nbsp;<BR>/' \
-e 's/^706k = 706kB/\&nbsp;\&nbsp;706k = 706kB/' \
-e 's/^5540k = 5540kB/\&nbsp;\&nbsp;5540k = 5540kB/' \
-e 's/<b>Character sets:<\/b>/\&nbsp;<BR><b>Character sets:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Exception processing:<\/b>/\&nbsp;<BR><b>Exception processing:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>El Torito bootable ISO images:<\/b>/\&nbsp;<BR><b>El Torito bootable ISO images:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Jigdo Template Extraction:<\/b>/\&nbsp;<BR><b>Jigdo Template Extraction:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Dialog mode control:<\/b>/\&nbsp;<BR><b>Dialog mode control:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Drive and media related inquiry actions:<\/b>/\&nbsp;<BR><b>Drive and media related inquiry actions:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Navigation in ISO image/\&nbsp;<BR><b>Navigation in ISO image/' \
-e 's/^filesystem:<\/b>/filesystem:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Evaluation of readability and recovery:<\/b>/\&nbsp;<BR><b>Evaluation of readability and recovery:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>osirrox ISO-to-disk restore options:<\/b>/\&nbsp;<BR><b>osirrox ISO-to-disk restore options:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Command compatibility emulations:<\/b>/\&nbsp;<BR><b>Command compatibility emulations:<\/b><BR>\&nbsp;<BR>/' \
-e 's/^<p><b>&minus;as</<p>\&nbsp;<BR><b>\&minus;as</' \
-e 's/<b>Scripting, dialog and/\&nbsp;<BR><b>Scripting, dialog and/' \
-e 's/^features:<\/b>/features:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Support for frontend/\&nbsp;<BR><b>Support for frontend/' \
-e 's/^listening at stdout:<\/b>/listening at stdout:<\/b><BR>\&nbsp;<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 \\ \&rsquo;\/pictures\/\*private\*\&rsquo; \\/\/sounds\/indecent \&rsquo;\/pictures\/*private*\&rsquo; /' \
-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

View File

@ -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>/\&nbsp;<BR><b>ISO 9660, Rock Ridge, Joliet:<\/b>/' \
-e 's/<b>Inserting files into the ISO image:<\/b>/\&nbsp;<BR><b>Inserting files into the ISO image:<\/b>/' \
-e 's/<b>Relation to program xorriso:<\/b>/\&nbsp;<BR><b>Relation to program xorriso:<\/b>/' \
-e 's/EXAMPLES):<br>/<A HREF="#EXAMPLES">EXAMPLES<\/A>):<br>/' \
-e 's/<b>Image loading:<\/b>/\&nbsp;<BR><b>Image loading:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Settings for file insertion:<\/b>/\&nbsp;<BR><b>Settings for file insertion:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Settings for image production:<\/b>/\&nbsp;<BR><b>Settings for image production:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Settings for standards compliance:<\/b>/\&nbsp;<BR><b>Settings for standards compliance:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Settings for standards extensions:<\/b>/\&nbsp;<BR><b>Settings for standards extensions:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Settings for file hiding:<\/b>/\&nbsp;<BR><b>Settings for file hiding:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>ISO image ID strings:<\/b>/\&nbsp;<BR><b>ISO image ID strings:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>El Torito Bootable ISO images:<\/b>/\&nbsp;<BR><b>El Torito Bootable ISO images:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>System Area, MBR, other boot blocks:<\/b>/\&nbsp;<BR><b>System Area, MBR, other boot blocks:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Character sets:<\/b>/\&nbsp;<BR><b>Character sets:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Jigdo Template Extraction:<\/b>/\&nbsp;<BR><b>Jigdo Template Extraction:<\/b><BR>\&nbsp;<BR>/' \
-e 's/<b>Miscellaneous options:<\/b>/\&nbsp;<BR><b>Miscellaneous options:<\/b><BR>\&nbsp;<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

View File

@ -607,6 +607,8 @@ cdrecord and mkisofs.</DT>
</LI> </LI>
<LI>isohybrid image size was not aligned to cylinder boundary <LI>isohybrid image size was not aligned to cylinder boundary
</LI> </LI>
<LI>Compilation without zlib failed
</LI>
<!-- <!--
<LI>- none yet -</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="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="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_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>&nbsp;</DD> <DD>&nbsp;</DD>
<DT>If you want to distribute development versions of xorriso, then use <DT>If you want to distribute development versions of xorriso, then use
this tarball which produces static linking between xorriso and the this tarball which produces static linking between xorriso and the

View File

@ -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. quotations or an open quotation cause the next input line to be appended.
.TP .TP
\fB\-f\fR \fB\-f\fR
.br
Resolve symbolic links on disk rather than storing them as symbolic Resolve symbolic links on disk rather than storing them as symbolic
links in the ISO image. links in the ISO image.
.TP .TP
@ -233,6 +234,7 @@ It is possible to give more than one -m option.
Alias of -m. Alias of -m.
.TP .TP
\fB\-x\fR \fB\-x\fR
.br
Alias of -m. Alias of -m.
.TP .TP
\fB\-old-exclude\fR \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. Perform -m using each line out of file disk_path as argument disk_pattern.
.TP .TP
\fB\-z\fR \fB\-z\fR
.br
Enable recognition and proper processing of zisofs compressed files Enable recognition and proper processing of zisofs compressed files
as produced by program mkzftree. These files will get equipped with the as produced by program mkzftree. These files will get equipped with the
necessary meta data so that a Linux kernel will recognize them and 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. Like -dir-mode but for all regular data files in the image.
.TP .TP
\fB\-pad\fR \fB\-pad\fR
.br
Add 300 KiB to the end of the produced ISO image. This circumvents possible 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. 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 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. this bad habit.
.TP .TP
\fB\-U\fR \fB\-U\fR
.br
This option allows ISO file names without dot and up to 37 characters, 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 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 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. This violates ISO 9660 specs.
.TP .TP
\fB\-d\fR \fB\-d\fR
.br
Do not add trailing dot to ISO file names without dot. Do not add trailing dot to ISO file names without dot.
.br .br
This violates ISO 9660 specs. This violates ISO 9660 specs.
@ -436,6 +442,7 @@ This violates ISO 9660 specs.
Alias of -d. Alias of -d.
.TP .TP
\fB\-l\fR \fB\-l\fR
.br
Allow up to 37 characters in ISO file names. Allow up to 37 characters in ISO file names.
.br .br
This violates ISO 9660 specs. This violates ISO 9660 specs.
@ -447,6 +454,7 @@ Alias of -l.
Alias of -l. Alias of -l.
.TP .TP
\fB\-N\fR \fB\-N\fR
.br
Omit the semicolon and the version numbers at the end of ISO names. Omit the semicolon and the version numbers at the end of ISO names.
.br .br
This violates ISO 9660 specs. This violates ISO 9660 specs.
@ -457,13 +465,16 @@ Alias of -N.
.B Settings for standards extensions: .B Settings for standards extensions:
.TP .TP
\fB\-R\fR \fB\-R\fR
.br
With mkisofs this option enables Rock Ridge extensions. xorrisofs produces With mkisofs this option enables Rock Ridge extensions. xorrisofs produces
them unconditionally. them unconditionally.
.TP .TP
\fB\-rock\fR \fB\-rock\fR
.br
Alias of -R. Alias of -R.
.TP .TP
\fB\-r\fR \fB\-r\fR
.br
Set Rock Ridge user and group id of all files in the ISO image to 0. 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. Grant r-permissions to all. Deny all w-permissions.
If any x-permission is set, grant x-permission to all. If any x-permission is set, grant x-permission to all.
@ -478,17 +489,20 @@ Enable options which improve backup fidelity:
--hardlinks. --hardlinks.
.TP .TP
\fB--acl\fR \fB--acl\fR
.br
Enable recording and loading of GNU/Linux ACLs (see man getfacl, man 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 They will not be in effect with mounted ISO images. But xorriso can
restore them when extracting files from the ISO image. restore them when extracting files from the ISO image.
.TP .TP
\fB--xattr\fR \fB--xattr\fR
.br
Enable recording and loading of GNU/Linux extended attributes in Enable recording and loading of GNU/Linux extended attributes in
user namespace (see man getfattr, man attr). user namespace (see man getfattr, man attr).
They will not be in effect with mounted ISO images. But xorriso can They will not be in effect with mounted ISO images. But xorriso can
restore them when extracting files from the ISO image. restore them when extracting files from the ISO image.
.TP .TP
\fB--md5\fR \fB--md5\fR
.br
Enable recording of MD5 checksums for the overall ISO image and for each 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 single data file in the image. xorriso can check the content of an ISO
image with these sums and eventually raise alert on mismatch. 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. Program scdbackup_verify will recognize and verify tag resp. record.
.TP .TP
\fB\-J\fR \fB\-J\fR
.br
Enable the production of an additional Joliet directory tree along Enable the production of an additional Joliet directory tree along
with the ISO 9660 Rock Ridge tree. with the ISO 9660 Rock Ridge tree.
.TP .TP
@ -1020,14 +1035,17 @@ prevents reading and interpretation of eventual startup
files. See section FILES below. files. See section FILES below.
.TP .TP
\fB\-help\fR \fB\-help\fR
.br
List supported options to stderr. Original mkisofs options bear their List supported options to stderr. Original mkisofs options bear their
original mkisofs description texts. original mkisofs description texts.
.TP .TP
\fB\-quiet\fR \fB\-quiet\fR
.br
Suppress most messages of the program run, except those which indicate Suppress most messages of the program run, except those which indicate
problems or errors. problems or errors.
.TP .TP
\fB\-v\fR \fB\-v\fR
.br
Enable the output of informational program messages. Enable the output of informational program messages.
.TP .TP
\fB\-verbose\fR \fB\-verbose\fR

View File

@ -347,6 +347,7 @@ quotations or an open quotation cause the next input line to be appended.
@item -f @item -f
@kindex -f follow symbolic links on disk @kindex -f follow symbolic links on disk
@cindex Links, follow on disk, -f, -follow-links @cindex Links, follow on disk, -f, -follow-links
@*
Resolve symbolic links on disk rather than storing them as symbolic Resolve symbolic links on disk rather than storing them as symbolic
links in the ISO image. links in the ISO image.
@c man .TP @c man .TP
@ -376,6 +377,7 @@ Alias of -m.
@c man .TP @c man .TP
@item -x @item -x
@kindex -x exclude disk files from inserting @kindex -x exclude disk files from inserting
@*
Alias of -m. Alias of -m.
@c man .TP @c man .TP
@item -old-exclude @item -old-exclude
@ -390,6 +392,7 @@ Perform -m using each line out of file disk_path as argument disk_pattern.
@item -z @item -z
@kindex -z enable recognition of zisofs files @kindex -z enable recognition of zisofs files
@cindex zisofs file, enable recognition, -z, -transparent-compression @cindex zisofs file, enable recognition, -z, -transparent-compression
@*
Enable recognition and proper processing of zisofs compressed files Enable recognition and proper processing of zisofs compressed files
as produced by program mkzftree. These files will get equipped with the as produced by program mkzftree. These files will get equipped with the
necessary meta data so that a Linux kernel will recognize them and 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 @item -pad
@kindex -pad add 300 KiB of zeros to ISO tree @kindex -pad add 300 KiB of zeros to ISO tree
@cindex Padding, 300 KiB, -pad @cindex Padding, 300 KiB, -pad
@*
Add 300 KiB to the end of the produced ISO image. This circumvents possible 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. 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 The additional bytes are claimed as part of the ISO image if not --emul-toc
@ -603,6 +607,7 @@ this bad habit.
@item -U @item -U
@kindex -U very relaxed filename rules @kindex -U very relaxed filename rules
@cindex ISO file names, very relaxed rules, -U, -untranslated-filenames @cindex ISO file names, very relaxed rules, -U, -untranslated-filenames
@*
This option allows ISO file names without dot and up to 37 characters, 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 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 names. Further it omits the semicolon and the version numbers at the end
@ -633,6 +638,7 @@ This violates ISO 9660 specs.
@item -d @item -d
@kindex -d omit trailing dot in ISO file names @kindex -d omit trailing dot in ISO file names
@cindex ISO file names, omit trailing dot, -d, -omit-period @cindex ISO file names, omit trailing dot, -d, -omit-period
@*
Do not add trailing dot to ISO file names without dot. Do not add trailing dot to ISO file names without dot.
@* @*
This violates ISO 9660 specs. This violates ISO 9660 specs.
@ -644,6 +650,7 @@ Alias of -d.
@item -l @item -l
@kindex -l allow 37 characters in ISO file names @kindex -l allow 37 characters in ISO file names
@cindex ISO file names, allow 37 characters, -l, -full-iso9660-filenames, -max-iso9660-filenames @cindex ISO file names, allow 37 characters, -l, -full-iso9660-filenames, -max-iso9660-filenames
@*
Allow up to 37 characters in ISO file names. Allow up to 37 characters in ISO file names.
@* @*
This violates ISO 9660 specs. This violates ISO 9660 specs.
@ -659,6 +666,7 @@ Alias of -l.
@item -N @item -N
@kindex -N omit version number in ISO file names @kindex -N omit version number in ISO file names
@cindex ISO file names, omit version number, -N, -omit-version-number @cindex ISO file names, omit version number, -N, -omit-version-number
@*
Omit the semicolon and the version numbers at the end of ISO names. Omit the semicolon and the version numbers at the end of ISO names.
@* @*
This violates ISO 9660 specs. This violates ISO 9660 specs.
@ -677,16 +685,19 @@ Alias of -N.
@item -R @item -R
@kindex -R Rock Ridge (is always enabled) @kindex -R Rock Ridge (is always enabled)
@cindex Rock Ridge, (always enabled), -R, -rock @cindex Rock Ridge, (always enabled), -R, -rock
@*
With mkisofs this option enables Rock Ridge extensions. xorrisofs produces With mkisofs this option enables Rock Ridge extensions. xorrisofs produces
them unconditionally. them unconditionally.
@c man .TP @c man .TP
@item -rock @item -rock
@kindex -rock Rock Ridge (is always enabled) @kindex -rock Rock Ridge (is always enabled)
@*
Alias of -R. Alias of -R.
@c man .TP @c man .TP
@item -r @item -r
@kindex -r Rock Ridge with altered owner and permission @kindex -r Rock Ridge with altered owner and permission
@cindex Rock Ridge, altered owner and permission, -r, -rational-rock @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. 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. Grant r-permissions to all. Deny all w-permissions.
If any x-permission is set, grant x-permission to all. 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 @item @minus{}@minus{}acl
@kindex @minus{}@minus{}acl Recording of ACLs @kindex @minus{}@minus{}acl Recording of ACLs
@cindex ACL, record and load, @minus{}@minus{}acl @cindex ACL, record and load, @minus{}@minus{}acl
@*
Enable recording and loading of GNU/Linux ACLs (see man getfacl, man 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 They will not be in effect with mounted ISO images. But xorriso can
restore them when extracting files from the ISO image. 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 @item @minus{}@minus{}xattr
@kindex @minus{}@minus{}xattr Recording of xattr @kindex @minus{}@minus{}xattr Recording of xattr
@cindex xattr, record and load, @minus{}@minus{}xattr @cindex xattr, record and load, @minus{}@minus{}xattr
@*
Enable recording and loading of GNU/Linux extended attributes in Enable recording and loading of GNU/Linux extended attributes in
user namespace (see man getfattr, man attr). user namespace (see man getfattr, man attr).
They will not be in effect with mounted ISO images. But xorriso can 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 @item @minus{}@minus{}md5
@kindex @minus{}@minus{}md5 Recording of MD5 checksums @kindex @minus{}@minus{}md5 Recording of MD5 checksums
@cindex MD5, record and load, @minus{}@minus{}md5 @cindex MD5, record and load, @minus{}@minus{}md5
@*
Enable recording of MD5 checksums for the overall ISO image and for each 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 single data file in the image. xorriso can check the content of an ISO
image with these sums and eventually raise alert on mismatch. 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 @item -J
@kindex -J enable production of Joliet directory tree @kindex -J enable production of Joliet directory tree
@cindex Joliet, enable, -J, -joliet @cindex Joliet, enable, -J, -joliet
@*
Enable the production of an additional Joliet directory tree along Enable the production of an additional Joliet directory tree along
with the ISO 9660 Rock Ridge tree. with the ISO 9660 Rock Ridge tree.
@c man .TP @c man .TP
@ -1417,18 +1432,21 @@ files. See section FILES below.
@item -help @item -help
@kindex -help list supported options @kindex -help list supported options
@cindex Options, list, -help @cindex Options, list, -help
@*
List supported options to stderr. Original mkisofs options bear their List supported options to stderr. Original mkisofs options bear their
original mkisofs description texts. original mkisofs description texts.
@c man .TP @c man .TP
@item -quiet @item -quiet
@kindex -quiet suppress most messages @kindex -quiet suppress most messages
@cindex Message output, suppress, -quiet @cindex Message output, suppress, -quiet
@*
Suppress most messages of the program run, except those which indicate Suppress most messages of the program run, except those which indicate
problems or errors. problems or errors.
@c man .TP @c man .TP
@item -v @item -v
@kindex -v enable verbous messages @kindex -v enable verbous messages
@cindex Verbosity, high, -v, -verbose @cindex Verbosity, high, -v, -verbose
@*
Enable the output of informational program messages. Enable the output of informational program messages.
@c man .TP @c man .TP
@item -verbose @item -verbose