From 93d725094ee629b2d5200ab5a75b609579a62973 Mon Sep 17 00:00:00 2001 From: David Kastrup Date: Tue, 23 Apr 2013 17:02:47 +0200 Subject: [PATCH] Add Changes entry for -dstrokeadjust and "Usage" entry. (cherry picked from commit 21142318024c3abac5a13adaf32233cc741683cb) --- Documentation/changes.tely | 14 ++++++++++++++ Documentation/usage/running.itely | 11 +++++++++++ 2 files changed, 25 insertions(+) diff --git a/Documentation/changes.tely b/Documentation/changes.tely index 0815787d3c..d985b534cd 100644 --- 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 9e736bda01..7e7692c86d 100644 --- 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. -- 2.39.2