Re: [tablatures] planned doc edits fretted-strings.itely

[Carl Sorensen <c_sorensen@xxxxxxx>]

On 12/5/10 1:09 PM, "Patrick Schmidt" <p.l.schmidt@xxxxxx> wrote:

> Hi Carl, Marc et al.
> 
> I have prepared some material to document the new harmonic functions.
> I think it should be placed at the end of "Default tablatures". I'm
> planning to split up the existing paragraph on harmonics and slides
> into two separate paragraphs. The slides-paragraph would contain
> different kinds of slides and chord glissandi which I have not
> finished yet. The existing harmonics/slides-snippet would be replaced.
> 
> I created a snippet to demonstrate all three methods of engraving
> open-string harmonics. I also added some sort of a reference for open-
> string harmonics as I think it might not be obvious to everybody
> which fret/ratio leads to which harmonic pitch. Finally I'd like to
> illustrate how fretted-string harmonics can be typeset with LilyPond
> as they need a different approach.
> 
> Before I prepare a patch I'd like to know whether my snippets are
> appropriate for the docs. Should anything be changed/left out? Is
> anything missing? Should the fretted-string harmonics go into
> "Selected snippets"...
> [Of course the three score-markups won't go into the docs.]

It's a little hard to give feedback without having the text as well as the
snippets, but I'll do my best.

In my opinion, the body of the chapter should have very short snippets that
show just the point you are trying to make.  The shorter the snippet, the
easier it is to understand.  So you want something like:

Harmonics can be entered:

(simple snippet that shows the use of \harmonic)

Harmonics can be entered by fret:

(simple snippet that shows use of harmonic by fret)

Harmonics can also be entered by ratios:

(simple snippet that shows use of harmonic by ratio).

A more complete snippet that shows lots of usage hints could be added as
part of selected snippets.

The open-strings harmonic reference probably belongs in an appendix, rather
than in the chapter.  The notation reference is intended to be a reference
on using LilyPond to get the notation you desire, rather than a reference on
the notation.  If we can't figure out a place to put it in the docs, then we
can always put it as part of the selected snippets.

Thanks,

Carl