Patch attached!

Jon

On Wed, Mar 11, 2009 at 6:17 AM, Trevor Daniels <[email protected]>wrote:

>
> Jonathan Kulp wrote Wednesday, March 11, 2009 10:38 AM
>
>
>  Trevor Daniels wrote:
>>
>>>
>>> Graham Percival wrote Wednesday, March 11, 2009 8:34 AM
>>>
>>>  I'd prefer this as a @knownissues or even a @warning.  I
>>>> /definitely/ wouldn't include it in the same parapraph --  remember
>>>> that the number of people reading a paragraph decreases
>>>> exponentially as the length of the paragraph increases[1].
>>>>
>>>
>>> But this paragraph, even with the warning, is only
>>> 4 lines long!?  And it is the first paragraph in the
>>> section.
>>>
>>> Making it a @knownissue would be far worse - this
>>> would place it several pages below.
>>>
>>>  People normally wouldn't expect the order of the \includes to
>>>> matter, so IMO we should make this quite visible.
>>>>
>>>
>>> I guess a @warning might be better.
>>>
>>
>> So do you guys want me to re-work this as a @warning?
>>
>
> Please.  Perhaps a warning to replace the text where
> it is and also add it as a @knownissue too.
>
> Thanks
>
> Trevor
>
>


-- 
Jonathan Kulp
http://www.jonathankulp.com
From 595360b229d8becdb1701013b89cec7287ad1fe4 Mon Sep 17 00:00:00 2001
From: Jonathan Kulp <[email protected]>
Date: Wed, 11 Mar 2009 18:03:55 -0500
Subject: [PATCH] Docs: insert language @warning for non-default languages

---
 Documentation/user/pitches.itely |   14 ++++++++------
 1 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/Documentation/user/pitches.itely b/Documentation/user/pitches.itely
index 514287d..1b7c2c8 100644
--- a/Documentation/user/pitches.itely
+++ b/Documentation/user/pitches.itely
@@ -407,12 +407,14 @@ any standard.
 There are predefined sets of note and accidental names for various
 other languages.  To use them, include the language-specific init
 file listed below.  For example, to use English note names, add
-...@code{@w{\include "english.ly"}} to the input file.  Because some
-other include files (such as @co...@w{predefined-fretboards.ly}}) use
-default (Nederlands) note names, the @code{\include} command for the
-language file should be placed after all other LilyPond distribution
-files.  The available language files and the note names they define
-are:
+...@code{@w{\include "english.ly"}} to the input file.
+
+...@warning{because some other include files (such as @co...@w{predefined-fretboards.ly}})
+use default (Nederlands) note names, the @co...@bs{}include}
+command for the language file should be placed after all other
+LilyPond distribution files.}
+
+The available language files and the note names they define are:
 
 @quotation
 @multitable {...@file{nederlands.ly}} {do re mi fa sol la sib si}
-- 
1.5.4.3

_______________________________________________
lilypond-devel mailing list
[email protected]
http://lists.gnu.org/mailman/listinfo/lilypond-devel

Reply via email to