From: David Kastrup <dak@gnu.org>
Date: Fri, 18 Oct 2013 11:30:05 +0000 (+0200)
Subject: Some slight Documentation changes for \hide/\omit
X-Git-Tag: release/2.17.95-1~4^2~23
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=7d3ea6751584868fda754e8b275e06605aad857d;p=lilypond.git

Some slight Documentation changes for \hide/\omit
---

diff --git a/Documentation/notation/ancient.itely b/Documentation/notation/ancient.itely
index 84d5cec14a..67aefbd86d 100644
--- a/Documentation/notation/ancient.itely
+++ b/Documentation/notation/ancient.itely
@@ -2704,8 +2704,7 @@ occasionally, for example to indicate the transition from a
 single-tone recitative to a fixed melodic gesture.  In these cases,
 one can use either @code{\hide Stem} or
 @code{\override Stem.length = #0} instead, and restore the stem
-when needed with the corresponding @code{\once \override Stem.transparent = ##f} (see example below).  When using stems that
-carry flags, make sure to set @code{\hide Flag} as well.
+when needed with the corresponding @code{\once \override Stem.transparent = ##f} (see example below).
 
 @b{Timing.} For unmetered chant, there are several alternatives.
 
diff --git a/Documentation/notation/changing-defaults.itely b/Documentation/notation/changing-defaults.itely
index 9e0f0e474e..f91cb0d223 100644
--- a/Documentation/notation/changing-defaults.itely
+++ b/Documentation/notation/changing-defaults.itely
@@ -3184,6 +3184,7 @@ considerations.
 @unnumberedsubsubsec Removing the stencil
 
 @cindex stencil, removing
+@funindex \omit
 
 Every layout object has a stencil property.  By default this is set
 to the specific function which draws that object.  If this property
@@ -3191,6 +3192,16 @@ is overridden to @code{#f} no function will be called and the object
 will not be drawn.  The default action can be recovered with
 @code{\revert}.
 
+@lilypond[quote,verbatim,relative=1]
+a1 a
+\override Score.BarLine.stencil = ##f
+a a
+\revert Score.BarLine.stencil
+a a a
+@end lilypond
+
+This rather common operation has a shortcut @code{\omit}:
+
 @lilypond[quote,verbatim,relative=1]
 a1 a
 \omit Score.BarLine
@@ -3203,11 +3214,20 @@ a a a
 @unnumberedsubsubsec Making objects transparent
 
 @cindex transparent, making objects
+@funindex \hide
 
 Every layout object has a transparent property which by default is
 set to @code{#f}.  If set to @code{#t} the object still occupies
 space but is made invisible.
 
+@lilypond[quote,verbatim,relative=2]
+a4 a
+\once \override NoteHead.transparent = ##t
+a a
+@end lilypond
+
+This rather common operation has a shortcut @code{\hide}:
+
 @lilypond[quote,verbatim,relative=2]
 a4 a
 \once \hide NoteHead