[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Lily version operators documentation
From: |
David Kastrup |
Subject: |
Re: Lily version operators documentation |
Date: |
Wed, 15 Feb 2017 13:43:11 +0100 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/26.0.50 (gnu/linux) |
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