CVSROOT:        /cvsroot/lilypond
Module name:    lilypond
Branch:         
Changes by:     Graham Percival <[EMAIL PROTECTED]>     05/05/24 19:09:20

Modified files:
        .              : ChangeLog 
        Documentation/user: lilypond.tely basic-notation.itely 
                            advanced-notation.itely 
                            changing-defaults.itely 

Log message:
        Misc editing, rearranging.

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/lilypond/lilypond/ChangeLog.diff?tr1=1.3652&tr2=1.3653&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/lilypond/lilypond/Documentation/user/lilypond.tely.diff?tr1=1.128&tr2=1.129&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/lilypond/lilypond/Documentation/user/basic-notation.itely.diff?tr1=1.19&tr2=1.20&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/lilypond/lilypond/Documentation/user/advanced-notation.itely.diff?tr1=1.27&tr2=1.28&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/lilypond/lilypond/Documentation/user/changing-defaults.itely.diff?tr1=1.129&tr2=1.130&r1=text&r2=text

Patches:
Index: lilypond/ChangeLog
diff -u lilypond/ChangeLog:1.3652 lilypond/ChangeLog:1.3653
--- lilypond/ChangeLog:1.3652   Mon May 23 23:23:42 2005
+++ lilypond/ChangeLog  Tue May 24 19:09:19 2005
@@ -1,3 +1,14 @@
+2005-05-24  Graham Percival  <[EMAIL PROTECTED]>
+
+       * Documentation/user/lilypond.tely: move changing-defaults to be
+       before global issues.
+
+       * Documentation/user/basic-notation.itely: move Transpose section
+       here from advanced/Other.
+
+       * Documentation/user/changing-defaults.itely,
+       advanced-notation.itely: move Fonts to advanced, edit.
+
 2005-05-24  Han-Wen Nienhuys  <[EMAIL PROTECTED]>
 
        * lily/parser.yy (bare_int): remove rule.  From now on, we require
Index: lilypond/Documentation/user/advanced-notation.itely
diff -u lilypond/Documentation/user/advanced-notation.itely:1.27 
lilypond/Documentation/user/advanced-notation.itely:1.28
--- lilypond/Documentation/user/advanced-notation.itely:1.27    Mon May 23 
19:29:14 2005
+++ lilypond/Documentation/user/advanced-notation.itely Tue May 24 19:09:20 2005
@@ -37,6 +37,8 @@
 * Text encoding::               
 * Nested scores::               
 * Overview of text markup commands::  
+* Selecting font sizes::        
+* Font selection::              
 * New dynamic marks::           
 * Other text markup issues::    
 @end menu
@@ -357,6 +359,133 @@
 @include markup-commands.tely
 
 
[EMAIL PROTECTED] Selecting font sizes
[EMAIL PROTECTED] Selecting font sizes
+
+The easiest method of setting the font size of any context, is by
+setting the @code{fontSize} property.
+
[EMAIL PROTECTED],fragment,relative=1,verbatim]
+c8
+\set fontSize = #-4
+c f
+\set fontSize = #3
+g
[EMAIL PROTECTED] lilypond
+
[EMAIL PROTECTED]
+It does not change the size of variable symbols, such as beams or
+slurs.
+
+Internally, the @code{fontSize} context property will cause the
[EMAIL PROTECTED] property to be set in all layout objects.  The value
+of @code{font-size} is a number indicating the size relative to the
+standard size for the current staff height.  Each step up is an
+increase of approximately 12% of the font size.  Six steps is exactly a
+factor two.  The Scheme function @code{magstep} converts a
[EMAIL PROTECTED] number to a scaling factor.
+
[EMAIL PROTECTED],fragment,relative=1,verbatim]
+c8
+\override NoteHead #'font-size = #-4
+c f
+\override NoteHead #'font-size = #3
+g
[EMAIL PROTECTED] lilypond
+
+LilyPond has fonts in different design sizes.  The music fonts for
+smaller sizes are chubbier, while the text fonts are relatively wider.
+Font size changes are achieved by scaling the design size that is
+closest to the desired size.  The standard font size (for
[EMAIL PROTECTED] equals 0), depends on the standard staff height.  For
+a 20pt staff, a 10pt font is selected.
+
+The @code{font-size} property can only be set on layout objects that
+use fonts. These are the ones supporting the
[EMAIL PROTECTED] layout interface.
+
[EMAIL PROTECTED]
+
+The following commands set @code{fontSize} for the current voice:
+
[EMAIL PROTECTED] @code{\tiny}
[EMAIL PROTECTED], 
[EMAIL PROTECTED] @code{\small}
[EMAIL PROTECTED], 
[EMAIL PROTECTED] @code{\normalsize}
[EMAIL PROTECTED]
+
+
[EMAIL PROTECTED] Font selection
[EMAIL PROTECTED] Font selection
+
[EMAIL PROTECTED] font selection
[EMAIL PROTECTED] font magnification
[EMAIL PROTECTED] @code{font-interface}
+
+By setting the object properties described below, you can select a
+font from the preconfigured font families.  LilyPond has default
+support for the feta music fonts and @TeX{}'s Computer Modern text
+fonts.
+
[EMAIL PROTECTED] @bullet
[EMAIL PROTECTED] @code{font-encoding}
+is a symbol that sets layout of the glyphs.  This should only be set to
+select different types of non-text fonts, eg.
+
[EMAIL PROTECTED] for piano staff braces, @code{fetaMusic} the
+standard music font, including ancient glyphs, @code{fetaDynamic} for
+dynamic signs and @code{fetaNumber} for the number font.
+
[EMAIL PROTECTED] @code{font-family}
+is a symbol indicating the general class of the typeface.  Supported are
[EMAIL PROTECTED] (Computer Modern), @code{sans}, and @code{typewriter}.
+  
[EMAIL PROTECTED] @code{font-shape}
+is a symbol indicating the shape of the font.  There are typically
+several font shapes available for each font family.  Choices are
[EMAIL PROTECTED], @code{caps}, and @code{upright}.
+
[EMAIL PROTECTED] @code{font-series}
+is a symbol indicating the series of the font.  There are typically
+several font series for each font family and shape.  Choices are
[EMAIL PROTECTED] and @code{bold}. 
+
[EMAIL PROTECTED] itemize
+
+Fonts selected in the way sketched above come from a predefined style
+sheet. If you want to use a font from outside the style sheet, 
+then set the 
[EMAIL PROTECTED] property, 
+
[EMAIL PROTECTED],verbatim]
+{
+  \override Staff.TimeSignature #'font-name = #"Times"
+  \override Staff.TimeSignature #'font-size = #2
+  \time 3/4
+  c'1_\markup {
+    \override #'(font-name . "Vera Bold")
+      { This text is in Vera Bold }
+  }
+}
[EMAIL PROTECTED] lilypond
+
[EMAIL PROTECTED]
+Any font can be used, as long as it is available to Pango/FontConfig.
+
+The size of the font may be set with the @code{font-size}
+property. The resulting size is taken relative to the
[EMAIL PROTECTED] as defined in the @code{\paper} block.
+
[EMAIL PROTECTED] font size
[EMAIL PROTECTED] font magnification
+
[EMAIL PROTECTED]
+
+Init files: @file{ly/@/declarations@/-init@/.ly} contains hints how new
+fonts may be added to LilyPond.
+
+
 @node New dynamic marks
 @subsection New dynamic marks
 
@@ -402,6 +531,7 @@
 @end example
 
 
+
 @node Preparing parts
 @section Preparing parts
 
@@ -1922,6 +2052,7 @@
 COLORLIST
 
 
+
 @node Automatic notation
 @section Automatic notation
 
@@ -1934,7 +2065,6 @@
 @menu
 * Automatic accidentals::       
 * Setting automatic beam behavior::  
-* Beam formatting::             
 @end menu
 
 @node Automatic accidentals
@@ -2198,22 +2328,6 @@
 >>}.  If a polyphonic voice ends while an automatic beam is still
 accepting notes, it is not typeset.
 
[EMAIL PROTECTED] Beam formatting
[EMAIL PROTECTED] Beam formatting
-
-When a beam falls in the middle of the staff, the beams point normally
-down.  However, this behaviour can be altered with the
[EMAIL PROTECTED] property.
-
[EMAIL PROTECTED],raggedright,relative=2,fragment,verbatim]
-{
-  b8[ b]
-  \override Beam #'neutral-direction = #-1
-  b[ b]
-  \override Beam #'neutral-direction = #1
-  b[ b]
-}
[EMAIL PROTECTED] lilypond
 
 
 @node Other
@@ -2224,7 +2338,6 @@
 
 @menu
 * Time administration::         
-* Transpose::                   
 @end menu
 
 
@@ -2273,83 +2386,4 @@
 @end lilypond
 
 
[EMAIL PROTECTED] Transpose
[EMAIL PROTECTED] Transpose
[EMAIL PROTECTED] Transpose
[EMAIL PROTECTED] transposition of pitches
[EMAIL PROTECTED] @code{\transpose}
-
-A music expression can be transposed with @code{\transpose}.  The
-syntax is
[EMAIL PROTECTED]
-\transpose @var{from} @var{to} @var{musicexpr}
[EMAIL PROTECTED] example
-
-This means that @var{musicexpr} is transposed by the interval between
-the pitches @var{from} and @var{to}: any note with pitch @code{from}
-is changed to @code{to}.
-
-
-For example, consider a piece written in the key of D-major.  If
-this piece is a little too low for its performer, it can be
-transposed up to E-major with
[EMAIL PROTECTED]
-\transpose d e @dots{}
[EMAIL PROTECTED] example
-
-Consider a part written for violin (a C instrument).  If
-this part is to be played on the A clarinet, the following
-transposition will produce the appropriate part
-
[EMAIL PROTECTED]
-\transpose a c @dots{}
[EMAIL PROTECTED] example
-
[EMAIL PROTECTED] distinguishes between enharmonic pitches: both
[EMAIL PROTECTED] c cis} or @code{\transpose c des} will transpose up
-half a tone.  The first version will print sharps and the second
-version will print flats
-
[EMAIL PROTECTED],raggedright,verbatim]
-mus = { \key d \major cis d fis g }
-\context Staff {
-  \clef "F" \mus
-  \clef "G"
-  \transpose c g' \mus
-  \transpose c f' \mus
-}
[EMAIL PROTECTED] lilypond
-
[EMAIL PROTECTED] may also be used to input written notes for a
-transposing instrument.  Pitches are normally entered into LilyPond
-in C (or ``concert pitch''), but they may be entered in another
-key.  For example, when entering music for a B-flat trumpet which
-begins on concert D, one would write
-
[EMAIL PROTECTED]
-\transpose c bes @{ e4 @dots{} @}
[EMAIL PROTECTED] example
-
-To print this music in B-flat again (ie producing a trumpet part,
-instead of a concert pitch conductor's score) you would wrap the
-existing music with another @code{transpose}
-
[EMAIL PROTECTED]
-\transpose bes c @{ \transpose c bes @{ e4 @dots{} @} @}
[EMAIL PROTECTED] example
-
-
-
[EMAIL PROTECTED]
-
-Program reference: @internalsref{TransposedMusic}, and
[EMAIL PROTECTED]
-
[EMAIL PROTECTED]
-
-If you want to use both @code{\transpose} and @code{\relative},
-you must put @code{\transpose} outside of @code{\relative}, since
[EMAIL PROTECTED] will have no effect music that appears inside a
[EMAIL PROTECTED]
-
 
Index: lilypond/Documentation/user/basic-notation.itely
diff -u lilypond/Documentation/user/basic-notation.itely:1.19 
lilypond/Documentation/user/basic-notation.itely:1.20
--- lilypond/Documentation/user/basic-notation.itely:1.19       Fri May 20 
10:08:28 2005
+++ lilypond/Documentation/user/basic-notation.itely    Tue May 24 19:09:20 2005
@@ -13,7 +13,7 @@
 
 @menu
 * Note entry::                  
-* Easier music entry::          
+* Alternate music entry::       
 * Staff notation::              
 * Connecting notes::            
 * Expressive marks::            
@@ -472,8 +472,8 @@
 
 
 
[EMAIL PROTECTED] Easier music entry
[EMAIL PROTECTED] Easier music entry
[EMAIL PROTECTED] Alternate music entry
[EMAIL PROTECTED] Alternate music entry
 @cindex Music entry
 
 This section deals with tricks and features of the input language that
@@ -488,6 +488,7 @@
 @menu
 * Relative octaves::            
 * Octave check::                
+* Transpose::                   
 * Bar check::                   
 * Skipping corrected music::    
 * Automatic note splitting::    
@@ -626,6 +627,86 @@
 @end lilypond
 
 
[EMAIL PROTECTED] Transpose
[EMAIL PROTECTED] Transpose
+
[EMAIL PROTECTED] Transpose
[EMAIL PROTECTED] transposition of pitches
[EMAIL PROTECTED] @code{\transpose}
+
+A music expression can be transposed with @code{\transpose}.  The
+syntax is
[EMAIL PROTECTED]
+\transpose @var{from} @var{to} @var{musicexpr}
[EMAIL PROTECTED] example
+
+This means that @var{musicexpr} is transposed by the interval between
+the pitches @var{from} and @var{to}: any note with pitch @code{from}
+is changed to @code{to}.
+
+For example, consider a piece written in the key of D-major.  If
+this piece is a little too low for its performer, it can be
+transposed up to E-major with
[EMAIL PROTECTED]
+\transpose d e @dots{}
[EMAIL PROTECTED] example
+
+Consider a part written for violin (a C instrument).  If
+this part is to be played on the A clarinet, the following
+transposition will produce the appropriate part
+
[EMAIL PROTECTED]
+\transpose a c @dots{}
[EMAIL PROTECTED] example
+
[EMAIL PROTECTED] distinguishes between enharmonic pitches: both
[EMAIL PROTECTED] c cis} or @code{\transpose c des} will transpose up
+half a tone.  The first version will print sharps and the second
+version will print flats
+
[EMAIL PROTECTED],raggedright,verbatim]
+mus = { \key d \major cis d fis g }
+\context Staff {
+  \clef "F" \mus
+  \clef "G"
+  \transpose c g' \mus
+  \transpose c f' \mus
+}
[EMAIL PROTECTED] lilypond
+
[EMAIL PROTECTED] may also be used to input written notes for a
+transposing instrument.  Pitches are normally entered into LilyPond
+in C (or ``concert pitch''), but they may be entered in another
+key.  For example, when entering music for a B-flat trumpet which
+begins on concert D, one would write
+
[EMAIL PROTECTED]
+\transpose c bes @{ e4 @dots{} @}
[EMAIL PROTECTED] example
+
+To print this music in B-flat again (ie producing a trumpet part,
+instead of a concert pitch conductor's score) you would wrap the
+existing music with another @code{transpose}
+
[EMAIL PROTECTED]
+\transpose bes c @{ \transpose c bes @{ e4 @dots{} @} @}
[EMAIL PROTECTED] example
+
+
[EMAIL PROTECTED]
+
+Program reference: @internalsref{TransposedMusic}, and
[EMAIL PROTECTED]
+
+
[EMAIL PROTECTED]
+
+If you want to use both @code{\transpose} and @code{\relative},
+you must put @code{\transpose} outside of @code{\relative}, since
[EMAIL PROTECTED] will have no effect music that appears inside a
[EMAIL PROTECTED]
+
+
 @node Bar check
 @subsection Bar check
 
Index: lilypond/Documentation/user/changing-defaults.itely
diff -u lilypond/Documentation/user/changing-defaults.itely:1.129 
lilypond/Documentation/user/changing-defaults.itely:1.130
--- lilypond/Documentation/user/changing-defaults.itely:1.129   Wed May 18 
04:36:41 2005
+++ lilypond/Documentation/user/changing-defaults.itely Tue May 24 19:09:20 2005
@@ -60,7 +60,6 @@
 @menu
 * Interpretation contexts::     
 * The \override command::       
-* Fonts::                       
 @end menu
 
  
@@ -1321,156 +1320,3 @@
 is one.  For example, if using this with @code{Slur},
 @code{Slur::after_line_breaking} should also be called.
 
[EMAIL PROTECTED] Fonts
[EMAIL PROTECTED] Fonts
-
-This section details the ways that the font can be changed.
-
[EMAIL PROTECTED]
-* Selecting font sizes::        
-* Font selection::              
[EMAIL PROTECTED] menu
-
-
-
[EMAIL PROTECTED] Selecting font sizes
[EMAIL PROTECTED] Selecting font sizes
-
-
-The easiest method of setting the font size of any context, is by
-setting the @code{fontSize} property.
-
[EMAIL PROTECTED],fragment,relative=1,verbatim]
-c8
-\set fontSize = #-4
-c f
-\set fontSize = #3
-g
[EMAIL PROTECTED] lilypond
-
[EMAIL PROTECTED]
-It does not change the size of variable symbols, such as beams or
-slurs.
-
-Internally, the @code{fontSize} context property will cause the
[EMAIL PROTECTED] property to be set in all layout objects.  The value
-of @code{font-size} is a number indicating the size relative to the
-standard size for the current staff height.  Each step up is an
-increase of approximately 12% of the font size.  Six steps is exactly a
-factor two.  The Scheme function @code{magstep} converts a
[EMAIL PROTECTED] number to a scaling factor.
-
[EMAIL PROTECTED],fragment,relative=1,verbatim]
-c8
-\override NoteHead #'font-size = #-4
-c f
-\override NoteHead #'font-size = #3
-g
[EMAIL PROTECTED] lilypond
-
-LilyPond has fonts in different design sizes.  The music fonts for
-smaller sizes are chubbier, while the text fonts are relatively wider.
-Font size changes are achieved by scaling the design size that is
-closest to the desired size.  The standard font size (for
[EMAIL PROTECTED] equals 0), depends on the standard staff height.  For
-a 20pt staff, a 10pt font is selected.
-
-The @code{font-size} property can only be set on layout objects that
-use fonts. These are the ones supporting the
[EMAIL PROTECTED] layout interface.
-
[EMAIL PROTECTED]
-
-The following commands set @code{fontSize} for the current voice:
-
[EMAIL PROTECTED] @code{\tiny}
[EMAIL PROTECTED], 
[EMAIL PROTECTED] @code{\small}
[EMAIL PROTECTED], 
[EMAIL PROTECTED] @code{\normalsize}
[EMAIL PROTECTED]
-
-
-
[EMAIL PROTECTED] magnification
[EMAIL PROTECTED] cue notes
-
-
[EMAIL PROTECTED] Font selection
[EMAIL PROTECTED] Font selection
-
-
-
[EMAIL PROTECTED] font selection
[EMAIL PROTECTED] font magnification
[EMAIL PROTECTED] @code{font-interface}
-
-By setting the object properties described below, you can select a
-font from the preconfigured font families.  LilyPond has default
-support for the feta music fonts and @TeX{}'s Computer Modern text
-fonts.
-
-
[EMAIL PROTECTED] @bullet
[EMAIL PROTECTED] @code{font-encoding}
-is a symbol that sets layout of the glyphs.  This should only be set to
-select different types of non-text fonts, eg.
-
[EMAIL PROTECTED] for piano staff braces, @code{fetaMusic} the
-standard music font, including ancient glyphs, @code{fetaDynamic} for
-dynamic signs and @code{fetaNumber} for the number font.
-
[EMAIL PROTECTED] @code{font-family}
-is a symbol indicating the general class of the typeface.  Supported are
[EMAIL PROTECTED] (Computer Modern), @code{sans}, and @code{typewriter}.
-  
[EMAIL PROTECTED] @code{font-shape}
-is a symbol indicating the shape of the font.  There are typically
-several font shapes available for each font family.  Choices are
[EMAIL PROTECTED], @code{caps}, and @code{upright}.
-
[EMAIL PROTECTED] @code{font-series}
-is a symbol indicating the series of the font.  There are typically
-several font series for each font family and shape.  Choices are
[EMAIL PROTECTED] and @code{bold}. 
-
[EMAIL PROTECTED] itemize
-
-Fonts selected in the way sketched above come from a predefined style
-sheet. If you want to use a font from outside the style sheet, 
-then set the 
[EMAIL PROTECTED] property, 
-
[EMAIL PROTECTED],verbatim]
-{
-  \override Staff.TimeSignature #'font-name = #"Times"
-  \override Staff.TimeSignature #'font-size = #2
-  \time 3/4
-  c'1_\markup {
-    \override #'(font-name . "Vera Bold")
-      { This text is in Vera Bold }
-  }
-}
[EMAIL PROTECTED] lilypond
-
[EMAIL PROTECTED]
-Any font can be used, as long as it is available to Pango/FontConfig.
-
-The size of the font may be set with the @code{font-size}
-property. The resulting size is taken relative to the
[EMAIL PROTECTED] as defined in the @code{\paper} block.
-
-
[EMAIL PROTECTED] font size
[EMAIL PROTECTED] font magnification
-
-
-
[EMAIL PROTECTED]
-
-Init files: @file{ly/@/declarations@/-init@/.ly} contains hints how new
-fonts may be added to LilyPond.
-
-
-
-
Index: lilypond/Documentation/user/lilypond.tely
diff -u lilypond/Documentation/user/lilypond.tely:1.128 
lilypond/Documentation/user/lilypond.tely:1.129
--- lilypond/Documentation/user/lilypond.tely:1.128     Tue May 24 16:10:09 2005
+++ lilypond/Documentation/user/lilypond.tely   Tue May 24 19:09:20 2005
@@ -260,9 +260,9 @@
 * Instrument-specific notation::   Notation that is only used for some
                                    instruments.
 * Advanced notation::              Less frequently used notation.
+* Changing defaults::              Tuning output.
 * Global issues::                  Non-notation commands.
 
-* Changing defaults::              Tuning output.
 * Interfaces for programmers::
 * LilyPond-book::                  Integrating text and music.
 * Converting from other formats::  Converting to lilypond source format.
@@ -289,9 +289,9 @@
 @include basic-notation.itely
 @include instrument-notation.itely
 @include advanced-notation.itely
[EMAIL PROTECTED] changing-defaults.itely
 @include global.itely
 
[EMAIL PROTECTED] changing-defaults.itely
 @include programming-interface.itely
 @include lilypond-book.itely
 @include converters.itely


_______________________________________________
Lilypond-cvs mailing list
Lilypond-cvs@gnu.org
http://lists.gnu.org/mailman/listinfo/lilypond-cvs

Reply via email to