Received: from malur.postgresql.org ([217.196.149.56])
	by arkaria.postgresql.org with esmtps
 (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <pgsql-docs-owner+archive@lists.postgresql.org>)
	id 1oOQ66-0002ul-P4
	for pgsql-docs@arkaria.postgresql.org; Wed, 17 Aug 2022 20:57:06 +0000
Received: from localhost ([127.0.0.1] helo=malur.postgresql.org)
	by malur.postgresql.org with esmtp (Exim 4.92)
	(envelope-from <pgsql-docs-owner+archive@lists.postgresql.org>)
	id 1oOQ65-000726-Kl
	for pgsql-docs@arkaria.postgresql.org; Wed, 17 Aug 2022 20:57:05 +0000
Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29])
	by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <bruce@momjian.us>)
	id 1oOQ65-00071x-DF
	for pgsql-docs@lists.postgresql.org; Wed, 17 Aug 2022 20:57:05 +0000
Received: from momjian.us ([72.94.173.45])
	by magus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
	(Exim 4.92)
	(envelope-from <bruce@momjian.us>)
	id 1oOQ62-0001Sj-UU
	for pgsql-docs@lists.postgresql.org; Wed, 17 Aug 2022 20:57:04 +0000
Received: from bruce by momjian.us with local (Exim 4.94.2)
	(envelope-from <bruce@momjian.us>)
	id 1oOQ5x-001iyN-PY; Wed, 17 Aug 2022 16:56:57 -0400
Date: Wed, 17 Aug 2022 16:56:57 -0400
From: Bruce Momjian <bruce@momjian.us>
To: Daniel Gustafsson <daniel@yesql.se>
Cc: goran.luledzija@gmail.com, Pg Docs <pgsql-docs@lists.postgresql.org>,
	Peter Eisentraut <peter.eisentraut@enterprisedb.com>,
	Georgios <gkokolatos@protonmail.com>
Subject: Re: Update documentation page for translators
Message-ID: <Yv1WGYHevqZCmdU7@momjian.us>
References: <163490116698.684.10398197970578456928@wrigleys.postgresql.org>
 <84001965-130C-4622-A7ED-DAEACF7A3BCC@yesql.se>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <84001965-130C-4622-A7ED-DAEACF7A3BCC@yesql.se>
List-Id: <pgsql-docs.lists.postgresql.org>
List-Help: <https://lists.postgresql.org/manage/>
List-Subscribe: <https://lists.postgresql.org/manage/>
List-Post: <mailto:pgsql-docs@lists.postgresql.org>
List-Owner: <mailto:pgsql-docs-owner@lists.postgresql.org>
List-Archive: <https://www.postgresql.org/list/pgsql-docs>
Archived-At: 
 <https://www.postgresql.org/message-id/Yv1WGYHevqZCmdU7%40momjian.us>
Precedence: bulk


Is there a reason this patch was not applied?

---------------------------------------------------------------------------

On Fri, Nov 12, 2021 at 02:46:40PM +0100, Daniel Gustafsson wrote:
> > On 22 Oct 2021, at 13:12, PG Doc comments form <noreply@postgresql.org> wrote:
> > 
> > The following documentation comment has been logged on the website:
> > 
> > Page: https://www.postgresql.org/docs/11/nls-translator.html
> > Description:
> > 
> > In the documentation for translators
> > (https://www.postgresql.org/docs/11/nls-translator.html) it is mentioned to
> > use any text editor for translating .po files. It can be very error prone
> > with regular text editors, especiially for non-tech people such as
> > translators.
> 
> I think this makes sense, having done some translation work myself I agree that
> the PO editors out there can help quite a bit.  Now, I'm sure anyone interested
> is perfectly capable of Googling, but since this chapter is there to help
> potential or new contributors I think it's fine to lower the bar and be a bit
> more verbose.
> 
> I don't feel like linking to any specific tool though, so I just added a small
> sentence to indicate that options exist, and that we don't necessarily require
> anyone to use a text editor.
> 
> CC:ing developers who have spent time with translations for input.
> 
> --
> Daniel Gustafsson		https://vmware.com/
> 

> diff --git a/doc/src/sgml/nls.sgml b/doc/src/sgml/nls.sgml
> index d49f44f3f2..0b3c638594 100644
> --- a/doc/src/sgml/nls.sgml
> +++ b/doc/src/sgml/nls.sgml
> @@ -202,7 +202,9 @@ make update-po
>     <title>Editing the PO Files</title>
>  
>     <para>
> -    The PO files can be edited with a regular text editor.  The
> +    The PO files can be edited with a regular text editor. There are also
> +    several specialized editors for PO files which can help the process with
> +    translation specific features.  The
>      translator should only change the area between the quotes after
>      the msgstr directive, add comments, and alter the fuzzy flag.
>      There is (unsurprisingly) a PO mode for Emacs, which I find quite


-- 
  Bruce Momjian  <bruce@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

  Indecision is a decision.  Inaction is an action.  Mark Batterson