Re: Please remove docs tags from snippets

[Carl Sorensen]

On 7/23/09 9:47 PM, "Graham Percival" <address@hidden> wrote:

> 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)

Thanks, Graham.  I didn't know about option 2).  I knew how to change a
snippet, but not how to delete it.

> 
> 
> This should evidently be added to CG x.snippets, and linked to
> remove CG x.programming.

I'll try to get this done.

Carl