Re: Syntax explanations

[Graham Percival]

On Wed, 11 Jun 2008 08:55:36 -0600
"Carl D. Sorensen" <address@hidden> wrote:

> > -----Original Message-----
> > From: Reinhold Kainhofer [mailto:address@hidden
> > Sent: Wednesday, June 11, 2008 7:05 AM
> > To: Carl D. Sorensen
> > Cc: lily-devel
> > Subject: Re: Syntax explanations
> >
> > Am Mittwoch, 11. Juni 2008 schrieben Sie:
> > > When I first started working on chords.itely I wrote something
> > > like this for chordmode chords.  However, by design we don't do
> > this in the NR.
> >
> > Ouch, because for a reference manual, I find it extremely
> > useful to show the basics in one table with all available options.
> 
> I agree.  It would be nice to have a table with all available
> options.  However, I think that the decision Graham has made is to
> have the documentation a little less friendly now and automatically
> updatable for the future.

I'm not opposed to a table with all options.  Especially not if
it's a table with lilypond examples in it.

Don't forget that work on Chords stopped halfway, due to arguments
about property-init.ly and whatnot.  I certainly don't conisder it
finished yet.

> > For example, to create a hald-diminished, I found out that I
> > could use 'dim5m7', but that took me some trying.

I'd say that this should be in Common chords, but don't forget
that the docs are a matter of the blind leading the blind.  That
never occurred to me and Carl.

Granted, we haven't called for a public review of Chords yet, but
this is exactly the kind of thing I hope to get pointed out when
we do so.

Cheers,
- Graham