Docs: run convert-ly for 2.14.0.

[lilypond.git] / Documentation / snippets / displaying-grob-ancestry.ly

diff --git a/Documentation/snippets/displaying-grob-ancestry.ly b/Documentation/snippets/displaying-grob-ancestry.ly
index d26184ffb60a1704099dbd6d47675ced5dde662d..bb7a22ac323ad46f4acfca64871971a16810b7cd 100644 (file)
--- a/Documentation/snippets/displaying-grob-ancestry.ly
+++ b/Documentation/snippets/displaying-grob-ancestry.ly
@@ -1,26 +1,112 @@
-%% Do not edit this file; it is automatically
-%% generated from LSR http://lsr.dsi.unimi.it
-%% This file is in the public domain.
-\version "2.13.10"
+% DO NOT EDIT this file manually; it is automatically
+% generated from Documentation/snippets/new
+% Make any changes in Documentation/snippets/new/
+% and then run scripts/auxiliar/makelsr.py
+%
+% This file is in the public domain.
+%% Note: this file works from version 2.13.36
+\version "2.14.0"
 
 \header {
+%% Translation of GIT committish: 59caa3adce63114ca7972d18f95d4aadc528ec3d
+
+  texidoces = "
+Al trabajar con los callbacks de un grob, puede ser de mucha ayuda
+entender el @qq{árbol genealógico} de un grob.  La mayor parte de los
+grobs tienen @qq{padres} que influyen en el posicionamiento del grob.
+los padres X e Y influyen en las posiciones horizontal y vertical del
+grob, respectivamente.  Además, cada pade puede tener padres a su vez.
+
+
+Por desgracia, existen varios aspectos de la genealogía de un grob que
+pueden llevar a confusión:
+
+
+@itemize
+
+@item Los tipos de padre que tiene un grob pueden depender del
+contexto.
+
+@item Para ciertos grobs, los padres X e Y son el mismo.
+
+@item Un @qq{ancestro} concreto puede estar relacionado con un grob de
+mas de una manera.
+
+@item El concepto de @qq{generaciones} es engañoso.
+
+@end itemize
+
+
+Por ejemplo, el grob @code{System} puede ser tanto un padre (sobre el
+lado Y) como un abuelo (dos veces en el lado X) de un grob
+@code{VerticalAlignment}.
+
+
+Este macro imprime, en la consola, una representación textual de la
+genealogía de un grob.
+
+
+Cuando se llama de esta forma
+
+@example
+@{
+   \\once \\override NoteHead #'before-line-breaking = #display-ancestry
+   c4
+@}
+@end example
+
+
+Se genera la siguiente salida:
+
+
+@example
+------------------------------------
+
+NoteHead X,Y: NoteColumn
+    X: PaperColumn
+       X,Y: System
+    Y: VerticalAxisGroup
+       X: NonMusicalPaperColumn
+          X,Y: System
+       Y: VerticalAlignment
+          X: NonMusicalPaperColumn
+             X,Y: System
+          Y: System
+@end example
+
+"
+
+  doctitlees = "Imprimir el árbol genealógico de un grob"
+
   lsrtags = "tweaks-and-overrides"
 
   texidoc = "
 When working with grob callbacks, it can be helpful to understand a
-grob's @qq{ancestry}. Most grobs have @qq{parents} which influence the
-positioning of the grob. X- and Y-parents influence the horizontal and
-vertical positions for the grob, respectively. Additionally, each
+grob's @qq{ancestry}.  Most grobs have @qq{parents} which influence the
+positioning of the grob.  X- and Y-parents influence the horizontal and
+vertical positions for the grob, respectively.  Additionally, each
 parent may have parents of its own.
 
 
-Unfortunately, there are several aspects of a grob's ancestry can lead
-to confusion:
+Unfortunately, there are several aspects of a grob's ancestry that can
+lead to confusion:
+
+
+@itemize
+
+@item
+The types of parents a grob has may depend on context.
+
+@item
+For some grobs, the X- and Y-parents are the same.
 
-* The types of parents a grob has may depend on context. * For some
-grobs, the X- and Y-parents are the same. * A particular @qq{ancestor}
-may be related to a grob in multiple ways. * The concept of
-@qq{generations} is misleading.
+@item
+A particular @qq{ancestor} may be related to a grob in multiple ways.
+
+@item
+The concept of @qq{generations} is misleading.
+
+@end itemize
 
 
 For example, the @code{System} grob can be both parent (on the Y-side)
@@ -34,15 +120,18 @@ ancestry.
 
 When called this way
 
-
+@example
 @{
- \\once \\override NoteHead #'before-line-breaking = #display-ancestry
- c @}
+   \\once \\override NoteHead #'before-line-breaking = #display-ancestry
+   c4
+@}
+@end example
 
 
 The following output is generated:
 
 
+@example
 ------------------------------------
 
 NoteHead X,Y: NoteColumn
@@ -55,13 +144,14 @@ NoteHead X,Y: NoteColumn
           X: NonMusicalPaperColumn
              X,Y: System
           Y: System
-
+@end example
 
 
 "
   doctitle = "Displaying grob ancestry"
 } % begin verbatim
 
+
 #(define (grob-name grob)
    (if (ly:grob? grob)
        (assoc-ref (ly:grob-property grob 'meta) 'name)
@@ -113,9 +203,8 @@ NoteHead X,Y: NoteColumn
 
 \relative c' {
   \once \override NoteHead #'before-line-breaking = #display-ancestry
-  f
+  f4
   \once \override Accidental #'before-line-breaking = #display-ancestry
   \once \override Arpeggio #'before-line-breaking = #display-ancestry
-  <f as c>\arpeggio
+  <f as c>4\arpeggio
 }
-