Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

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

Open
hwhsu1231 opened this issue May 12, 2024 · 1 comment

Comments

@hwhsu1231
Copy link
Contributor

hwhsu1231 commented May 12, 2024

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

@mquinson
Copy link
Owner

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants