Lots of warnings and errors when building texinfo-docs with po4a-traslated texinfo.texi

[hwhsu1231]

Problem Description

Hello, Po4a Maintainance Team.

Recently, I tried to use po4a to traslate texinfo documentation.

The following commands are what I used:

git clone --depth=1 https://git.savannah.gnu.org/git/texinfo.git
cd texinfo
./autogen.sh
./configure -C CFLAGS='-g' PERL_EXT_CFLAGS='-g'
mv doc/texinfo.texi doc/texinfo-en.texi
po4a-updatepo -f texinfo -m doc/texinfo-en.texi -p doc/texinfo.po
po4a-translate -f texinfo -k 0 -m doc/texinfo-en.texi -p doc/texinfo.po -l doc/texinfo.texi
make

However, there are lots of warnings and errors in the final step, make.

Click to expand the wanrings and errors

texinfo.texi:1566: warning: unexpected argument on @nodedescriptionblock line: The @code{@@title}, @code{@@subtitle}, and
texinfo.texi:1646: warning: unexpected argument on @nodedescriptionblock line: The @code{@@titlefont}, @code{@@center}, and
texinfo.texi:1715: warning: unexpected argument on @nodedescriptionblock line: How to write the copyright notice and include copying
texinfo.texi:2654: warning: unexpected argument on @nodedescriptionblock line: @code{@@nodedescription} and
texinfo.texi:4561: warning: unexpected argument on @nodedescriptionblock line: Marking words and phrases as code, keyboard input,
texinfo.texi:7177: warning: @caption should not appear on @float line
texinfo.texi:7177: warning: @caption should be right below `@float'
texinfo.texi:8739: expected @frenchspacing on or off, not `on This is text. Two sentences. Three sentences. French'
texinfo.texi:8742: expected @frenchspacing on or off, not `off This is text. Two sentences. Three sentences. Non-French'
texinfo.texi:9170: misplaced {
texinfo.texi:9170: misplaced {
texinfo.texi:9170: misplaced }
texinfo.texi:9170: misplaced }
texinfo.texi:9170: warning: unexpected argument on @displaymath line: f(x) = 1\over\sigma\sqrt2\pi
texinfo.texi:11129: must be after `@defline' to use `@defline'
texinfo.texi:11129: warning: @deftypeline should only appear at the beginning of a line
texinfo.texi:11129: must be after `@deftypeline' to use `@deftypeline'
texinfo.texi:11129: warning: missing category for @deftypeline
texinfo.texi:11129: warning: unexpected argument on @defblock line: @defline Macro mac (arg1, arg2)  Description of mac.  @deftypeline

texinfo.texi:11155: must be after `@defline' to use `@defline'
texinfo.texi:11155: warning: @defline should only appear at the beginning of a line
texinfo.texi:11155: must be after `@defline' to use `@defline'
texinfo.texi:11155: warning: missing name for @defline
texinfo.texi:11155: warning: unexpected argument on @defblock line: @defline Function set-var (value)  @defline {Settable Variable}

texinfo.texi:11692: warning: unexpected argument on @iflatex line: Moreover, this text will only appear in @LaTeX{}.
texinfo.texi:13062: warning: unexpected argument on @defblock line: (int @var{one}, int @var{two}, @ int
texinfo.texi:13650: warning: @itemize should only appear at the beginning of a line
texinfo.texi:13650: warning: @item should not appear on @itemize line
texinfo.texi:13650: @item outside of table or list
texinfo.texi:13661: warning: @end should only appear at the beginning of a line
texinfo.texi:17962: warning: @vtable should only appear at the beginning of a line
texinfo.texi:17962: missing @vtable argument
texinfo.texi:17963: warning: command `@code' must not be followed by new line
texinfo.texi:17964: @code expected braces
texinfo.texi:21246: warning: unexpected argument on @nodedescriptionblock line: How to structure a Texinfo file for using the updating
texinfo.texi:21309: warning: unexpected argument on @nodedescriptionblock line: How to create and update nodes and menus when using
texinfo.texi:21397: warning: unexpected argument on @nodedescriptionblock line: How to structure outer file and include files for the
texinfo.texi:21424: warning: unexpected argument on @nodedescriptionblock line: How to indent descriptions, insert missing nodes
texinfo.texi:21600: warning: unexpected argument on @nodedescriptionblock line: Two Info formatting commands written in Emacs Lisp are
texinfo.texi:22457: warning: unexpected argument on @nodedescriptionblock line: How to create an unsplit file and add a tag table for
texinfo.texi:22674: warning: unexpected argument on @nodedescriptionblock line: An option for turning headings on and off and double
texinfo.texi:7121: @ref reference to nonexistent node `fig:ex1'
make[3]: *** [Makefile:1837: texinfo.info] Error 1
make[3]: Leaving directory '/home/hwhsu1231/Repo/testing/texinfo/doc'
make[2]: *** [Makefile:2103: all-recursive] Error 1
make[2]: Leaving directory '/home/hwhsu1231/Repo/testing/texinfo/doc'
make[1]: *** [Makefile:1769: all-recursive] Error 1
make[1]: Leaving directory '/home/hwhsu1231/Repo/testing/texinfo'
make: *** [Makefile:1708: all] Error 2

It seems that po4a utilities cannot properly translate the texinfo.texi with the texinfo.po in the correct syntax.

Versions and Platforms

• OS version: Kubuntu 22.04
• Po4a version: 0.71
• Perl version: v5.34.0
• Texinfo Commit: e4a19ed9c9f57c3130f355c524b82bf65449bc53

Additional Information

• Full Logs: LOG-build-texinfo-docs-with-po4a.txt
• Original Texinfo.texi: texinfo-en.zip
• Generated Texinfo.po: texinfo-po.zip
• Translated Texinfo.texi: texinfo.zip

[mquinson]

Hello,

unfortunately, we need a new maintainer for the TexInfo module, that is still alpha and not ready for production. Patches would be more useful than bug reports, as no one in the po4a team seem to really understand the implementation of this module.

Sorry about that,
Mt

[Fat-Zer]

It looks like most of the problems comes from the fact that the module just lacks definition for several texinfo commands.
@hwhsu1231, if you still need it I believe I can ticker with it a bit.