2 @appendix Point and click
3 @cindex point and click
8 @cindex source specials
9 @cindex specials, source
11 Point and click lets you find notes in the input by clicking on them
12 in the PDF viewer. This makes it easier to find input that causes
13 some error in the sheet music.
15 When this functionality is active, LilyPond adds hyperlinks to the PDF
16 file. These hyperlinks are sent to the web-browser, which opens a
17 text-editor with the cursor in the right place.
19 To make this chain work, the following should done:
24 The PDF viewer must be configured for following hyperlinks, preferably
25 using Mozilla Firefox.
27 For Xpdf on Unix, the following should be present in
28 @file{xpdfrc}@footnote{On unix, this file is found either in
29 @file{/etc} or your home directory.}
32 urlCommand "firefox -remote 'OpenURL(%s)'"
35 @item Your web-browser must be configured for the @code{textedit}
38 For Mozilla and Mozilla Firefox, this is done by adding following
39 lines to the @file{prefs.js}@footnote{On a typical unix system, this
40 file is found in your home-directory under
41 @file{.mozilla/firefox/default.trn/prefs.js}.}
44 user_pref("network.protocol-handler.app.textedit", "lilypond-pdfpc-helper");
45 user_pref("network.protocol-handler.warn-external.textedit", false);
50 The program @file{lilypond-pdfpc-helper} is a small helper program.
51 It tests the environment variable @code{EDITOR} for the following
58 emacsclient --no-wait +@var{line}:@var{column} @var{file}
63 gvim --remote +:@var{line}:norm@var{column} @var{file}
69 nc -noask +@var{line} @var{file}'
73 The environment variable @code{LYEDITOR} is used to override this. It
74 contains the command line to start the editor, where @code{%(file)s},
75 @code{%(column)s}, @code{%(line)s} is replaced with the file, column
76 and line respectively. The setting
79 emacsclient --no-wait +%(line)s:%(column)s %(file)s
83 for @code{LYEDITOR} is equivalent to the standard emacsclient