Add Changes entry for -dstrokeadjust and "Usage" entry.

(cherry picked from commit 21142318024c3abac5a13adaf32233cc741683cb)

diff --git a/Documentation/changes.tely b/Documentation/changes.tely
index 0815787d3c127a1c2572f5041721103787b91593..d985b534cd0beaa4eb1112e6416591ec375067ed 100644 (file)
--- a/Documentation/changes.tely
+++ b/Documentation/changes.tely
@@ -61,6 +61,20 @@ which scares away people.
 
 @end ignore
 
+@item
+The PostScript functionality of stroke adjustment is no longer
+applied automatically but left to the discretion of the PostScript
+device (by default, Ghostscript uses it for resolutions up to
+150dpi when generating raster images).  When it is enabled, a more
+complex drawing algorithm designed to benefit from stroke
+adjustment is employed mostly for stems and bar lines.
+
+Stroke adjustment can be forced by specifying the command line
+option @samp{-dstrokeadjust} to LilyPond.  When generating
+@code{PDF} files, this will usually result in markedly better
+looking @code{PDF} previews but significantly larger file size.
+Print quality at high resolutions will be unaffected.
+
 @item
 There is now a new context type called @code{NullVoice} which, while not
 appearing in the printed output, can be used to align lyrics.  This can

diff --git a/Documentation/usage/running.itely b/Documentation/usage/running.itely
index 9e736bda0139d25349a5dda61ac6e6a240dc929e..7e7692c86dff6d536474f45c3a507457c1263af9 100644 (file)
--- a/Documentation/usage/running.itely
+++ b/Documentation/usage/running.itely
@@ -664,6 +664,17 @@ point exceptions.
 @tab Don't use directories from input files while constructing output
 file names.
 
+@item @code{strokeadjust}
+@tab @code{#f}
+@tab Force PostScript stroke adjustment.  This option is mostly
+relevant when @code{PDF} is generated from PostScript output
+(stroke adjustment is usually enabled automatically for
+low-resolution bitmap devices).  Without this option,
+@code{PDF}@tie{}previewers tend to produce widely inconsistent
+stem widths at resolutions typical for screen display.  The option
+does not noticeably affect print quality and causes large file
+size increases in @code{PDF} files.
+
 @item @code{svg-woff}
 @tab @code{#f}
 @tab Use woff font files in SVG backend.