From: Trevor Daniels <t.daniels@treda.co.uk>
Date: Mon, 2 Feb 2009 10:18:18 +0000 (+0000)
Subject: Docs: NR 1.8 Text: Clarify use of fetaBraces
X-Git-Tag: release/2.12.3-1~59
X-Git-Url: https://git.donarmstrong.com/lilypond.git?a=commitdiff_plain;h=f3d217ed0b93bf88eddfcb3cc1ca11f3bbf11e3b;p=lilypond.git

Docs: NR 1.8 Text: Clarify use of fetaBraces
(cherry picked from commit 9b573e8e9365a4c6d0b302f5c6ae3b0e5c85df11)
---

diff --git a/Documentation/user/text.itely b/Documentation/user/text.itely
index 485ef646b9..b235dfda08 100644
--- a/Documentation/user/text.itely
+++ b/Documentation/user/text.itely
@@ -1062,14 +1062,10 @@ c16
 c2^\markup { \musicglyph #"timesig.neomensural94" }
 @end lilypond
 
-@c TODO: add \lookup here? -vv
-@c Probably better not to document \lookup, which is useful only for
-@c printing braces, and instead document \left-brace and \right-brace
-@c when these become available  -td
-
 @noindent
-Another way of printing non-text glyphs is described
-in @ref{Fonts explained}.
+Another way of printing non-text glyphs is described in
+@ref{Fonts explained}.  This is useful for printing braces of
+various sizes.
 
 The markup mode also supports diagrams for specific
 instruments:
@@ -1204,6 +1200,7 @@ and how they may be changed in scores.
 
 @cindex Pango
 @cindex fonts, explained
+@cindex braces, various sizes
 @funindex font-interface
 
 Fonts are handled through several libraries.
@@ -1231,8 +1228,17 @@ a1^\markup {
 @end lilypond
 
 @noindent
-A simpler, but more limited syntax is also described in
-@ref{Music notation inside markup}.
+However, all these glyphs except the braces of various sizes
+contained in @code{fetaBraces} are available using the
+simpler syntax described in @ref{Music notation inside markup}.
+
+When using the glyphs contained in @code{fetaBraces}, the size of
+the brace is specified by the numerical part of the glyph name, in
+arbitrary units.  Any integer from @code{0} to @code{575} inclusive
+may be specified, @code{0} giving the smallest brace.  The optimum
+value must be determined by trial and error.  These glyphs are all
+left braces; right braces may be obtained by rotation, see
+@ref{Rotating objects}.
 
 Three families of text fonts are made available: the
 @emph{roman} (serif) font, that defaults to New Century