Previous: Editor support, Up: Running LilyPond
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.
When this functionality is active, LilyPond adds hyperlinks to the PDF file. These hyperlinks are sent to the 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 lilypond-invoke-editor script supplied with LilyPond.
For Xpdf on Unix, the following should be present in xpdfrc1
urlCommand "lilypond-invoke-editor %s"
The program lilypond-invoke-editor is a small helper
program. It will invoke an editor for the special textedit
URIs, and run a web browser for others. It tests the environment
variable EDITOR for the following patterns,
emacsemacsclient --no-wait +line:column file
vimgvim --remote +:line:normchar file
neditnc -noask +line file'
The environment variable LYEDITOR is used to override this. It
contains the command line to start the editor, where %(file)s,
%(column)s, %(line)s is replaced with the file, column
and line respectively. The setting
emacsclient --no-wait +%(line)s:%(column)s %(file)s
for LYEDITOR is equivalent to the standard emacsclient
invocation.
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
#(ly:set-option 'point-and-click #f)
in a .ly file. Alternately, you may pass this as an command-line option
lilypond -dno-point-and-click file.ly
[1] On unix, this file is found either in /etc/xpdfrc or as .xpdfrc in your home directory.
This page is for LilyPond-2.8.8 (stable-branch).