diff mbox series

[bug#63483,4/4] doc: Update documentation about translation languages.

Message ID 73f5f10031a59733dbb450627c61b16983b5cfc5.1683969802.git.gemmaro.dev@gmail.com
State New
Headers show
Series build: Update po4a process. | expand

Commit Message

gemmaro May 13, 2023, 10:36 a.m. UTC 
---
 doc/contributing.texi | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

Comments

Maxim Cournoyer Sept. 1, 2023, 12:49 p.m. UTC | #1 
tags 63483 + moreinfo
quit

Hi gemmaro,

Thanks for doing this!

I have surveyed the series, and I'll need to dive into the details to
see if everything adds up, but it looks good!

We include a GNU ChangeLog in our git commit messages, as mentioned in
info '(guix) Submitting Patches'.  There's a cross-reference to 'info
(standards)Change Logs', which is made available upon installing the
'standards' Guix package (and 'info-reader').  This changelog should be
a high level description of the changes, which is handy when reviewing.

I hope this helps!  I hope to see a v2 soon :-)
diff mbox series

Patch

diff --git a/doc/contributing.texi b/doc/contributing.texi
index 7bf350ee0dc..4c76641d7cc 100644
--- a/doc/contributing.texi
+++ b/doc/contributing.texi
@@ -2270,15 +2270,15 @@  Translating Guix
 @item New po files for the @code{documentation-manual} component must be
       registered by adding the file name to @code{DOC_PO_FILES} in
       @file{po/doc/local.mk}, the generated @file{%D%/guix.xx.texi} manual to
-      @code{info_TEXINFOS} in @file{doc/local.mk} and the generated
-      @file{%D%/guix.xx.texi} and @file{%D%/contributing.xx.texi} to
-      @code{TRANSLATED_INFO} also in @file{doc/local.mk}.
+      @code{TRANSLATED_INFO_TEXINFOS} in @file{doc/local.mk}, the generated
+      @file{%D%/contributing.xx.texi} to @code{TRANSLATED_GUIX_TEXINFOS} also
+      in @file{doc/local.mk}, and @code{po4a_langs} section in
+      @file{po/doc/po4a.cfg}.
 @item New po files for the @code{documentation-cookbook} component must be
-      registered by adding the file name to @code{DOC_COOKBOOK_PO_FILES} in
+      registered by adding the file name to @code{DOC_PO_FILES} in
       @file{po/doc/local.mk}, the generated @file{%D%/guix-cookbook.xx.texi}
-      manual to @code{info_TEXINFOS} in @file{doc/local.mk} and the generated
-      @file{%D%/guix-cookbook.xx.texi} to @code{TRANSLATED_INFO} also
-      in @file{doc/local.mk}.
+      manual to @code{TRANSLATED_INFO_TEXINFOS} in @file{doc/local.mk}, and
+      @code{po4a_langs} section in @file{po/doc/po4a.cfg}.
 @item New po files for the @code{website} component must be added to the
       @code{guix-artwork} repository, in @file{website/po/}.
       @file{website/po/LINGUAS} and @file{website/po/ietf-tags.scm} must