[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