From 223b1ac16b1b80cd1226eed24968bf7c49c24ec8 Mon Sep 17 00:00:00 2001 From: James Lowe Date: Mon, 10 Feb 2014 13:45:20 +0000 Subject: [PATCH] Doc: Point-and-Click has wrong default and ref to SVG added Issue 3854 Also made sure that references to Point-and-click are consistent through lily.scm and external.itely (including TexInfo formatting). Tried to get some consistency with regard to remove @code{} for PDF, PS and SVG when referring to the file type or viewer. --- Documentation/usage/external.itely | 20 ++++++++++---------- Documentation/usage/running.itely | 28 +++++++++++++--------------- scm/lily.scm | 2 +- 3 files changed, 24 insertions(+), 26 deletions(-) diff --git a/Documentation/usage/external.itely b/Documentation/usage/external.itely index 7c386ae733..3b4ff955b9 100644 --- a/Documentation/usage/external.itely +++ b/Documentation/usage/external.itely @@ -29,8 +29,8 @@ LilyPond can interact with other programs in various ways. @cindex point and click Point and click lets you find notes in the input by clicking on them -in the PDF viewer. This makes it easier to find input that causes -some error in the sheet music. +in the PDF viewer. This makes it easier to find input that causes some +error in the sheet music. @menu * Configuring the system for point and click:: @@ -41,10 +41,10 @@ some error in the sheet music. @node Configuring the system for point and click @subsection Configuring the system -When this functionality is active, LilyPond adds hyperlinks to the -PDF file. These hyperlinks are sent to a @q{URI helper} or a -web-browser, which opens a text-editor with the cursor in the -right place. +When this functionality is active, LilyPond adds hyperlinks to PDF and +SVG files. These hyperlinks are sent to a @q{URI helper} or a +web-browser, which opens a text-editor with the cursor in the right +place. To make this chain work, you should configure your PDF viewer to follow hyperlinks using the @file{lilypond-invoke-editor} script @@ -205,11 +205,11 @@ likely that similar configurations will work for other viewers. @cindex file size, output Point and click functionality is enabled by default when creating -PDF files. +PDF or SVG files. The point and click links enlarge the output files significantly. For -reducing the size of PDF and PS files, point and click may be switched -off by issuing +reducing the size of these (and PS) files, point and click may +be switched off by issuing @example \pointAndClickOff @@ -231,7 +231,7 @@ lilypond -dno-point-and-click file.ly @warning{You should always turn off point and click in any LilyPond files to be distributed to avoid including path information about -your computer in the .pdf file, which can pose a security risk.} +your computer in the PDF file, which can pose a security risk.} @node Selective point-and-click @unnumberedsubsec Selective point-and-click diff --git a/Documentation/usage/running.itely b/Documentation/usage/running.itely index 693eb3dd54..b9d5b22601 100644 --- a/Documentation/usage/running.itely +++ b/Documentation/usage/running.itely @@ -400,15 +400,14 @@ file with all pages (systems) including fonts. Used as default by @item @tab @code{svg} -@tab Scalable Vector Graphics. This creates a single @code{SVG} file, +@tab Scalable Vector Graphics. This creates a single SVG file, without embedded fonts, for every page of output. It is recommended to install the Century Schoolbook fonts, included with your LilyPond installation, for optimal rendering. Under UNIX, simply copy these fonts from the LilyPond directory (typically -@file{/usr/share/lilypond/VERSION/fonts/otf/}) to @file{~/.fonts/}. The -@code{SVG} output should be compatible with any SVG editor or user -agent. There is also an option @code{svg-woff} (below) for use of woff -font files in the SVG backend. +@file{/usr/share/lilypond/VERSION/fonts/otf/}) to @file{~/.fonts/}. +There is also an option @code{svg-woff} (below) for use of woff font +files in the SVG backend. @item @tab @code{scm} @@ -551,9 +550,9 @@ escaped double quotes. @tab Set GhostScript's output format for pixel images. @item @code{point-and-click} -@tab @code{#f} -@tab Add @q{point & click} links to @code{PDF} output. See -@ref{Point and click}. +@tab @code{#t} +@tab Add @q{point & click} links to PDF and SVG output. +See @ref{Point and click}. @item @code{preview} @tab @code{#f} @@ -667,13 +666,12 @@ 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. +relevant when a PDF is generated from PostScript output (stroke +adjustment is usually enabled automatically for low-resolution bitmap +devices). Without this option, PDF 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 PDF files. @item @code{svg-woff} @tab @code{#f} diff --git a/scm/lily.scm b/scm/lily.scm index c27b381bf1..47e88eef9f 100644 --- a/scm/lily.scm +++ b/scm/lily.scm @@ -277,7 +277,7 @@ file to given string.") to a music font.") (point-and-click #t - "Add point & click links to PDF output.") + "Add point & click links to PDF and SVG output.") (paper-size "a4" "Set default paper size.") -- 2.39.5