From ada3322d1fed93e0f1d4b9612cc24b39088b3b26 Mon Sep 17 00:00:00 2001
From: Han-Wen Nienhuys <hanwen@xs4all.nl>
Date: Thu, 12 Oct 2006 12:46:43 +0000
Subject: [PATCH] * Documentation/topdocs/NEWS.tely (Top): doc new clipping
 feature

* input/regression/clip-systems.ly (Notes): new file.
---
 ChangeLog                        |  4 +++
 Documentation/topdocs/NEWS.tely  |  3 --
 input/regression/clip-systems.ly | 61 ++++++++++++++++++++++++++++++++
 3 files changed, 65 insertions(+), 3 deletions(-)
 create mode 100644 input/regression/clip-systems.ly

diff --git a/ChangeLog b/ChangeLog
index 60568944f0..e9aba0fb54 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,9 @@
 2006-10-12  Han-Wen Nienhuys  <hanwen@lilypond.org>
 
+	* Documentation/topdocs/NEWS.tely (Top): doc new clipping feature
+
+	* input/regression/clip-systems.ly (Notes): new file. 
+
 	* scm/lily.scm (define-scheme-options): add clip-systems option.
 
 	* scm/framework-ps.scm (dump-stencil-as-EPS-with-bbox): new
diff --git a/Documentation/topdocs/NEWS.tely b/Documentation/topdocs/NEWS.tely
index 701fd2f9f0..dcb0f2e74e 100644
--- a/Documentation/topdocs/NEWS.tely
+++ b/Documentation/topdocs/NEWS.tely
@@ -75,9 +75,6 @@ An example is shown in @file{input/regression/clip-systems.ly}. This
 feature was sponsored by Rick Hansen.
 
 
-
-
-
 @item Lyric texts may include tie symbols by using the @code{~}
 symbol,
 
diff --git a/input/regression/clip-systems.ly b/input/regression/clip-systems.ly
new file mode 100644
index 0000000000..1893821eee
--- /dev/null
+++ b/input/regression/clip-systems.ly
@@ -0,0 +1,61 @@
+\header {
+  texidoc = "Clipping snippets from a finished score
+
+Notes:
+
+@itemize @bullet
+@item If system starts and ends are included, they include extents of the System grob, eg. instrument names.
+@item Grace notes  at the end point of the region are not included
+@item Regions can span multiple systems. In this case, multiple EPS files are generated.
+@end itemize
+
+This file needs to be run separately with @code{-dclip-systems}; the
+collated-files.html of the regression test does not adequately show
+the results.
+
+The result will be files named @file{@var{base}-system-@var{systemnumber}-@var{start}-@var{end}.eps}.
+
+"
+
+}
+
+\version "2.9.23"
+
+
+% each clip-region is a (START . END) pair
+% where both are rhythmic-locations.
+
+% (make-rhythmic-locations BAR-NUMBER NUM DEN)
+% means NUM/DEN whole-notes into bar numbered BAR-NUMBER
+
+\paper {
+
+  clip-regions
+  = #(list
+      (cons
+       (make-rhythmic-location 2 0 1)
+       (make-rhythmic-location 4 0 1))
+
+      (cons
+       (make-rhythmic-location 0 0 1)
+       (make-rhythmic-location 4 0 1))
+      
+      (cons
+       (make-rhythmic-location 0 0 1)
+       (make-rhythmic-location 6 0 1))
+    )
+}
+
+\relative {
+  \set Staff.instrumentName = #"bla"
+  c1
+  d
+  \grace c16
+  e1
+  \key d\major
+  
+  f
+  \break  \clef bass
+  g,
+  fis
+}  
-- 
2.39.5