2 @appendix Point and click
3 @cindex point and click
6 Point and click lets you find notes in the input by clicking on them
7 in the PDF viewer. This makes it easier to find input that causes
8 some error in the sheet music.
10 When this functionality is active, LilyPond adds hyperlinks to the PDF
11 file. These hyperlinks are sent to the web-browser, which opens a
12 text-editor with the cursor in the right place.
14 To make this chain work, you should configure your PDF viewer to
15 follow hyperlinks using the @file{lilypond-invoke-editor} script
16 supplied with LilyPond.
18 For Xpdf on Unix, the following should be present in
19 @file{xpdfrc}@footnote{On unix, this file is found either in
20 @file{/etc/xpdfrc} or as @file{.xpdfrc} in your home directory.}
23 urlCommand "lilypond-invoke-editor %s"
26 The program @file{lilypond-invoke-editor} is a small helper
27 program. It will invoke an editor for the special @code{textedit}
28 URIs, and run a web browser for others. It tests the environment
29 variable @code{EDITOR} for the following patterns,
35 emacsclient --no-wait +@var{line}:@var{column} @var{file}
40 gvim --remote +:@var{line}:norm@var{char} @var{file}
46 nc -noask +@var{line} @var{file}'
50 The environment variable @code{LYEDITOR} is used to override this. It
51 contains the command line to start the editor, where @code{%(file)s},
52 @code{%(column)s}, @code{%(line)s} is replaced with the file, column
53 and line respectively. The setting
56 emacsclient --no-wait +%(line)s:%(column)s %(file)s
60 for @code{LYEDITOR} is equivalent to the standard emacsclient
64 @cindex file size, output
66 The point and click links enlarge the output files significantly. For
67 reducing the size of PDF and PS files, point and click may be switched
71 #(ly:set-option 'point-and-click #f)
75 in a @file{.ly} file. Alternately, you may pass this as an command-line
79 lilypond -dno-point-and-click file.ly