On Mon, Nov 24, 2025 at 09:46:14PM +0100, Patrice Dumas wrote:
> On Mon, Nov 24, 2025 at 06:37:25PM +0000, Gavin Smith wrote:
> > On Mon, Nov 24, 2025 at 05:18:33PM +0000, Gavin Smith wrote:
> > > It seems like it would be very easy to assume the word "category" is
> > > followed
> > > by the word "of" rather than the word "on" ("category on" is not idiomatic
> > > English), leading to a mistranslation. The other string which can be used
> > > uses "name" as a placeholder, not "category", which seems much more
> > > appropriate.
>
> The two strings correspond to two different cases, and different @def*
> commands as shown in the TRANSLATORS comment:
I see, "name" and "category" are used consistently in the document strings.
"Name" is the name of the method (for @deftypemethod) and "category"
is the word "Method" (or translation thereof).
The word "category" is used consistently in the Texinfo documentation
for the type of object being documented and indexed.
I don't have a suggestion to replace the word "category".
This makes me think that the comment for translators is wrong:
#. TRANSLATORS: association of a method or operation name with a class
#. in descriptions of object-oriented programming methods or operations.
#: tta/perl/Texinfo/Convert/Utils.pm:356 tta/perl/Texinfo/Convert/Utils.pm:360
#: tta/perl/Texinfo/Convert/Utils.pm:364 tta/C/main/convert_utils.c:756
#: tta/C/main/convert_utils.c:766
#, perl-brace-format
msgid "{category} on @code{{class}}"
msgstr "{category} de @code{{class}}"
Here "category" is not the name of a method or operation.
The comment should be different from the following comment but it is
identicial.
>
> #. TRANSLATORS: association of a method or operation name with a class
> #. in descriptions of object-oriented programming methods or operations.
> #: tta/perl/Texinfo/Translations.pm:588 tta/C/parsetexi/indices.c:493
> #, perl-brace-format
> msgid "{name} on {class}"
> msgstr ""
