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/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}.}
-
-@ignore
-mozilla wants us do store this in user.js:
-http://www.mozilla.org/support/firefox/edit#user
-
-location on different systems:
-http://www.mozilla.org/support/firefox/edit#profile
-
-@end ignore
-
-@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
@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
off by issuing
@example
- #(ly:set-option 'point-and-click #f)
+#(ly:set-option 'point-and-click #f)
@end example
@noindent
-in a @file{.ly} file.
+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
+