Documentation improvement suggestion: << >>

Ken Harris <[email protected]>
Newsgroups gmane.comp.gnu.lilypond.bugs
Message-ID <CALoxLVoh3qydwCn0d0Hxcz0aP_Vvg3dEWHWKQSaw+gk4yyCDPQ@mail.gmail.com>
Hello, Lilypond!

I've transcribed my first simple piece, and now I'm trying to learn some
more sophisticated features, and I ran into strange new syntax in many of
the examples: << >>

In order to figure out what this means, here's what I tried:
 - Looked in the symbol section of the index (it's not there):
https://lilypond.org/doc/v2.25/Documentation/notation/lilypond-index
 - Used the search box on the documentation page (which uses google.com,
which is not so good at searching for non-alphanumeric symbols)
 - Tried searching these same places for descriptions and synonyms, like
"less than"
 - Tried searching for other grouping symbols (like {} and []) which I
thought might be synonyms (but aren't)
 - Tried a general web search for all of the above, too
 - Downloaded the Lilypond notation reference as a PDF (930 pages!), and
tried a full-text search for the string "<<" (450 matches!)

Eventually, I ran across the description of this syntax, purely by luck:
it's a "temporary polyphonic passage" --
https://lilypond.org/doc/v2.24/Documentation/notation/multiple-voices#single_002dstaff-polyphony

The notation reference is huge but that's OK because it's generally good at
letting me learn syntax on an as-needed basis.  But in the case of << >>
I'm not sure how I could have looked this up, short of reading the entire
manual cover-to-cover.  The reference manual uses << >> in examples 73
times before finally describing (on page 213) what it means.

I guess this is a long-winded way of saying that I think << >> should be in
the index.

Thanks for a great program!


- Ken
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.