Re: Documentation of music functions

[Carl D. Sorensen]

On 11/5/08 8:49 AM, "Valentin Villenave" <address@hidden> wrote:

> 2008/11/5 Carl D. Sorensen <address@hidden>:
>
>> Thanks for answering my questions.  So I guess that developers should write
>> the doc strings without the _i, and the translators will add the _i when
>> they translate the doc string?
>
> ... Or developers can write doc strings with _i anyway, just in case
> someone wants to translate them at some later point. That being said,
> I can't remember having seen any Scheme function localized yet
> (whereas the C++ code it generally well localized, though not
> necessarily translated).

There are some _i strings in scm/music-functions.scm, which is how I knew to
even ask the questions.

>
>> I wasn't asking for this documentation in the NR, but it needs to be
>> somewhere, IMO.
>
> As a matter of fact, doc strings for music-functions are currently not
> gathered anywhere AFAICT (unlike markup commands, or instance). So
> localizing them or not doesn't really matter; moreover
> automatically-generated doc pages (such as the IR and NR Appendices)
> will probably never be translated (not in decades to come, at least).

There is a page in the NR (NR 6.1.7) which appears to be a gathering of
doc-strings in the file identifiers.tely.

That's what got me started on this whole issue.

Thanks,

Carl