Merge branch 'master' into lilypond/translation

[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 46df47021b5a3e80c4eb853773f4cd53c8f806d8..4254e0a34c12f6696464e7b2610d200171723c40 100644 (file)
--- a/Documentation/snippets/displaying-grob-ancestry.ly
+++ b/Documentation/snippets/displaying-grob-ancestry.ly
@@ -2,9 +2,79 @@
 % generated from Documentation/snippets/new
 % This file is in the public domain.
 %% Note: this file works from version 2.13.10
-\version "2.13.18"
+\version "2.13.29"
 
 \header {
+%% Translation of GIT committish: 0b55335aeca1de539bf1125b717e0c21bb6fa31b
+
+  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 = "