Re: Add an expert font tree interface (issue 108700043 by address@hidden)

[David Kastrup]

address@hidden writes:

> 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
>>
>> > 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.

Correct.  Only the DOC strings of C functions or music functions (and
the syntactically similar "scheme functions" defined with
define-scheme-function and define-void-function).  Functions to be
called from Scheme and defined in Scheme are not automatically mentioned
in the documentation.

But that does not mean that they should not receive a documentation
string.  One will look it up via Scheme (from a command prompt via help)
or by looking at the definition.

> https://codereview.appspot.com/108700043/


-- 
David Kastrup