lilypond-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: links in LSR snippets


From: Werner LEMBERG
Subject: Re: links in LSR snippets
Date: Sun, 15 Feb 2009 12:06:13 +0100 (CET)

>> LSR files sometimes refer to the manual.  Example:
> 
> I almost consider this a bug, especially if they reference the LM.

Yep.

> ... we *could* add a special "html" command for these in LSR.  They
> would do nothing in the main LSR view, but when we run makelsr.py,
> we could change the new "html" command into @ref{}.  Depending on
> how the build process works, these might be able to link back to the
> proper location.
> 
> However, I really cannot see this being worth the (relatively
> speaking) enormous effort to modify LSR, modify makelsr.py, possibly
> modify the build process, and test the entire thing.  I think we're
> looking at 20 hours of work to support something that perhaps a
> dozen badly-worded snippets use.

OK.

> To anticipate a possible objection: the snippets are not designed to
> teach lilypond basics.

Exactly.

A logical corrolary: LSR files must not refer to the documentation (or
rather, to exact locations in the docs); instead, the docs should
refer to LSR files.  All references should be thus removed.


    Werner




reply via email to

[Prev in Thread] Current Thread [Next in Thread]