Some slight Documentation changes for \hide/\omit

diff --git a/Documentation/notation/ancient.itely b/Documentation/notation/ancient.itely
index 84d5cec14aac7d5da358b69c2ad541c3fcd4e045..67aefbd86d0fbb92a38dec37565962d91c9f8029 100644 (file)
--- 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 9e0f0e474eed113bab8400639a2f852bdabd0887..f91cb0d2235eea67e4c46ebf5b97c45ff074b9e1 100644 (file)
--- 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