[Top][All Lists]
[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