bug-lilypond
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Bug: Repeated chords (via "q") are not rendered when using ly:book-p


From: Werner LEMBERG
Subject: Re: Bug: Repeated chords (via "q") are not rendered when using ly:book-process.
Date: Tue, 02 Apr 2024 15:17:16 +0000 (UTC)

>> In contrast to Jean, I have a different point of view.  I think it
>> would be *very* valuable to have documentation strings of *all*
>> functions that might be useful in the long run
> 
> Oh, that's also my point of view — it *would* be very valuable.
> Just... IMO not realistic. It already took me weeks to write the
> extending-lilypond guide (not counting the effort to understand the
> code base in the first place). "rg '```\{func\}' | wc -l" tells me
> that currently 76 functions are documented in the guide, so the
> multiplier to get more usable documentation for all functions that
> are already documented is already ~10, and there are the
> undocumented ones also.

I'm very grateful for your work (and I should eventually have a closer
look whether some of the documentation can be ported to the IR)!
However, you probably did a systematic approach to the functions as
needed for the guide – this is something I don't suggest here.
Instead, I plead that interested users who stumble upon insufficient
documentation should be encouraged to provide patches *for whatever
they are interested in*.  No need for being thorough; even the
smallest breadcrumbs are potentially useful for all users.


    Werner

reply via email to

[Prev in Thread] Current Thread [Next in Thread]