Content-Type: multipart/alternative;
 boundary="------------HtEZqN0tBdTDIQh9qOIURu5O"
Message-ID: <9c670e1b-815d-4551-a4fe-01306a8970bd@gmail.com>
Date: Wed, 12 Nov 2025 10:02:37 +0100
MIME-Version: 1.0
User-Agent: Mozilla Thunderbird
Subject: Re: translator comments for GUC descriptions useful?
To: pgsql-translators@lists.postgresql.org
References: <1a89b3f0-e588-41ef-b712-aba766143cad@eisentraut.org>
Content-Language: fr, en-US
From: SAS <sas.postgresql@gmail.com>
Autocrypt: addr=sas.postgresql@gmail.com; keydata=
 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
In-Reply-To: <1a89b3f0-e588-41ef-b712-aba766143cad@eisentraut.org>
Archived-At: 
 <https://www.postgresql.org/message-id/9c670e1b-815d-4551-a4fe-01306a8970bd%40gmail.com>
Precedence: bulk

This is a multi-part message in MIME format.
--------------HtEZqN0tBdTDIQh9qOIURu5O
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 8bit

Hello,
Le 07/11/2025 à 09:53, Peter Eisentraut a écrit :
> Hi all,
>
> I've done some work recently in the source code to make the GUC C structs 
> automatically generated.  That now allows changing the output format more 
> easily.
>
> One random idea I had is that we could automatically generate "translator" 
> comments on the short and long description strings of GUC parameters.  So the 
> PO entries could then look like this:
>
> #. translator: GUC huge_pages_status short description
> #: utils/misc/guc_tables.c:5020
> msgid "Indicates the status of huge pages."
> msgstr ""
>
> (and analogously for the long description).
>
> This would be trivial to implement now (see below for an example).
>
> Would this be useful?

I really like the idea.

(...)

Best,

-- 
Dr Stéphane Schildknecht
Contact régional PostgreSQL pour l'Europe francophone
+33 617 11 37 42

--------------HtEZqN0tBdTDIQh9qOIURu5O
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: 8bit

<!DOCTYPE html>
<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  </head>
  <body>
    <div class="moz-cite-prefix">Hello,</div>
    <div class="moz-cite-prefix">Le 07/11/2025 à 09:53, Peter Eisentraut
      a écrit :<br>
    </div>
    <blockquote type="cite"
      cite="mid:1a89b3f0-e588-41ef-b712-aba766143cad@eisentraut.org">Hi
      all,
      <br>
      <br>
      I've done some work recently in the source code to make the GUC C
      structs automatically generated.  That now allows changing the
      output format more easily.
      <br>
      <br>
      One random idea I had is that we could automatically generate
      "translator" comments on the short and long description strings of
      GUC parameters.  So the PO entries could then look like this:
      <br>
      <br>
      #. translator: GUC huge_pages_status short description
      <br>
      #: utils/misc/guc_<a class="moz-txt-link-freetext" href="tables.c:5020">tables.c:5020</a>
      <br>
      msgid "Indicates the status of huge pages."
      <br>
      msgstr ""
      <br>
      <br>
      (and analogously for the long description).
      <br>
      <br>
      This would be trivial to implement now (see below for an example).
      <br>
      <br>
      Would this be useful? <br>
    </blockquote>
    <p>I really like the idea.</p>
    <p>(...)</p>
    <p>Best,</p>
    <div class="moz-signature">-- <br>
      <div>
        <div><font color="#00aee6">Dr Stéphane Schildknecht</font></div>
        <div>Contact régional PostgreSQL pour l'Europe francophone</div>
        <div>+33 617 11 37 42</div>
        <br>
      </div>
    </div>
    <div id="grammalecte_menu_main_button_shadow_host"
      style="width: 0px; height: 0px;"></div>
  </body>
</html>

--------------HtEZqN0tBdTDIQh9qOIURu5O--