<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- header_tag -->
<html lang="en">
<head>
<title>Point and click - GNU LilyPond program usage</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="description" content="GNU LilyPond program usage">
<meta name="generator" content="makeinfo 4.11">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Setup.html#Setup" title="Setup">
<link rel="prev" href="Text-editor-support.html#Text-editor-support" title="Text editor support">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
Copyright (C) 1999--2007 by the authors
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License,
Version 1.1 or any later version published by the Free Software
Foundation; with no Invariant Sections. A copy of the license is
included in the section entitled ``GNU Free Documentation
License''.
-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
hr { border:0; height:1; color: #000000; background-color: #000000; }
/* hr {
border: none;
height: 1px;
color: #666666;
background-color: #666666;
}
body {
border-left: 1px solid #666666;
border-right: 1px solid #666666;
color: #332d28;
margin-right: auto;
margin-left: auto;
width: 60em;
list-style-type: square;
font-family: Arial,Helvetica,sans-serif;
padding-right: 1em;
padding-left: 1em;
}
a {
border-bottom: 1px dashed #344242;
text-decoration: none;
color: #344242;
}
a:link {
text-decoration: none;
}
a:visited {
border-bottom: 1px dashed #666666;
color: #666666;
}
a:active {
border-bottom: 1px solid #00cccc;
color: #00cccc;
}
a:hover {
border-bottom: 1px solid #1d7b85;
color: #1d7b85;
}
blockquote {
border: 1px solid #cccccc;
padding: 3px;
width: 40em;
}
.node {
border-left: 1px solid #666666;
margin: -0.5em 0px 1em;
padding: 2px 1px 0px;
font-style: italic;
}
.node a {
border: none;
text-decoration: underline;
font-style: normal;
font-weight: bold;
}
.verbatim {
font-family: "Courier New",Courier,monospace;
}
.unnumberedsubsubsec {
font-size: large;
color: #1d7b85;
}
.subsubheading {
font-size: large;
color: #3b220d;
}
.contents {
border: 1px dashed #339999;
margin: 3px 2em;
list-style-type: square;
padding-right: 1em;
width: 40em;
background-color: #fcfff9;
}
.contents a {
border-bottom: 1px dashed #423d34;
text-decoration: none;
color: #423d34;
}
.contents a:visited {
border-bottom: 1px dashed #666666;
color: #666666;
}
.contents a:active {
border-bottom: 1px solid #f0d86d;
color: #f0d86d;
}
.contents a:hover {
border-bottom: 1px solid #3b220d;
color: #3b220d;
}
.menu {
border-left: 1px dashed #339999;
margin: 3px 2em 1em;
list-style-type: square;
padding-left: 1.4em;
width: 40em;
}
.unnumbered {
}
h2 {
font-size: x-large;
color: #1d7b85;
}
*/
--></style>
</head>
<BODY BGCOLOR=WHITE TEXT=BLACK>
<div class="node">
<p>
<a name="Point-and-click"></a>
Previous: <a rel="previous" accesskey="p" href="Text-editor-support.html#Text-editor-support">Text editor support</a>,
Up: <a rel="up" accesskey="u" href="Setup.html#Setup">Setup</a>
<hr>
</div>
<h3 class="section">2.3 Point and click</h3>
<p><a name="index-point-and-click-10"></a>
<p>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.
<p>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.
<p>To make this chain work, you should configure your PDF viewer to
follow hyperlinks using the <samp><span class="file">lilypond-invoke-editor</span></samp> script
supplied with LilyPond.
<p>For Xpdf on UNIX, the following should be present in
<samp><span class="file">xpdfrc</span></samp><a rel="footnote" href="#fn-1" name="fnd-1"><sup>1</sup></a>
<pre class="example"> urlCommand "lilypond-invoke-editor %s"
</pre>
<p>The program <samp><span class="file">lilypond-invoke-editor</span></samp> is a small helper
program. It will invoke an editor for the special <code>textedit</code>
URIs, and run a web browser for others. It tests the environment
variable <code>EDITOR</code> for the following patterns,
<dl>
<dt><code>emacs</code><dd> this will invoke
<pre class="example"> emacsclient --no-wait +<var>line</var>:<var>column</var> <var>file</var>
</pre>
<br><dt><code>vim</code><dd> this will invoke
<pre class="example"> gvim --remote +:<var>line</var>:norm<var>char</var> <var>file</var>
</pre>
<br><dt><code>nedit</code><dd>this will invoke
<pre class="example"> nc -noask +<var>line</var> <var>file</var>'
</pre>
</dl>
<p>The environment variable <code>LYEDITOR</code> is used to override this. It
contains the command line to start the editor, where <code>%(file)s</code>,
<code>%(column)s</code>, <code>%(line)s</code> is replaced with the file, column
and line respectively. The setting
<pre class="example"> emacsclient --no-wait +%(line)s:%(column)s %(file)s
</pre>
<p class="noindent">for <code>LYEDITOR</code> is equivalent to the standard emacsclient
invocation.
<p><a name="index-file-size_002c-output-11"></a>
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
<pre class="example"> \pointAndClickOff
</pre>
<p class="noindent">in a <samp><span class="file">.ly</span></samp> file. Point and click may be explicitly enabled with
<pre class="example"> \pointAndClickOn
</pre>
<p>Alternately, you may disable point and click with a command-line
option:
<pre class="example"> lilypond -dno-point-and-click file.ly
</pre>
<p><table class="cartouche" summary="cartouche" border="1"><tr><td>
<b>Note:</b> 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.
</td></tr></table>
<!-- *- coding: utf-8; mode: texinfo; -*- -->
<!-- This file is part of lilypond-program.tely -->
<!-- \version "2.11.57" -->
<div class="footnote">
<hr>
<h4>Footnotes</h4><p class="footnote"><small>[<a name="fn-1" href="#fnd-1">1</a>]</small> On UNIX, this file is found either in
<samp><span class="file">/etc/xpdfrc</span></samp> or as <samp><span class="file">.xpdfrc</span></samp> in your home directory.</p>
<hr></div>
<!-- footer_tag --><div class="node">
<p>
Previous: <a rel="previous" accesskey="p" href="Text-editor-support.html#Text-editor-support">Text editor support</a>,
Up: <a rel="up" accesskey="u" href="Setup.html#Setup">Setup</a>
</div>
<div style="background-color: #e8ffe8; padding: 2; border: #c0ffc0 1px solid;">
<p>
<font size="-1">
This page is for LilyPond-2.11.57 (development-branch).
<br>
<address>
Report errors to <a href="http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs">http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs</a>. </address>
<br>
Your <a href="http://lilypond.org/web/devel/participating/documentation-adding">suggestions for the documentation</a> are welcome.
</font>
</p>
</div>
<P>
Other languages: <a href="Point-and-click.es.html">español</a>, <a href="Point-and-click.de.html">deutsch</a>.
<BR>
</P>
</BODY></html>
