Re: Doc: NR 1.8.2 - add \abs-fontsize to main doc (issue 5969060)

[pkx166h]

Reviewers: Trevor Daniels,

Message:
committer       James Lowe <address@hidden>       
Sun, 8 Apr 2012 11:14:39 +0000 (12:14 +0100)
commit  dd8a0b7cc3280f273e66d20c72f1d4097dc6645a

Pushed as that had had a 'push' approval from GP and the additional
corrections from TD were trivial.


http://codereview.appspot.com/5969060/diff/2001/Documentation/notation/text.itely
File Documentation/notation/text.itely (right):

http://codereview.appspot.com/5969060/diff/2001/Documentation/notation/text.itely#newcode544
Documentation/notation/text.itely:544: It can be set to a fixed value,
On 2012/04/01 22:25:17, Trevor Daniels wrote:
> Better to re-emphasize this is _relative_ to the value set by the
global staff
> size, perhaps by saying, "It can be increased or decreased relative to
the value
> set by the global staff size,"  Maybe include \fontsize #-2 in the
example below
> to show sizes smaller than that set by the global staff size can be
specified.

Done.

I also swapped the order of the examples round (no other changes) so
that it was more natural a progression in describing what was changing
in each case.

Description:
Doc: NR 1.8.2 - add \abs-fontsize to main doc

Issue 2435

Updated examples with clearer explanations/examples
and included \abs-fontsize as an @lilypond

added @funindex for \abs-fontsize

Please review this at http://codereview.appspot.com/5969060/

Affected files:
  M Documentation/notation/text.itely


Index: Documentation/notation/text.itely
diff --git a/Documentation/notation/text.itely  
b/Documentation/notation/text.itely
index  
3ba9e554a6342262a9ee34cbd49c02165b147ad5..505f739c24272518a50a22a5de0300b7a1badeeb  
100644
--- a/Documentation/notation/text.itely
+++ b/Documentation/notation/text.itely
@@ -520,6 +520,7 @@ f1 d2 r
 @cindex font size
 @cindex text size

address@hidden \abs-fontsize
 @funindex \fontsize
 @funindex fontsize
 @funindex \smaller
@@ -529,38 +530,40 @@ f1 d2 r
 @funindex \magnify
 @funindex magnify

-The size of the characters can also be altered in different ways:
address@hidden
address@hidden
-the font size can be set to predefined standard sizes,
+The font size can be altered, relative to the global staff size, in a
+number of different ways

address@hidden
-the font size can be set to an absolute value,
+It can be set to predefined size,

address@hidden
-the font size can also be changed relatively to its previous value.
address@hidden itemize
address@hidden,verbatim,relative=2]
+b1_\markup { \huge Sinfonia }
+b1^\markup { \teeny da }
+b1-\markup { \normalsize camera }
address@hidden lilypond

address@hidden
-The following example demonstrates these three methods:
+It can be set to a fixed value,

address@hidden,verbatim,relative=1]
-f1_\markup {
-  \tiny espressivo
-  \large e
-  \normalsize intenso
-}
-a^\markup {
-  \fontsize #5 Sinfonia
-  \fontsize #2 da
-  \fontsize #3 camera
-}
-bes^\markup { (con
-  \larger grande
-  \smaller emozione
-  \magnify #0.6 { e sentimento } )
-}
-d c2 r8 c bes a g1
address@hidden,verbatim,relative=2]
+b1_\markup { \fontsize #5 Sinfonia }
+b1^\markup { \fontsize #1 da }
+b1-\markup { \fontsize #3 camera }
address@hidden lilypond
+
+It can be set relative to its previous value,
+
address@hidden,verbatim,relative=2]
+b1_\markup { \larger Sinfonia }
+b1^\markup { \smaller da }
+b1-\markup { \magnify #0.6  camera }
address@hidden lilypond
+
+It can also be set to a fixed point-size, regardless of the global staff
+size,
+
address@hidden,verbatim,relative=2]
+b1_\markup { \abs-fontsize #20 Sinfonia }
+b1^\markup { \abs-fontsize #8 da }
+b1-\markup { \abs-fontsize #14 camera }
 @end lilypond

 @cindex subscript