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>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#35786: closed (Some manual @ref @xref @pxref fail when
 untranslated)
Date: Sat, 11 Jun 2022 11:25:01 +0000

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

Your message dated Sat, 11 Jun 2022 13:24:19 +0200
with message-id <20220611112349.prups45xtbvuaup7 <at> pelzflorian.localdomain>
and subject line [bug#35786] Re: Some manual @ref @xref @pxref fail when untranslated
has caused the debbugs.gnu.org bug report #35786,
regarding Some manual @ref @xref @pxref fail when untranslated
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> 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: 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 3 (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)]

[Message part 6 (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

Previous Next

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