man page updates

git-svn-id: svn://tug.org/texlive/trunk@70501 c570f23f-e606-0410-a88d-b1316a301751

11 files changed, 9 insertions, 7 deletions

diff --git a/Master/texmf-dist/doc/man/man1/dvisvgm.1 b/Master/texmf-dist/doc/man/man1/dvisvgm.1
index dbcd907ab54..8e6814b7e6f 100644
--- a/Master/texmf-dist/doc/man/man1/dvisvgm.1
+++ b/Master/texmf-dist/doc/man/man1/dvisvgm.1
@@ -2,12 +2,12 @@
 .\"     Title: dvisvgm
 .\"    Author: Martin Gieseking <martin.gieseking@uos.de>
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 2024-01-06
+.\"      Date: 2024-02-04
 .\"    Manual: dvisvgm Manual
-.\"    Source: dvisvgm 3.2
+.\"    Source: dvisvgm 3.2.2
 .\"  Language: English
 .\"
-.TH "DVISVGM" "1" "2024\-01\-06" "dvisvgm 3\&.2" "dvisvgm Manual"
+.TH "DVISVGM" "1" "2024\-02\-04" "dvisvgm 3\&.2\&.2" "dvisvgm Manual"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -28,7 +28,7 @@
 .\" * MAIN CONTENT STARTS HERE *
 .\" -----------------------------------------------------------------
 .SH "NAME"
-dvisvgm \- converts DVI and EPS files to the XML\-based SVG format
+dvisvgm \- converts DVI, EPS, and PDF files to the XML\-based SVG format
 .SH "SYNOPSIS"
 .sp
 \fBdvisvgm\fR [\fIoptions\fR] \fIfile\fR[\&.dvi]
@@ -1283,9 +1283,11 @@ attributes are omitted\&.
 .RE
 .SH "SUPPORTED SPECIALS"
 .sp
-dvisvgm supports several \fIspecial commands\fR that enrich the DVI command set with additional instructions for features, like color, graphics, and hyperlinks\&. The term \fIspecial command\fR, or just \fIspecial\fR, originates from the TeX command \fB\especial{\&...}\fR which does almost nothing\&. TeX only forwards the whole command to the DVI file and delegates its execution to the DVI driver\&. The DVI driver can then decide to either process or ignore it, depending on the supported statements\&. The parameter of TeX\(cqs \fB\especial\fR command is given in curly braces and may consist of an arbitrary character sequence representing the actual instruction, for example \fBcolor Red\fR\&.
+dvisvgm supports several \fIspecial commands\fR that enrich the DVI command set with additional instructions for features, like color, graphics, and hyperlinks\&. The term \fIspecial command\fR, or just \fIspecial\fR, originates from the TeX command \fB\especial{\&...}\fR which does almost nothing\&. TeX only forwards the argument of this command to the DVI file using the corresponding \fIxxx\fR opcode, thus delegating its execution to the DVI driver\&. The driver can then decide to either process or ignore it, depending on the supported statements\&. The parameter of TeX\(cqs \fB\especial\fR command is given in curly braces and may consist of an arbitrary character sequence representing the actual instruction, for example \fBcolor Red\fR\&.
 .sp
-dvisvgm delegates the evaluation of special commands to dedicated handlers\&. Each handler is responsible for all special statements of the same command set, i\&.e\&. commands usually \(en but not necessarily \(en beginning with a common prefix\&. For example, all PDF specials start with the prefix \fBpdf:\fR, while the TPIC special set consists of 13 different commands without common identifier\&. The PDF specials are processed by dvisvgm\(cqs \fIpdf\fR handler, the TPIC ones by the \fItpic\fR handler\&. To get a list of the actually provided special handlers, use option \fB\-\-list\-specials\fR (see above)\&. The following list gives an overview of the special sets currently supported\&. The names of the handlers can also be used to disable the processing of individual sets of specials\&. For further information on this, see option \fB\-\-no\-specials\fR\&.
+It might be worth mentioning that specials are only evaluated when processing DVI files\&. PS/EPS and PDF don\(cqt know anything about the concept of specials and therefore don\(cqt provide means to represent them\&.
+.sp
+In order to evaluate the special commands, dvisvgm implements several dedicated handlers\&. Each handler is responsible for all special statements belonging to the same command set, i\&.e\&. commands usually \(en but not necessarily \(en beginning with a common prefix\&. For example, all PDF specials start with the prefix \fBpdf:\fR, while the TPIC special set consists of 13 different commands without common identifier\&. The PDF specials are processed by dvisvgm\(cqs \fIpdf\fR handler, the TPIC ones by the \fItpic\fR handler\&. To get a list of the actually provided special handlers, use option \fB\-\-list\-specials\fR (see above)\&. The following list gives an overview of the special sets currently supported\&. The names of the handlers can also be used to disable the processing of individual sets of specials\&. For further information on this, see option \fB\-\-no\-specials\fR\&.
 .PP
 \fBbgcolor\fR
 .RS 4
@@ -1302,7 +1304,7 @@ Statements of this command set provide instructions to change the text/paint col
 .PP
 \fBdvisvgm\fR
 .RS 4
-dvisvgm offers its own small set of specials\&. The following list gives a brief overview\&.
+The following list gives a brief overview of dvisvgm\(cqs own set of currently supported specials\&.
 .PP
 \fBdvisvgm:raw\fR \fItext\fR
 .RS 4
diff --git a/Master/texmf-dist/doc/man/man1/dvisvgm.man1.pdf b/Master/texmf-dist/doc/man/man1/dvisvgm.man1.pdf
index a34be9566d1..9ee2518833e 100644
--- a/Master/texmf-dist/doc/man/man1/dvisvgm.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/dvisvgm.man1.pdf
diff --git a/Master/texmf-dist/doc/man/man1/fmtutil-sys.man1.pdf b/Master/texmf-dist/doc/man/man1/fmtutil-sys.man1.pdf
index 3ca677c763b..8f9f5ea57c9 100644
--- a/Master/texmf-dist/doc/man/man1/fmtutil-sys.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/fmtutil-sys.man1.pdf
diff --git a/Master/texmf-dist/doc/man/man1/fmtutil-user.man1.pdf b/Master/texmf-dist/doc/man/man1/fmtutil-user.man1.pdf
index 38f9e850dc5..6c9978e9d72 100644
--- a/Master/texmf-dist/doc/man/man1/fmtutil-user.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/fmtutil-user.man1.pdf
diff --git a/Master/texmf-dist/doc/man/man1/fmtutil.man1.pdf b/Master/texmf-dist/doc/man/man1/fmtutil.man1.pdf
index 428309ba560..5eb2b8fdd91 100644
--- a/Master/texmf-dist/doc/man/man1/fmtutil.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/fmtutil.man1.pdf
diff --git a/Master/texmf-dist/doc/man/man1/mktexfmt.man1.pdf b/Master/texmf-dist/doc/man/man1/mktexfmt.man1.pdf
index c313eb6abda..2a0376524b4 100644
--- a/Master/texmf-dist/doc/man/man1/mktexfmt.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/mktexfmt.man1.pdf
diff --git a/Master/texmf-dist/doc/man/man1/pdflatex.man1.pdf b/Master/texmf-dist/doc/man/man1/pdflatex.man1.pdf
index f14f383101b..ebdf25126f1 100644
--- a/Master/texmf-dist/doc/man/man1/pdflatex.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/pdflatex.man1.pdf
diff --git a/Master/texmf-dist/doc/man/man1/pdftex.man1.pdf b/Master/texmf-dist/doc/man/man1/pdftex.man1.pdf
index 4f19e8a0735..dcbdc8d9ba1 100644
--- a/Master/texmf-dist/doc/man/man1/pdftex.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/pdftex.man1.pdf
diff --git a/Master/texmf-dist/doc/man/man1/updmap-sys.man1.pdf b/Master/texmf-dist/doc/man/man1/updmap-sys.man1.pdf
index c515d30f26a..a9c5a6dfaf2 100644
--- a/Master/texmf-dist/doc/man/man1/updmap-sys.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/updmap-sys.man1.pdf
diff --git a/Master/texmf-dist/doc/man/man1/updmap-user.man1.pdf b/Master/texmf-dist/doc/man/man1/updmap-user.man1.pdf
index ec8bca4253d..0d439a00498 100644
--- a/Master/texmf-dist/doc/man/man1/updmap-user.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/updmap-user.man1.pdf
diff --git a/Master/texmf-dist/doc/man/man1/updmap.man1.pdf b/Master/texmf-dist/doc/man/man1/updmap.man1.pdf
index cfba60257f1..b194380ec01 100644
--- a/Master/texmf-dist/doc/man/man1/updmap.man1.pdf
+++ b/Master/texmf-dist/doc/man/man1/updmap.man1.pdf