Re: Lily version operators documentation

[David Kastrup]

Urs Liska <address@hidden> writes:

> Am 15. Februar 2017 13:03:55 MEZ schrieb Trevor Daniels <address@hidden>:
>>
>>Urs Liska wrote Wednesday, February 15, 2017 8:04 AM
>>
>>> Am 14.02.2017 um 18:27 schrieb Trevor Daniels:
>>>
>>>> As these functions are not intended for the usual LilyPond user I
>>>> don't think the NR is suitable, other than to have them listed in
>>A22.
>>>> Similarly, they will also be listed in the IR under Scheme
>>functions.
>>> 
>>> Are they listed there really?
>>> I was of the impression that the ly:something functions defined in
>>> Scheme are *not* documented anywhere.
>>
>>You're right.  I was misled by the title of A.22 - "Scheme functions".
>>Having explored how this is generated it seems these are actually
>>scheme-callable functions written in C++, if I understand it correctly.
>
> Yes, these are the functions created by LY_DEFINE in C++ files.
>
> If I recall correctly there was discussion about auto-documenting
> "real" Scheme functions too, but I don't know where this went ...

Maybe we should look for some indicator in the doc string?  I think that
a number of Scheme function doc strings are just not suitable for
running through Texinfo.

-- 
David Kastrup