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

- Graham

reply via email to

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