CVSROOT: /cvsroot/lilypond
Module name: lilypond
Branch:
Changes by: Graham Percival <[EMAIL PROTECTED]> 05/05/24 19:18:59
Modified files:
Documentation/user: introduction.itely lilypond.tely
global.itely
Log message:
Renaming chapter, rearranging.
CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/lilypond/lilypond/Documentation/user/introduction.itely.diff?tr1=1.138&tr2=1.139&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/lilypond/lilypond/Documentation/user/lilypond.tely.diff?tr1=1.129&tr2=1.130&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/lilypond/lilypond/Documentation/user/global.itely.diff?tr1=1.12&tr2=1.13&r1=text&r2=text
Patches:
Index: lilypond/Documentation/user/global.itely
diff -u lilypond/Documentation/user/global.itely:1.12
lilypond/Documentation/user/global.itely:1.13
--- lilypond/Documentation/user/global.itely:1.12 Wed May 18 10:25:01 2005
+++ lilypond/Documentation/user/global.itely Tue May 24 19:18:59 2005
@@ -5,22 +5,22 @@
@c M-x texinfo-all-menus-update
@c to automatically fill in these menus before saving changes
[EMAIL PROTECTED] Global issues
[EMAIL PROTECTED] Global issues
[EMAIL PROTECTED] Output formats
[EMAIL PROTECTED] Output formats
This is a placeholder until I can write a nice intro for this chapter.
@menu
-* Global layout::
+* Paper output::
+* Sound output::
* LilyPond files::
-* Sound::
@end menu
[EMAIL PROTECTED] Global layout
[EMAIL PROTECTED] Global layout
[EMAIL PROTECTED] Paper output
[EMAIL PROTECTED] Paper output
-The global layout is determined by three factors: the page layout, the
+The global paper layout is determined by three factors: the page layout, the
line breaks, and the spacing. These all influence each other. The
choice of spacing determines how densely each system of music is set.
This influences where line breaks are chosen, and thus ultimately, how
@@ -894,6 +894,137 @@
[EMAIL PROTECTED] Sound output
[EMAIL PROTECTED] Sound output
+
[EMAIL PROTECTED] Sound
[EMAIL PROTECTED] MIDI
+
+MIDI (Musical Instrument Digital Interface) is a standard for
+connecting and controlling digital instruments. A MIDI file is a
+series of notes in a number of tracks. It is not an actual
+sound file; you need special software to translate between the
+series of notes and actual sounds.
+
+Pieces of music can be converted to MIDI files, so you can listen to
+what was entered. This is convenient for checking the music; octaves
+that are off or accidentals that were mistyped stand out very much
+when listening to the MIDI output.
+
[EMAIL PROTECTED]
+
+Many musically interesting effects, such as swing, articulation,
+slurring, etc., are not translated to midi.
+
+The midi output allocates a channel for each staff, and one for global
+settings. Therefore the midi file should not have more than 15 staves
+(or 14 if you do not use drums). Other staves will remain silent.
+
+Not all midi players correctly handle tempo changes in the midi
+output. Players that are known to work include
[EMAIL PROTECTED]://@/timidity@/.sourceforge@/.net/,timidity}.
+
[EMAIL PROTECTED]
+* Creating MIDI files::
+* MIDI block::
+* MIDI instrument names::
[EMAIL PROTECTED] menu
+
[EMAIL PROTECTED] Creating MIDI files
[EMAIL PROTECTED] Creating MIDI files
+
+To create a MIDI from a music piece of music, add a @code{\midi} block
+to a score, for example,
+
[EMAIL PROTECTED]
+\score @{
+ @var{...music...}
+ \midi @{ \tempo 4=72 @}
[EMAIL PROTECTED]
[EMAIL PROTECTED] example
+
+The tempo is specified using the @code{\tempo} command. In this
+example the tempo of quarter notes is set to 72 beats per minute.
+
+
+If there is a @code{\midi} command in a @code{\score}, only MIDI will
+be produced. When notation is needed too, a @code{\layout} block must
+be added
+
[EMAIL PROTECTED]
+\score @{
+ @var{...music...}
+ \midi @{ \tempo 4=72 @}
+ \layout @{ @}
[EMAIL PROTECTED]
[EMAIL PROTECTED] example
[EMAIL PROTECTED] layout block
+
+
+
+Ties, dynamics, and tempo changes are interpreted. Dynamic marks,
+crescendi and decrescendi translate into MIDI volume levels. Dynamic
+marks translate to a fixed fraction of the available MIDI volume
+range, crescendi and decrescendi make the volume vary linearly between
+their two extremes. The fractions can be adjusted by
[EMAIL PROTECTED] in @internalsref{Voice} context.
+For each type of MIDI instrument, a volume range can be defined. This
+gives a basic equalizer control, which can enhance the quality of
+the MIDI output remarkably. The equalizer can be controlled by
+setting @code{instrumentEqualizer}.
+
+
[EMAIL PROTECTED] MIDI block
[EMAIL PROTECTED] MIDI block
[EMAIL PROTECTED] MIDI block
+
+
+The MIDI block is analogous to the layout block, but it is somewhat
+simpler. The @code{\midi} block can contain
[EMAIL PROTECTED] MIDI block
+
[EMAIL PROTECTED] @bullet
+ @item a @code{\tempo} definition, and
+ @item context definitions.
[EMAIL PROTECTED] itemize
+
+A number followed by a period is interpreted as a real number, so
+for setting the tempo for dotted notes, an extra space should be
+inserted, for example
+
[EMAIL PROTECTED]
+\midi @{ \tempo 4 . = 120 @}
[EMAIL PROTECTED] example
+
+
[EMAIL PROTECTED] context definition
+
+Context definitions follow precisely the same syntax as within the
+\layout block. Translation modules for sound are called performers.
+The contexts for MIDI output are defined in @file{ly/@/performer@/-init@/.ly}.
+
+
[EMAIL PROTECTED] MIDI instrument names
[EMAIL PROTECTED] MIDI instrument names
+
[EMAIL PROTECTED] instrument names
[EMAIL PROTECTED] @code{Staff.midiInstrument}
+
+The MIDI instrument name is set by the @code{Staff.midiInstrument}
+property. The instrument name should be chosen from the list in
[EMAIL PROTECTED] instruments}.
+
[EMAIL PROTECTED]
+\set Staff.midiInstrument = "glockenspiel"
[EMAIL PROTECTED]
[EMAIL PROTECTED] example
+
+If the selected instrument does not exactly match an instrument from
+the list of MIDI instruments, the Grand Piano (@code{"acoustic grand"})
+instrument is used.
+
+
+
@node LilyPond files
@section LilyPond files
@@ -1037,134 +1168,3 @@
create a ``full score'' file which brings together the individual
instrument files.
-
[EMAIL PROTECTED] Sound
[EMAIL PROTECTED] Sound
[EMAIL PROTECTED] Sound
-
[EMAIL PROTECTED] MIDI
-
-MIDI (Musical Instrument Digital Interface) is a standard for
-connecting and controlling digital instruments. A MIDI file is a
-series of notes in a number of tracks. It is not an actual
-sound file; you need special software to translate between the
-series of notes and actual sounds.
-
-Pieces of music can be converted to MIDI files, so you can listen to
-what was entered. This is convenient for checking the music; octaves
-that are off or accidentals that were mistyped stand out very much
-when listening to the MIDI output.
-
[EMAIL PROTECTED]
-
-Many musically interesting effects, such as swing, articulation,
-slurring, etc., are not translated to midi.
-
-The midi output allocates a channel for each staff, and one for global
-settings. Therefore the midi file should not have more than 15 staves
-(or 14 if you do not use drums). Other staves will remain silent.
-
-Not all midi players correctly handle tempo changes in the midi
-output. Players that are known to work include
[EMAIL PROTECTED]://@/timidity@/.sourceforge@/.net/,timidity}.
-
[EMAIL PROTECTED]
-* Creating MIDI files::
-* MIDI block::
-* MIDI instrument names::
[EMAIL PROTECTED] menu
-
[EMAIL PROTECTED] Creating MIDI files
[EMAIL PROTECTED] Creating MIDI files
-
-To create a MIDI from a music piece of music, add a @code{\midi} block
-to a score, for example,
-
[EMAIL PROTECTED]
-\score @{
- @var{...music...}
- \midi @{ \tempo 4=72 @}
[EMAIL PROTECTED]
[EMAIL PROTECTED] example
-
-The tempo is specified using the @code{\tempo} command. In this
-example the tempo of quarter notes is set to 72 beats per minute.
-
-
-If there is a @code{\midi} command in a @code{\score}, only MIDI will
-be produced. When notation is needed too, a @code{\layout} block must
-be added
-
[EMAIL PROTECTED]
-\score @{
- @var{...music...}
- \midi @{ \tempo 4=72 @}
- \layout @{ @}
[EMAIL PROTECTED]
[EMAIL PROTECTED] example
[EMAIL PROTECTED] layout block
-
-
-
-Ties, dynamics, and tempo changes are interpreted. Dynamic marks,
-crescendi and decrescendi translate into MIDI volume levels. Dynamic
-marks translate to a fixed fraction of the available MIDI volume
-range, crescendi and decrescendi make the volume vary linearly between
-their two extremes. The fractions can be adjusted by
[EMAIL PROTECTED] in @internalsref{Voice} context.
-For each type of MIDI instrument, a volume range can be defined. This
-gives a basic equalizer control, which can enhance the quality of
-the MIDI output remarkably. The equalizer can be controlled by
-setting @code{instrumentEqualizer}.
-
-
[EMAIL PROTECTED] MIDI block
[EMAIL PROTECTED] MIDI block
[EMAIL PROTECTED] MIDI block
-
-
-The MIDI block is analogous to the layout block, but it is somewhat
-simpler. The @code{\midi} block can contain
[EMAIL PROTECTED] MIDI block
-
[EMAIL PROTECTED] @bullet
- @item a @code{\tempo} definition, and
- @item context definitions.
[EMAIL PROTECTED] itemize
-
-A number followed by a period is interpreted as a real number, so
-for setting the tempo for dotted notes, an extra space should be
-inserted, for example
-
[EMAIL PROTECTED]
-\midi @{ \tempo 4 . = 120 @}
[EMAIL PROTECTED] example
-
-
[EMAIL PROTECTED] context definition
-
-Context definitions follow precisely the same syntax as within the
-\layout block. Translation modules for sound are called performers.
-The contexts for MIDI output are defined in @file{ly/@/performer@/-init@/.ly}.
-
-
[EMAIL PROTECTED] MIDI instrument names
[EMAIL PROTECTED] MIDI instrument names
-
[EMAIL PROTECTED] instrument names
[EMAIL PROTECTED] @code{Staff.midiInstrument}
-
-The MIDI instrument name is set by the @code{Staff.midiInstrument}
-property. The instrument name should be chosen from the list in
[EMAIL PROTECTED] instruments}.
-
[EMAIL PROTECTED]
-\set Staff.midiInstrument = "glockenspiel"
[EMAIL PROTECTED]
[EMAIL PROTECTED] example
-
-If the selected instrument does not exactly match an instrument from
-the list of MIDI instruments, the Grand Piano (@code{"acoustic grand"})
-instrument is used.
-
-
Index: lilypond/Documentation/user/introduction.itely
diff -u lilypond/Documentation/user/introduction.itely:1.138
lilypond/Documentation/user/introduction.itely:1.139
--- lilypond/Documentation/user/introduction.itely:1.138 Thu May 12
08:15:42 2005
+++ lilypond/Documentation/user/introduction.itely Tue May 24 19:18:59 2005
@@ -673,14 +673,15 @@
details about complicated or unusual notation.
@item
[EMAIL PROTECTED]@ref{Global issues}}
-discusses issues which affect the whole lilypond file.
-
[EMAIL PROTECTED]
@[EMAIL PROTECTED] defaults}}
explains how to fine tune layout.
@item
[EMAIL PROTECTED]@ref{Output formats}}
+discusses issues which affect the global output, such as selecting
+paper size or which MIDI instruments to use.
+
[EMAIL PROTECTED]
@[EMAIL PROTECTED] explains the details behind creating
documents with in-line music examples, like this manual.
Index: lilypond/Documentation/user/lilypond.tely
diff -u lilypond/Documentation/user/lilypond.tely:1.129
lilypond/Documentation/user/lilypond.tely:1.130
--- lilypond/Documentation/user/lilypond.tely:1.129 Tue May 24 19:09:20 2005
+++ lilypond/Documentation/user/lilypond.tely Tue May 24 19:18:59 2005
@@ -261,7 +261,7 @@
instruments.
* Advanced notation:: Less frequently used notation.
* Changing defaults:: Tuning output.
-* Global issues:: Non-notation commands.
+* Output formats:: What LilyPond produces.
* Interfaces for programmers::
* LilyPond-book:: Integrating text and music.
_______________________________________________
Lilypond-cvs mailing list
Lilypond-cvs@gnu.org
http://lists.gnu.org/mailman/listinfo/lilypond-cvs
