[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Please remove docs tags from snippets
From: |
Graham Percival |
Subject: |
Re: Please remove docs tags from snippets |
Date: |
Thu, 23 Jul 2009 20:47:51 -0700 |
User-agent: |
Mutt/1.5.18 (2008-05-17) |
On Thu, Jul 23, 2009 at 08:55:21PM -0600, Carl Sorensen wrote:
> Please remove the docs tags from the following snippets:
>
> Specifying context with beatGrouping
>
> Using beatLength and beatGrouping
See below.
> They will be obsolete for 2.13.4 and cause problems in making documentation.
>
> This shows a very interesting problem. We only have *one* LSR, which is
> supposed to handle both the stable and the devel docs. But when we change
> syntax in devel, and it won't work any more, then we can't leave the docs
> tag on, which, IIRC, will break makelsr.py for the stable release. This is
> not a problem, unless there is going to be an additional release of the
> stable version.
This is precisely why input/new/ was invented!
Copy those snippets (the two files from input/lsr/) into
input/new/. Then either:
1) modify the input/new/ files to use the new syntax (assuming it
isn't handled automatically by convert-ly)
2) modify the input/new/ file to say:
\markup{ this snippet has been deprecated and will be removed in 2.14}
and delete the rest of the file. (other than the header)
This should evidently be added to CG x.snippets, and linked to
remove CG x.programming.
Cheers,
- Graham