Eyolf Østrem wrote:
On 15.11.2007 (16:19), Graham Percival wrote:... I _really_ think this is completely unnecessary, though. And if you want to add full sentences to every single notation reference @ref{}, I assume you want to do the same for every @lsr{dir,snippet}, every @internalsref{}, etc ?No, not really. My only concern -- since you asked for general principles -- is that there shouldn't be a rule to preclude explanation where it is desirable.
That's why I proposed #3 -- short explanations could be added if needed, but most of the time you wouldn't need any explanation. To take the current examples, if you're looking at Durations and see a link to "writing rests" (or simply "rests", which is what we should have there), I don't think there's any question about why it might be useful.
Also, remember that this is the format inside the @seealso -- not about having links in the main doc section.
Cheers, - Graham _______________________________________________ lilypond-user mailing list [email protected] http://lists.gnu.org/mailman/listinfo/lilypond-user
