manpage: added information about unsupported PDF specials

Author: mgieseki

doc/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: 2025-01-04
+.\"      Date: 2025-01-21
 .\"    Manual: dvisvgm Manual
 .\"    Source: dvisvgm 3.4.3
 .\"  Language: English
 .\"
-.TH "DVISVGM" "1" "2025\-01\-04" "dvisvgm 3\&.4\&.3" "dvisvgm Manual"
+.TH "DVISVGM" "1" "2025\-01\-21" "dvisvgm 3\&.4\&.3" "dvisvgm Manual"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -947,7 +947,7 @@ If this option is given, dvisvgm does not expect a DVI but a PDF input file, and
 \fB\-\-page\fR
 can be used to select different pages, page ranges, and/or page sequences\&.
 .sp
-If a Ghostcript version < 10\&.01\&.0 is found, dvisvgm uses Ghostscript to process the PDF file\&. In this case, the conversion is realized by creating a single
+If a Ghostscript version < 10\&.01\&.0 is found, dvisvgm uses Ghostscript to process the PDF file\&. In this case, the conversion is realized by creating a single
 \fIpdffile\fR
 special command which is forwarded to dvisvgm\(cqs PostScript special handler\&. Therefore, this option is only available if dvisvgm was built with PostScript support enabled, and requires Ghostscript to be accessible\&. See option
 \fB\-\-libgs\fR
@@ -1423,7 +1423,7 @@ and
 \fIy\fR
 represent the current coordinates\&. Invalid operations, like divisions by zero, lead to an error message on the console\&. Example:
 \fB{?(\-10*(x+2y)\-5)}\fR
-is a valid expresssion and expands to the corresponding numeric string\&.
+is a valid expression and expands to the corresponding numeric string\&.
 .RE
 .PP
 \fBdvisvgm:rawdef\fR \fItext\fR
@@ -1638,7 +1638,7 @@ on the command\-line\&. Otherwise, dvisvgm ignores them and computes tight bound
 pdfTeX and dvipdfmx introduced several special commands related to the generation of PDF files\&. Currently, only
 \fIpdf:mapfile\fR,
 \fIpdf:mapline\fR,
-\fIpdf:pagesize\fR, and PDF hyperlink specials are supported by dvisvgm\&. The latter are the PDF pendants to the HTML HyperTeX specials generated by the hyperref package in PDF mode\&.
+\fIpdf:pagesize\fR, and PDF hyperlink specials are supported by dvisvgm\&. The latter are the PDF pendants to the HTML HyperTeX specials\&. They are generated by the hyperref package in PDF mode, for example\&. If a DVI page contains unsupported PDF specials, dvisvgm prints a warning message showing the number of ignored special commands\&.
 .sp
 \fIpdf:pagesize\fR
 is similar to the
@@ -1660,7 +1660,7 @@ pdfTeX user manual (\m[blue]https://ctan.org/pkg/pdftex\m[])\&.
 .RS 4
 The famous DVI driver
 \fIdvips\fR (\m[blue]https://www.tug.org/texinfohtml/dvips.html\m[])
-introduced its own set of specials in order to embed PostScript code into DVI files, which greatly improves the capabilities of DVI documents\&. One aim of dvisvgm is to completely evaluate all PostScript fragments and to convert as many of them as possible to SVG\&. In contrast to dvips, dvisvgm uses floating point arithmetics to compute the precise position of each graphic element, i\&.e\&. it doesn\(cqt round the coordinates\&. Therefore, the relative locations of the graphic elements may slightly differ from those computed by dvips\&.
+introduced its own set of specials in order to embed PostScript code into DVI files, which greatly improves the capabilities of DVI documents\&. One aim of dvisvgm is to completely evaluate all PostScript fragments and to convert as many of them as possible to SVG\&. In contrast to dvips, dvisvgm uses floating point arithmetic to compute the precise position of each graphic element, i\&.e\&. it doesn\(cqt round the coordinates\&. Therefore, the relative locations of the graphic elements may slightly differ from those computed by dvips\&.
 .sp
 Since PostScript is a rather complex language, dvisvgm does not implement its own PostScript interpreter but relies on
 Ghostscript (\m[blue]https://ghostscript.com\m[])

doc/dvisvgm.txt.in

@@ -22,7 +22,7 @@ Martin Gieseking <@PACKAGE_BUGREPORT@>
 :man source: dvisvgm
 :man version: @VERSION@
 :man manual: dvisvgm Manual
-:revdate: 2025-01-04 12:28 +0100
+:revdate: 2025-01-21 19:13 +0100
 
 Name
 ----
@@ -1013,7 +1013,10 @@ the command-line. Otherwise, dvisvgm ignores them and computes tight bounding bo
 *pdf*::
 pdfTeX and dvipdfmx introduced several special commands related to the generation of PDF files. Currently,
 only 'pdf:mapfile', 'pdf:mapline', 'pdf:pagesize', and PDF hyperlink specials are supported by dvisvgm.
-The latter are the PDF pendants to the HTML HyperTeX specials generated by the hyperref package in PDF mode.
+The latter are the PDF pendants to the HTML HyperTeX specials. They are generated by the hyperref package in
+PDF mode, for example.
+If a DVI page contains unsupported PDF specials, dvisvgm prints a warning message showing the number of
+ignored special commands.
 +
 'pdf:pagesize' is similar to the 'papersize' special (see above) which specifies the size of the current
 and all following pages. In order to actually apply the extents to the generated SVG files,