Re: GDP: NR 1.1 Pitches 2008-01-26

[Graham Percival]

On Thu, 31 Jan 2008 11:27:24 +0100
"Kess Vargavind" <address@hidden> wrote:

> CONTENTS
> Note names in other languages (last paragraph):
> 
> "For both historical reasons and a greater simplicity, LilyPond uses a
> single 's' for all these languages."
> 
> I'm not really sure what's intended with that sentence, to me it
> sounds like that I'm unable to write "cess" or "ciss" with
> svenska.ly, which is not the case. Is the intended meaning somewhere
> along the lines of "...LilyPond uses a single 's' in the default
> syntax"?

Interesting... that paragraph directly contradicts the table
above, which shows that ciss is accepted in Norweigen and Swedish.
Either something changed since that sentence was written (since
the sentence is at least 5 years old, this is quite possible), or
it meant to say what you propose.

Either way, it appears that the paragraph is pointless and
potentially confusing.  Anybody object if I delete it?


> FORMATTING
> A small thing that nevertheless greatly would aid me in reading the
> manual:
> 
> Paragraphs coming directly after a header is correctly non-indented.
> Where the problem lies; after illustrations, boxes and tables the
> paragraphs are indented. Now, I know there are different styles of
> formatting, and all I wish of you is to think whether this is
> intentional, if you want it this way. ;) Me, I would be singing hymns
> of joy if those latter paragraphs where unindented as well (a
> paragraph following another should be indented of course).

Hmm.  This _is_ deliberate, although I make no claim that it's
ideal: the current practice is that if the material below an
example is strongly related to the example, we *do not* indent
that paragraph.  For example, see 1.1.2 Transpose "Note that we
specify..."

By default, texinfo does not indent the first paragraph and
indents all others; we need to specifically override this default
behavior for the "strongly related" material.

To be honest, I would rather not change this policy; we'd need to
manually add @noindent after 95% of the lilypond examples, and I
don't think this change is worth that effort.  (I'm also not
certain this is a big deal, especially since HTML doesn't indent
anything)

That said, I'm willing to listen to counterarguments or more
discussion about this.  And this is /exactly/ the kind of issue
that I want people to discuss right now -- if there's any general
formatting issues, we need to settle them now.  :)

Cheers,
- Graham