On 2014/07/16 17:13:27, J_lowe wrote:
> On 2014/07/16 09:20:45, dak wrote: >> There is no doc string here or other documentation. > > I wrote one now; didn't do it because I started with a copy of > make-pango-font-tree, and it does not have one as well (I know, not
the
> best reason). > Is there some place but the font.scm itself where it can be seen
live?
> It is not built into the docs, right?
http://lilypond.org/doc/v2.18/Documentation/internals/
That's why I ask: it does not show up there. Not in the list of scheme functions, where I expected it (at least for the publicly defined functions), nor anywhere else AFAICS. And it seems that it's not just that I wrote a faulty docstring; e.g. I could not find any mention of add-music-fonts or any other function from scm/*.scm I looked for. Do I need to build the IR with some specific flag? The Contributor's Guide, 5.8, only says: "Material in the Internals reference is generated automatically from our source code. Any doc work on Internals therefore requires modifying files in 'scm/*.scm'. Texinfo is allowed in these docstrings." Or am I completely mistaken what a docstring is in Scheme? Best, your confused Alexander https://codereview.appspot.com/108700043/ _______________________________________________ lilypond-devel mailing list lilypond-devel@gnu.org https://lists.gnu.org/mailman/listinfo/lilypond-devel