Re: New hosting for Urs Liska's Scheme WIP book

[David Kastrup]

David Kastrup <dak@gnu.org> writes:

> Jean Abou Samra <jean@abou-samra.fr> writes:
>
>> Le 04/11/2022 à 12:09, Jean Abou Samra a écrit :
>>> Also, you will have surprises with \relative because
>>> the note appears twice, with its octave marks. You
>>> can use make-relative to fix that.
>>
>> P.S. The Internals Reference gives a (quite technical) explanation of
>> make-relative:
>>
>> https://lilypond.org/doc/v2.23/Documentation/internals/scheme-functions
>
> That description is a bunch of incomprehensible gobbledegook unsuitable
> for figuring out anything you don't know already.
>
> Whoever wrote that...  Wait, that was me.
>
> Scheme function doc strings were not printed in the manuals back then
> but that is not much of a defense.  Maybe I need to try again.  Or
> someone else, assuming that anybody understands what this is supposed to
> do.

Ok, I'll give the doc text another try, but the documentation block in
the manual starts with:

    Macro: make-relative …

which is missing the input arguments from

    (define-syntax-rule-public (make-relative (variables ...) reference music)

Is that fixable in some manner?  If necessary, creating a
LilyPond-specific version of define-syntax-rule-public ?

-- 
David Kastrup