Re: file locations or links in snippets

[John Mandereau]

On 2008/05/09, Graham Percival wrote:
> input/new/makam.ly  now contains:
> +microtonal alterations.  Consult the initialization file
> address@hidden (in @code{/usr/share/lilypond/current/ly})
> +for details of pitch names and alterations.
> 
> 
> This is true for some linux installations (although not mine; I
> keep all non-debian-packaged software in my user account), but
> certainly not true of OSX or windows installations.

I think this is actually true for all GUB installations, whatever the
OS, and this is not true for non-GUB installation (Debian and RPM
packages, or self-compiled installations, for example, which use
share/lilypond/x.y.z).



> This raises again the question of allowing links from snippet
> descriptions.  I still don't think it's worth adding the
> infrastructure for this -- bear in mind that such a feature would
> need to work from input/lsr/ (easy) and LSR itself (hard).  I
> think there's much more important things to work on for LSR, such
> as removing the "directories", getting search-by-tag, and eventually
> upgrading to 2.11.
>
> If a technical person wants to say "oh, it's trivial!  Here's a
> patch to the LSR source code that does it, blah blah blah" then
> I won't object.  :)

I'm not volunteering for doing this involved task, but as a lot easier
alternative we could add a link at top of each tag page to the
corresponding section of NR (and LM if applicable).  Unless you
complain, I'll go ahead with this within next week.


> A few snippet simply include text like "Consult the initialization
> file @code{makam-init.ly) (see the `Learning Manual X.Y.Z
> Initialization Files' for the location of this file) for details
> of pitch names and alterantions)".  I'd recommend doing that here
> as well.

You're right, so we could easily mention the case of
share/lilypond/x.y.z in 'Initialization Files'.

Cheers,
John