Fix off-by-one error in constrained-breaking.

[lilypond.git] / Documentation / user / point-and-click.itely

diff --git a/Documentation/user/point-and-click.itely b/Documentation/user/point-and-click.itely
index 0e81969711136233111868cdc587ea8b1020b8fc..8d74e79a68a81364a241a186b0d955ce8615865e 100644 (file)
--- a/Documentation/user/point-and-click.itely
+++ b/Documentation/user/point-and-click.itely
@@ -3,53 +3,30 @@
 @cindex point and click
 
 
-
-
-@cindex source specials
-@cindex specials, source
-
 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. 
+text-editor with the cursor in the right place.
 
-To make this chain work, the following should done:
-
-@itemize @bullet
-
-@item
-The PDF viewer must be configured for following hyperlinks, preferably
-using Mozilla Firefox.
+To make this chain work, you should configure your PDF viewer to
+follow hyperlinks using the @file{lilypond-invoke-editor} script
+supplied with LilyPond.
 
 For Xpdf on Unix, the following should be present in
 @file{xpdfrc}@footnote{On unix, this file is found either in
-@file{/etc} or your home directory.}
+@file{/etc/xpdfrc} or as @file{.xpdfrc} in your home directory.}
 
 @example
-urlCommand     "firefox -remote 'OpenURL(%s)'"
+urlCommand     "lilypond-invoke-editor %s"
 @end example
 
-@item Your web-browser must be configured for the @code{textedit}
-protocol,
-
-For Mozilla and Mozilla Firefox, this is done by adding following
-lines to the @file{prefs.js}@footnote{On a typical unix system, this
-file is found in your home-directory under
-@file{.mozilla/firefox/default.trn/prefs.js}.}  
-
-@example
-user_pref("network.protocol-handler.app.textedit", "lilypond-pdfpc-helper");
-user_pref("network.protocol-handler.warn-external.textedit", false);
-@end example
-
-@end itemize
-
-The program @file{lilypond-pdfpc-helper} is a small helper program.
-It tests the environment variable @code{EDITOR} for the following
-patterns,
+The program @file{lilypond-invoke-editor} is a small helper
+program. It will invoke an editor for the special @code{textedit}
+URIs, and run a web browser for others.  It tests the environment
+variable @code{EDITOR} for the following patterns,
 
 @table @code
 @item emacs
@@ -60,7 +37,7 @@ emacsclient --no-wait +@var{line}:@var{column} @var{file}
 @item vim
   this will invoke
 @example
-gvim --remote +:@var{line}:norm@var{column} @var{file}
+gvim --remote +:@var{line}:norm@var{char} @var{file}
 @end example
 
 @item nedit
@@ -83,3 +60,22 @@ emacsclient --no-wait +%(line)s:%(column)s %(file)s
 for @code{LYEDITOR} is equivalent to the standard emacsclient
 invocation.
 
+
+@cindex file size, output
+
+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
+
+@example
+#(ly:set-option 'point-and-click #f)
+@end example
+
+@noindent
+in a @file{.ly} file.  Alternately, you may pass this as an command-line
+option
+
+@example
+lilypond -dno-point-and-click file.ly
+@end example
+