release: 1.1.63

[lilypond.git] / ly / auto-beam-settings.ly

diff --git a/ly/auto-beam-settings.ly b/ly/auto-beam-settings.ly
index 09113b139d86a30c518759ff6b3ec6008c837954..fb80c544d2d8d7cdf7292265ee1bfcff003970ab 100644 (file)
--- a/ly/auto-beam-settings.ly
+++ b/ly/auto-beam-settings.ly
@@ -1,25 +1,89 @@
+%%In the file ly/auto-beam-settings.ly, all necessary i-iii settings should
+%%be listed, here's a new version with more comments, (hw, please include).
+%%duh
+
+% auto-beam-settings.ly
+% setup for auto-beam engraver
 %
-% setup for auto beamer
+% specify generic beam end times
+
+% format:
 %
-time2_8beamAutoEnd = "2/8";
+%     [time-signature]'beamAutoEnd'[duration]
+%
+% where
+%
+%     time-signature = 'time'[numerator]'_'denominator; eg: 3_4
+%     duration = [numerator]'_'denominator; eg: 3_8, _16
+%
+
+% in 3/2 time:
+%   end beams each 1/2 note
+%   end beams with 16th notes each 1/4 note
+%   end beams with 32th notes each 1/8 note
 time3_2beamAutoEnd = "1/2";
-time3_2beamAutoEnd16 = "1/4";
-time3_2beamAutoEnd32 = "1/8";
-time3_4beamAutoBegin = "1/4";
-time3_4beamAutoEnd8 = "3/4";
-time3_4beamAutoBegin32 = "1/8";
-time3_4beamAutoEnd32 = "1/8";
+time3_2beamAutoEnd_16 = "1/4";
+time3_2beamAutoEnd_32 = "1/8";
+
+time3_4beamAutoBegin_8 = "1/4";
+time3_4beamAutoEnd_8 = "3/4";
+time3_4beamAutoBegin_16 = "1/16";
+time3_4beamAutoEnd_16 = "1/4";
+%time3_4beamAutoBegin_32 = "1/8";
+time3_4beamAutoEnd_32 = "1/8";
+
 time3_8beamAutoBegin = "1/8";
 time3_8beamAutoEnd = "3/8";
-time4_4beamAutoEnd8 = "1/2";
-time4_4beamAutoEnd32 = "1/8";
-time4_8beamAutoEnd8 = "1/4";
-time4_8beamAutoEnd16 = "1/4";
-time4_8beamAutoEnd32 = "1/8";
+
+% in common time:
+%   end beams each 1/2 note
+%   end beams with 32th notes each 1/8 note
+%   end beams with 1/8 triplets each 1/4 note
+
+time4_4beamAutoEnd_8 = "1/2";
+time4_4beamAutoEnd_12 = "1/4";
+time4_4beamAutoEnd_32 = "1/8";
+
+time4_8beamAutoEnd_8 = "1/4";
+time4_8beamAutoEnd_16 = "1/4";
+time4_8beamAutoEnd_32 = "1/8";
+
 time4_16beamAutoEnd = "1/8";
-time6_8beamAutoEnd8 = "3/8";
-time6_8beamAutoEnd16 = "3/8";
-time6_8beamAutoEnd32 = "1/8";
-time9_8beamAutoEnd8 = "3/8";
-time9_8beamAutoEnd16 = "3/8";
-time6_8beamAutoEnd32 = "1/8";
+
+time6_8beamAutoEnd_8 = "3/8";
+time6_8beamAutoEnd_16 = "3/8";
+time6_8beamAutoEnd_32 = "1/8";
+
+time9_8beamAutoEnd_8 = "3/8";
+time9_8beamAutoEnd_16 = "3/8";
+time9_8beamAutoEnd_32 = "1/8";
+
+time12_8beamAutoEnd_8 = "3/8";
+time12_8beamAutoEnd_16 = "3/8";
+time12_8beamAutoEnd_32 = "1/8";
+
+%{
+
+Users may override in most cases, simply by issuing
+
+    % from here on consider ending beam every 1/4 note
+    \property Voice.beamAutoEnd = "1/4"
+
+    % no autobeaming
+    \property Voice.beamAuto = "0"  
+
+or, more globally, by doing:
+
+ \paper{
+        \translator{
+            \VoiceContext
+            % consider ending beam at every 1/2 note
+            beamAutoEnd = "1/2";
+        }
+    }
+
+see also input/test/auto-beam-override.ly
+
+%}
+
+