From: David Kastrup <dak@gnu.org>
Date: Sun, 14 Sep 2014 12:58:08 +0000 (+0200)
Subject: Issue 4100: IR: Fix subproperty and default-child descriptions in context docs
X-Git-Tag: release/2.19.15-1~21
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=7d22853fd151390456712123e946b38f3dc02655;p=lilypond.git

Issue 4100: IR: Fix subproperty and default-child descriptions in context docs
---

diff --git a/scm/document-translation.scm b/scm/document-translation.scm
index 442c2659bb..3476419ba1 100644
--- a/scm/document-translation.scm
+++ b/scm/document-translation.scm
@@ -143,8 +143,7 @@
            (path (cdr args)))
 
         (string-append
-         (format #f "@item Set grob-property @code{~a} "
-                 (string-join (map symbol->string path) " "))
+         (format #f "@item Set grob-property @code{~{~a~^.~}} " path)
          (format #f "in @ref{~a} to" context-sym)
          (if (pretty-printable? value)
            (format #f ":~a\n" (scm->texi value))
@@ -166,6 +165,7 @@
          (accepts (assoc-get 'accepts context-desc))
          (consists (assoc-get 'consists context-desc))
          (props (assoc-get 'property-ops context-desc))
+         (defaultchild (assoc-get 'default-child context-desc))
          (grobs  (context-grobs context-desc))
          (grob-refs (map ref-ify (sort grobs ly:string-ci<?))))
 
@@ -198,8 +198,13 @@
                   "@end itemize\n")))
            "")
 
+       (if defaultchild
+           (format #f "\n\nThis is not a `Bottom' context; search for such a one will commence after creating an implicit context of type @ref{~a}."
+                   defaultchild)
+           "\n\nThis is a `Bottom' context; no contexts will be created implicitly from it.")
+
        (if (null? accepts)
-           "\n\nThis context is a `bottom' context; it cannot contain other contexts."
+           "\n\nThis context cannot contain other contexts."
            (string-append
             "\n\nContext "
             name