GNU bug report logs - #35786
Some manual @ref @xref @pxref fail when untranslated

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: "pelzflorian (Florian Pelz)" <pelzflorian <at> pelzflorian.de>
Subject: bug#35786: closed ([bug#35786] Re: Some manual @ref @xref @pxref
 fail when untranslated)
Date: Sat, 11 Jun 2022 11:25:01 +0000

[Message part 1 (text/plain, inline)]

Your bug report

#35786: Some manual @ref @xref @pxref fail when untranslated

which was filed against the guix package, has been closed.

The explanation is attached below, along with your original report.
If you require more details, please reply to 35786 <at> debbugs.gnu.org.

-- 
35786: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=35786
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: "pelzflorian (Florian Pelz)" <pelzflorian <at> pelzflorian.de>
To: 35786-done <at> debbugs.gnu.org
Subject: [bug#35786] Re: Some manual @ref @xref @pxref fail when untranslated
Date: Sat, 11 Jun 2022 13:24:19 +0200

On Sat, May 18, 2019 at 12:48:26AM +0200, pelzflorian (Florian Pelz) wrote:
> […]po4a-translate transforms […]to[…]
> （@pxref{Packages
> with Multiple
> Outputs}），

Julien fixed it with 0623138ffa5b066afc25547ffdeb97753cb0ee9a

Closing.

Regards,
Florian

[Message part 3 (message/rfc822, inline)]

From: "pelzflorian (Florian Pelz)" <pelzflorian <at> pelzflorian.de>
To: Meiyo Peng <meiyo <at> riseup.net>
Cc: Guix-devel <guix-devel <at> gnu.org>, Julien Lepiller <julien <at> lepiller.eu>,
 bug-guix <at> gnu.org
Subject: Some manual @ref @xref @pxref fail when untranslated
Date: Sat, 18 May 2019 00:48:26 +0200

[Message part 4 (text/plain, inline)]

Meiyo Peng reports at <https://lists.gnu.org/archive/html/guix-devel/2019-05/msg00275.html>

On Tue, May 14, 2019 at 10:29:35AM +0800, Meiyo Peng wrote:
> I just find out that the @pxref{Packages with Multiple Outputs} in
> doc/contributing.texi has to be translated.  Or I will get an error
> while running make:
> 
> #+begin_example
>   doc/contributing.zh_CN.texi:567: @pxref reference to nonexistent node `Packages with Multiple Outputs'
> #+end_example
> 
> I guess it's because the node name is in doc/guix.texi (another file
> than doc/contributing.texi).  Any idea?
> 

The reason appears to be that when not translating (using the first
attached patch that reverts back to @pxref{Packages with Multiple
Outputs}), po4a-translate transforms

@item
Take a look at the profile reported by @command{guix size}
(@pxref{Invoking guix size}).  This will allow you to notice references
to other packages unwillingly retained.  It may also help determine
whether to split the package (@pxref{Packages with Multiple Outputs}),
and which optional dependencies should be used.  In particular, avoid adding
@code{texlive} as a dependency: because of its extreme size, use
@code{texlive-tiny} or @code{texlive-union} instead.

to

@item
看一下@command{guix size}（@pxref{Invoking guix
size}）的分析报告。这会让你注意到对其它软件包无意中的引用。它也可以帮助决定是否要把一个软件包分割成几个输出（@pxref{Packages
with Multiple
Outputs}），以及需要使用哪些可选的依赖。特别地，避免把@code{texlive}添加为依赖：因为它太大了，请使用@code{texlive-tiny}或@code{texlive-union}代替它。

with the pxref split over three lines because the surrounding context
has no space characters.  doc/local.mk’s xref_command can only deal
with two lines however.

The second attached patch makes xref_command grep three-line
references too, so it finds the translation, *however* I cannot get
this multiline sed to actually insert the translation into three line
references.  Perhaps it would be better to just replace this complex
xref_command with Guile code?  I will not do it however.

I am Cc’ing the bug-guix <at> gnu.org; I hope this is OK.

Regards,
Florian

[0001-THIS-IS-A-TEST-Revert-to-not-translating-pxref-refer.patch (text/plain, attachment)]

[0002-doc-Insufficient-attempt-to-fix-translation-of-three.patch (text/plain, attachment)]

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.