Doc: NR 1.1.1.4 Note names, remove arabic.ly from common languages

diff --git a/Documentation/notation/pitches.itely b/Documentation/notation/pitches.itely
index 0451385176735a3e839eeef30c2054e15e4726c1..fd9c04fdc2f285d378d2dbb50a38dbb7e406ef46 100644 (file)
--- a/Documentation/notation/pitches.itely
+++ b/Documentation/notation/pitches.itely
@@ -441,7 +441,7 @@ 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
 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.
+@code{@w{@bs{}include "english.ly"}} to the input file.

 
 @warning{Because some other include files (such as @code{@w{predefined-fretboards.ly}})
 use default (Nederlands) note names, the @code{@bs{}include}
 
 @warning{Because some other include files (such as @code{@w{predefined-fretboards.ly}})
 use default (Nederlands) note names, the @code{@bs{}include}


@@ -456,8 +456,6 @@ The available language files and the note names they define are:
   @tab Note Names
 @item @file{nederlands.ly}
   @tab c d e f g a bes b
   @tab Note Names
 @item @file{nederlands.ly}
   @tab c d e f g a bes b

-@item @file{arabic.ly}
-  @tab do re mi fa sol la sib si

 @item @file{catalan.ly}
   @tab do re mi fa sol la sib si
 @item @file{deutsch.ly}
 @item @file{catalan.ly}
   @tab do re mi fa sol la sib si
 @item @file{deutsch.ly}


@@ -489,8 +487,6 @@ and the accidental suffixes they define are:
 @headitem Language File
   @tab sharp @tab flat @tab double sharp @tab double flat
 @item @file{nederlands.ly}
 @headitem Language File
   @tab sharp @tab flat @tab double sharp @tab double flat
 @item @file{nederlands.ly}

-  @tab -is @tab -es @tab -isis @tab -eses
-@item @file{arabic.ly}

   @tab -d @tab -b @tab -dd @tab -bb
 @item @file{catalan.ly}
   @tab -d/-s @tab -b @tab -dd/-ss @tab -bb
   @tab -d @tab -b @tab -dd @tab -bb
 @item @file{catalan.ly}
   @tab -d/-s @tab -b @tab -dd/-ss @tab -bb


@@ -549,8 +545,6 @@ languages, no special names have been defined yet.
 
 @item @file{nederlands.ly}
   @tab -ih @tab -eh @tab -isih @tab -eseh
 
 @item @file{nederlands.ly}
   @tab -ih @tab -eh @tab -isih @tab -eseh

-@item @file{arabic.ly}
-  @tab -sd @tab -sb @tab -dsd @tab -bsb

 @item @file{deutsch.ly}
   @tab -ih @tab -eh @tab -isih @tab -eseh
 @item @file{english.ly}
 @item @file{deutsch.ly}
   @tab -ih @tab -eh @tab -isih @tab -eseh
 @item @file{english.ly}


@@ -565,7 +559,23 @@ languages, no special names have been defined yet.
 @end quotation
 
 
 @end quotation
 
 

+@cindex Arabic music
+
+Other languages and types of music may be supported by extending
+these predefined sets of note names.  For example, Arabic music
+may be typeset using @code{@w{@bs{}include "arabic.ly"}} which
+actually includes, in turn, the standard Italian note names as
+defined in @file{italiano.ly}, and adds extra macros and definitions.
+For details about non-Western music support, see
+@ref{Non-Western note names and accidentals} and
+@ref{World music}.
+
+

 @seealso
 @seealso

+Notation Reference:
+@ref{Non-Western note names and accidentals},
+@ref{World music}.
+

 Music Glossary:
 @rglos{Pitch names}.
 
 Music Glossary:
 @rglos{Pitch names}.
 


@@ -582,12 +592,16 @@ systems that do not fit readily into standard classical
 notation.
 
 In some cases standard notation is still used, with the
 notation.
 
 In some cases standard notation is still used, with the

-pitch differences being implicit.  For example, Arabic
-music is notated with standard semitone and quarter-tone
+pitch differences being implicit.  For example,
+@notation{Arabic music} is typically notated in
+standard @q{Italian} notation, with standard semitone and quarter-tone

 accidentals, with the precise pitch alterations being
 accidentals, with the precise pitch alterations being

-determined by context.  Others require extended or unique
-notations.
+determined by context.
+Italian note names and Arabic-specific tweaks are explained in
+@ref{Note names in other languages}; Arabic notation is discussed
+more extensively in @ref{Arabic music}.

 
 

+Other types of music require extended or unique notations:

 @notation{Turkish classical music}, or Ottoman music,
 employs melodic forms known as @notation{makamlar}, whose
 intervals are based on 1/9 divisions of the whole tone.
 @notation{Turkish classical music}, or Ottoman music,
 employs melodic forms known as @notation{makamlar}, whose
 intervals are based on 1/9 divisions of the whole tone.


@@ -636,6 +650,13 @@ makamlar, see @ref{Turkish classical music}.
 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 {makam-example.ly}
 
 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 {makam-example.ly}
 

+@seealso
+Notation Reference:
+@ref{Note names in other languages},
+@ref{World music},
+@ref{Arabic music},
+@ref{Turkish classical music}.
+

 
 @node Changing multiple pitches
 @subsection Changing multiple pitches
 
 @node Changing multiple pitches
 @subsection Changing multiple pitches

diff --git a/Documentation/notation/world.itely b/Documentation/notation/world.itely
index d50839acfad7231e5a0d0326891dc8059402014e..d6481c2a5d6097bae28c958adaf7fae6079c71c0 100644 (file)
--- a/Documentation/notation/world.itely
+++ b/Documentation/notation/world.itely
@@ -20,6 +20,10 @@ that are relevant to traditions outside the Western tradition.
 * Turkish classical music::
 @end menu
 
 * Turkish classical music::
 @end menu
 

+@c update Music Glossary for makam, makamlar, maqam,... -vv
+@c and add @rglos entries to pitches.itely "Non-Western note names"
+
+

 @node Arabic music
 @subsection Arabic music
 
 @node Arabic music
 @subsection Arabic music