changeset 29009:6a91e8dd6f7e

maint: merge stable to default.
author Rik <rik@octave.org>
date Fri, 30 Oct 2020 07:56:39 -0700
parents 040aa7a82662 (current diff) 24cb3f34a8c5 (diff)
children 9adb4b5bb946
files scripts/plot/util/print.m
diffstat 1 files changed, 19 insertions(+), 21 deletions(-) [+]
line wrap: on
line diff
--- a/scripts/plot/util/print.m	Fri Oct 30 11:21:49 2020 +0100
+++ b/scripts/plot/util/print.m	Fri Oct 30 07:56:39 2020 -0700
@@ -120,15 +120,15 @@
 ## @itemx -painters
 ##   Specifies whether the opengl (pixel-based) or painters (vector-based)
 ## renderer is used.  This is equivalent to changing the figure's
-## @qcode{"Renderer"} property.  When the figure @code{RendererMode} property
-## is @qcode{"auto"} (the default) Octave will use the @qcode{"opengl"}
-## renderer for raster formats (e.g., JPEG) and @qcode{"painters"} for
-## vector formats (e.g., PDF).  Those options are only supported for the "qt"
-## graphics toolkit.
+## @qcode{"Renderer"} property.  When the figure @qcode{"RendererMode"}
+## property is @qcode{"auto"} (the default) Octave will use the
+## @qcode{"opengl"} renderer for raster formats (e.g., JPEG) and
+## @qcode{"painters"} for vector formats (e.g., PDF).  Those options are only
+## supported for the "qt" graphics toolkit.
 ##
 ## @item -svgconvert
-##   When using the -painters renderer, this enables a different backend
-## toolchain with enhanced characteristics:
+##   When using the @option{-painters} renderer, this enables a different
+## backend toolchain with enhanced characteristics:
 ##
 ## @table @asis
 ## @item Font handling:
@@ -136,11 +136,10 @@
 ## arbitrary characters and fonts in all vector formats.
 ##
 ## @item Output Simplification:
-## By default, the @option{-painters} renders patch and surface objects
-## using assemblies of triangles.  This may lead to anti-aliasing
-## artifacts when viewing the file.  The @option{-svgconvert} option
-## reconstructs polygons in order to avoid those artifacts (particularly for
-## 2-D figures).
+## By default, the option @option{-painters} renders patch and surface objects
+## using assemblies of triangles.  This may lead to anti-aliasing artifacts
+## when viewing the file.  The @option{-svgconvert} option reconstructs
+## polygons in order to avoid those artifacts (particularly for 2-D figures).
 ##
 ## @item Transparency:
 ## Allows for printing transparent graphics objects in PDF format.
@@ -200,9 +199,9 @@
 ##
 ## @item -S@var{xsize},@var{ysize}
 ##   Plot size in pixels for raster formats including PNG, JPEG, PNG, and
-## (unusually (SVG))@.  For all vector formats, including PDF, PS, and EPS, the
-## plot size is specified in points.  This option is equivalent to changing the
-## width and height of the output by setting the figure property
+## @emph{unusually} SVG@.  For all vector formats, including PDF, PS, and EPS,
+## the plot size is specified in points.  This option is equivalent to changing
+## the width and height of the output by setting the figure property
 ## @code{paperposition(3:4)}.  When using the command form of the print
 ## function you must quote the @var{xsize},@var{ysize} option to prevent the
 ## Octave interpreter from recognizing the embedded comma (',').  For example,
@@ -310,8 +309,8 @@
 ##   @itemx pdfcairolatex*
 ##   @itemx epscairolatexstandalone*
 ##   @itemx pdfcairolatexstandalone*
-##     Generate output with Cairo renderer.  The devices @samp{epscairo} and
-## @samp{pdfcairo} are synonymous with the @samp{epsc} device.  The @LaTeX{}
+##     Generate output with Cairo renderer.  The devices @code{epscairo} and
+## @code{pdfcairo} are synonymous with the @code{epsc} device.  The @LaTeX{}
 ## variants generate a @LaTeX{} file, @file{@var{filename}.tex}, for the text
 ## portions of a plot, and an image file, @file{@var{filename}.(eps|pdf)}, for
 ## the graph portion of the plot.  The @samp{standalone} variants behave as
@@ -326,9 +325,8 @@
 ##
 ##   @item fig
 ##     XFig.  For the Gnuplot graphics toolkit, the additional options
-## @option{-textspecial} or @option{-textnormal} can be used to control
-## whether the special flag should be set for the text in the figure.
-## (default is @option{-textnormal})
+## @option{-textspecial} or @option{-textnormal} (default) can be used to
+## control whether the special flag should be set for the text in the figure.
 ##
 ##   @item  latex*
 ##   @itemx eepic*
@@ -389,7 +387,7 @@
 ##   @end table
 ##
 ##   For a complete list of available formats and devices type
-## @code{system ("gs -h")}.
+## @kbd{system ("gs -h")}.
 ##
 ##   When Ghostscript output is sent to a printer the size is determined by
 ## the figure's @qcode{"papersize"} property.  When the output is sent to a