[Top][All Lists]

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

Re: Please remove docs tags from snippets

From: Carl Sorensen
Subject: Re: Please remove docs tags from snippets
Date: Thu, 23 Jul 2009 22:15:09 -0600

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


reply via email to

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