Re: Fretboard documentation

[Graham Percival]

Please keep the discussion on the mailing list.

As far as I can tell, none of those examples use \include
"english.ly".  If you're using that include, then you should have
seen:
http://lilypond.org/doc/v2.13/Documentation/notation/writing-pitches#Note-names-in-other-languages

which includes a big warning about this.  This warning was present in
the 2.12 docs as well.


Unfortunately we cannot handle every instance of people putting
together bits and pieces of information from various sources.  If you
use some piece of input because you saw it on a blog or email, without
reading the appropriate part of the Notation reference, there's little
we can do.

If you have detailed suggestions for a fix, I'm more than willing to
keep on discussing it, but I think the current docs are clear enough
about this issue.

Cheers,
- Graham

On Sun, Apr 25, 2010 at 7:49 PM, T.Skeggs <address@hidden> wrote:
> Thank you, Graham
>
> That is the first time I have seen the requirement for the language
> "include" to go last.  Where is that documented?
>
> Certainly, when I move the offending phrase into the header as
>
>  \version
>  \include "predefined-guitar-fretboards.ly"
>  \include "english.ly"
>
> then all is roses.
>
>
> I find the documentation extremely confusing and can often find things once
> only.
> The 3-note chord snippet was found at:
> http://lilypond.org/doc/v2.13/Documentation/snippets/templates#Templates
>
> then scrolling down to the blue header:
>
> Single staff template with notes lyrics chords and frets
>
> Quote: "Here is a simple lead sheet template with melody, lyrics, chords and
> fret diagrams."
>
> ( ... The first bit of the snippet sets lyrics ...)
>
> theChords = \chordmode {
> % insert chords for chordnames and fretboards here
>  c2 g4 c
> }
>
> ( ... The next bit of the snippet sets notes ...)
>
> \score {
>  <<
>   \context ChordNames { \theChords }
>   \context FretBoards { \theChords }
>   \new Staff {
>     \context Voice = "voiceMelody" { \staffMelody }
>   }
>   \new Lyrics = "lyricsI" {
>     \lyricsto "voiceMelody" \verseI
>   }
>   \new Lyrics = "lyricsII" {
>     \lyricsto "voiceMelody" \verseII
>   }
>  >>
>  \layout { }
>  \midi { }
>
>
> The fret diagrams as printed following this snippet are also 3-note.
> Is this the correct default, or does this snippet need to be updated to
> "include the include" ?
> If so, it also needs a warning about its placement, which should obviously
> not be where it is shown.
>
> - - - - - - - - - - - -
>
> The snippet that I used to resolve the 3-note chord problem was found in
>
> Notation Reference 2.12.3, Index page 595 :
>
> fret diagrams with chord names . . . . . .  230
>
> A introductory heading on page 230 states:
>
> Predefined fret diagrams
>
> Fret diagrams can be displayed using the FretBoards context. By default,
> the FretBoards context will display fret diagrams that are stored in a
> lookup table:
>  \include "predefined-guitar-fretboards.ly"
>  \context FretBoards {
>  \chordmode {
>  c1 d
>  }
>  }
>
>
> As quoted in my posting, the snippet used is from pages 230 & 231 :-
>
>
> Quote: It is common that both chord names and fret diagrams are displayed
> together.
> This is achieved by putting a ChordNames context in parallel with a
> FretBoards context and giving both contexts the same music.
>
> \include "predefined-guitar-fretboards.ly"
> mychords = \chordmode{
> c1 f g
> }
> <<
> \context ChordNames {
> \mychords
> }
> \context FretBoards {
> \mychords
> }
>>>
>
> So, unless I am using the documentation incorrectly, it can be considered a
> documentation bug, else is "pilot error".
>
> But then, I do not use Lilypond, I do battle with it.
>
> ---------------------------------------------------------------------
> ----- Original Message ----- From: "Graham Percival"
> <address@hidden>
> To: "Trevor Skeggs" <address@hidden>
> Cc: <address@hidden>
> Sent: Sunday, April 25, 2010 4:58 PM
> Subject: Re: Error using Fretboard in English
>
>
>> Is this a report of a problem in the docs, or a problem in
>> something you wrote yourself?
>>
>> Any language includes must go after other builtin lilypond
>> includes.  I can't find the string "Fretboard" in any of our
>> snippets, so I suspect the code below was written by you.  If you
>> fix the order, it should work.
>>
>> Cheers,
>> - Graham
>>
>>
>> On Sun, Apr 25, 2010 at 03:40:38PM +0000, Trevor Skeggs wrote:
>>>
>>> The Snippet List extract for a simple lead-sheet template
>>> ( melody, lyrics, chords and fret diagrams ) is not practical
>>> because it produces only trivial 3-note fretboard diagrams
>>> (the three lowest guitar strings are always marked as unused).
>>>
>>> - - - - - - - - - - -
>>>
>>> The Snippet included in Notation Reference 2.12.3
>>> (pages 230/231) uses ' predefined-guitar-fretboards.ly ' :
>>>
>>> \version "2.12.2"
>>> \include  "english.ly"
>>> \header { title = "Fretboard Bug" }
>>>
>>> \include "predefined-guitar-fretboards.ly"
>>> mychords = \chordmode { c1 f g }
>>> <<
>>>   \context ChordNames {\mychords }
>>>   \context FretBoards {\mychords }
>>> >>
>>>
>>> - - - - - - - - - - -
>>>
>>> However, this produces the following compilation error message:
>>>
>>> # -*-compilation-*-
>>> Processing `I:/LilyPond/Vocal/fretboard snippet.ly'
>>> Parsing...
>>> C:/Program Files/My
>>>
>>> Progs/Music/LilyPond/usr/share/lilypond/current/ly/predefined-guitar-ninth-
>>> fretboards.ly:28:36:
>>> error: syntax error, unexpected STRING
>>> \storePredefinedDiagram \chordmode {
>>>                                    cis:9}
>>>
>>> - - - - - - - - - - -
>>>
>>> Notice that there is no c#9 requested in the required chord list!
>>>
>>> The continental format "cis" gives the game away, and when
>>> '\include  "english.ly" ' is commented-out, the snippet works.
>>>
>>>
>>>
>>>
>>>
>>> _______________________________________________
>>> bug-lilypond mailing list
>>> address@hidden
>>> http://lists.gnu.org/mailman/listinfo/bug-lilypond
>
>