summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2024-03-08 17:09:58 +0000
committerKarl Berry <karl@freefriends.org>2024-03-08 17:09:58 +0000
commit94b3301253d3ac34272410534c56892d2c357be8 (patch)
treee719bf4417f3dade882cda228cb1895b0558e40f
parentd3a13bf620d74e3d4b7f83d03f03c73403fab6d6 (diff)
man page updates
git-svn-id: svn://tug.org/texlive/trunk@70501 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Master/texmf-dist/doc/man/man1/dvisvgm.116
-rw-r--r--Master/texmf-dist/doc/man/man1/dvisvgm.man1.pdfbin102693 -> 103019 bytes
-rw-r--r--Master/texmf-dist/doc/man/man1/fmtutil-sys.man1.pdfbin33368 -> 34345 bytes
-rw-r--r--Master/texmf-dist/doc/man/man1/fmtutil-user.man1.pdfbin33368 -> 34345 bytes
-rw-r--r--Master/texmf-dist/doc/man/man1/fmtutil.man1.pdfbin33368 -> 34345 bytes
-rw-r--r--Master/texmf-dist/doc/man/man1/mktexfmt.man1.pdfbin33368 -> 34345 bytes
-rw-r--r--Master/texmf-dist/doc/man/man1/pdflatex.man1.pdfbin39385 -> 39522 bytes
-rw-r--r--Master/texmf-dist/doc/man/man1/pdftex.man1.pdfbin39385 -> 39522 bytes
-rw-r--r--Master/texmf-dist/doc/man/man1/updmap-sys.man1.pdfbin41463 -> 41464 bytes
-rw-r--r--Master/texmf-dist/doc/man/man1/updmap-user.man1.pdfbin41463 -> 41464 bytes
-rw-r--r--Master/texmf-dist/doc/man/man1/updmap.man1.pdfbin41463 -> 41464 bytes
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
Binary files differ
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
Binary files differ
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
Binary files differ
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
Binary files differ
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
Binary files differ
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
Binary files differ
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
Binary files differ
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
Binary files differ
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
Binary files differ
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
Binary files differ