[groff] 28/35: gropdf(1): Revise "Importing graphics" subsection.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 9fb1a82bfeb5cd2a8d89578f5fbf0948da0ad0ad
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Mon Jun 20 18:10:25 2022 -0500

    gropdf(1): Revise "Importing graphics" subsection.
---
 src/devices/gropdf/gropdf.1.man | 60 +++++++++++++++++++++++------------------
 1 file changed, 34 insertions(+), 26 deletions(-)

diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.1.man
index 2dde504b..ee36eb3e 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -1285,51 +1285,59 @@ see
 .\" ====================================================================
 .
 .I gropdf
-only supports importing other PDF files as graphics.
+supports only the inclusion of other PDF files for inline images.
 .
-But that PDF file may contain any of the graphic formats supported by
-the PDF standard (such as JPEG, PNG, GIF, etc.).
-.
-So any application which outputs PDF can be used as an embedded file
-in
+Such a PDF file may,
+however,
+contain any of the graphic formats supported by
+the PDF standard,
+such as JPEG/JFIF,
+PNG,
+and GIF.
+.
+Any application that outputs PDF can thus be used to prepare files for
+embedding in documents processed by
+.I groff
+and
 .IR gropdf .
 .
+.
+.P
 The PDF file you wish to insert must be a single page and the drawing
 must just fit inside the media size of the PDF file.
 .
-So, in
+In
 .MR inkscape 1
 or
-.MR gimp 1
-(for example) make sure the canvas size just fits the image.
+.MR gimp 1 ,
+for example,
+make sure the canvas size just fits the image.
 .
 .
-.LP
-The PDF parser used in
+.P
+The PDF parser
 .I gropdf
-has not been rigorously tested with all possible applications which
-produce PDFs.
-.
-If you find a single page PDF which fails to import properly, it is
-worth running it through the
+implements has not been rigorously tested with all applications that
+produce PDF.
 .
+If you find a single-page PDF which fails to import properly,
+try processing it with the
 .MR pdftk 1
-program by issuing the command:
+program.
 .
 .
 .RS
-.LP
-.B pdftk
-.I oldfile.pdf
-.B output
-.I newfile.pdf
+.EX
+pdftk\~\c
+.I existing-file\~\c
+output\~\c
+.I new-file
+.EE
 .RE
 .
-.
-.LP
 You may find that
-.I newfile.pdf
-will now load successfully.
+.I new-file
+imports successfully.
 .
 .
 .\" ====================================================================