From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: =?iso-8859-1?Q?Vincent_Bela=EFche?= Newsgroups: gmane.emacs.devel Subject: RE: Where to contribute manual translations ? Date: Thu, 28 Dec 2023 11:41:20 +0000 Message-ID: References: <837cky94rm.fsf@gnu.org> Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="_000_PAXP192MB1608BA27910F0DBCEB4EEF83849EAPAXP192MB1608EURP_" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="13662"; mail-complaints-to="usenet@ciao.gmane.io" Cc: "emacs-devel@gnu.org" To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Thu Dec 28 12:42:23 2023 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1rIomM-0003JD-SU for ged-emacs-devel@m.gmane-mx.org; Thu, 28 Dec 2023 12:42:22 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rIolf-0001ju-0b; Thu, 28 Dec 2023 06:41:39 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rIolY-0001jH-JX for emacs-devel@gnu.org; Thu, 28 Dec 2023 06:41:33 -0500 Original-Received: from mail-vi1eur02olkn2047.outbound.protection.outlook.com ([40.92.48.47] helo=EUR02-VI1-obe.outbound.protection.outlook.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rIolR-0000Ew-Ga; Thu, 28 Dec 2023 06:41:28 -0500 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=Bnwc9isrHZ3fYqZ0/w91Hqo8G9e43J4nBVw7we/aBybQOLaUXLmmcf42QrcZMqbPncEr6ClyAgyAwvMUJE1rxwUWPcd5DbWVQ+lkPHt6vroYPZp+I1LAnPub6efXJBMOmvn0wRaN1o0D71h6BNsVHmLWf4OjoOSVO4wx81ENP0SwO3nQnWwRScaQ7WI3pSoQkki09DXN5QH4Kmyq7a5w1/bYtTk5YatBRqomk2c5cgXx+7wr+g2qzcU/Czf8hiflMcb5PP86pr1a5nybPeGfNidzEV9XvzeYXNReBTIRjwX2kshoK79l6vyb+axlNugMZDVWAWoiA56TRJcXa9Z3YQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=NsVyUPTxkm5oQcwHQwpgcEmDmhZgqBGCq6Bp0U8CC7k=; b=LRuEK4IB3H4zEqyvwPNBT/U8SEZ0wpBmCYZkhZnRT8MlTj/hRMVIqIM3oMekpfwDabXPQXNAU6rzaRHvEvilQQS93uPPxsavaS8lTGW0/uqYIQO88a9TQnn1vCi/WHGDdkUKpgW8/eo+T6r/xQQoJ+iUYS5hrE+cGb1Yo0vCvrIe5AqCruNf85fkqZq+ZNToNmcntKunLvQicfthvbDuTtiNmkmx6Rqji1My6PplWtICB+qt93VDv+mefwsvao4SC+M6kVfi4SL5tQEEWlr0lQK+Viv9ei3Yo/reK9HyqfqQwENEEMda4Y6sQQaL2QEqvV14+Wz4IkOicqxE5uft9w== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=none; dmarc=none; dkim=none; arc=none Original-Received: from PAXP192MB1608.EURP192.PROD.OUTLOOK.COM (2603:10a6:102:28c::22) by AM9P192MB0951.EURP192.PROD.OUTLOOK.COM (2603:10a6:20b:1fc::20) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7113.27; Thu, 28 Dec 2023 11:41:20 +0000 Original-Received: from PAXP192MB1608.EURP192.PROD.OUTLOOK.COM ([fe80::fee7:9deb:373a:4055]) by PAXP192MB1608.EURP192.PROD.OUTLOOK.COM ([fe80::fee7:9deb:373a:4055%7]) with mapi id 15.20.7113.027; Thu, 28 Dec 2023 11:41:20 +0000 Thread-Topic: Where to contribute manual translations ? Thread-Index: AQHaOQkOTAv0lkiqEUiYhgsP5hUs+rC+SVjZgABaQa4= In-Reply-To: <837cky94rm.fsf@gnu.org> Accept-Language: fr-FR, en-US Content-Language: fr-FR x-ms-exchange-messagesentrepresentingtype: 1 x-tmn: [ZOhVDaXZKaVpiCpEGFSxM3csWRHo2Nik] x-ms-publictraffictype: Email x-ms-traffictypediagnostic: PAXP192MB1608:EE_|AM9P192MB0951:EE_ x-ms-office365-filtering-correlation-id: b874f2f1-ead1-4db4-74d8-08dc0799e94c x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: wGgtleowoTNJJSW7FAoCDVZ/42zHcTqxMntLwKSniDHrNe0iJeNKw4JyhOntThVh+/nCJp/dIJ8HHNaaCBJj7vECXZC9oGsxneS+lu0W5RD1nuTCYGuAnVrIGcF2ccuiKKrMy5aO0dPLSyqnC3rmJ215gVZdDE1Y2yAkiaf3GP+RZfBtXRFfsPeoGfVNKTq/gVwEswzqr5GuSM080azpHYpr6fyIzz0D9EEuOSiplb1b7grVGouljY9JXp/NFuq/aMTfLlORUeBXvGjvl1Gh1z6OLvCDKQOHaXO05oV6fNPHlcL8F6raIL43YZm/KorbjWBtmk/X4Th6JU2o1oMGVDggZCt2NrsR5+wYf9horDXutU4Wll7P1Mqq60FFvpuNnr8mRnU4cO1iOlhpUYHWVfO3zRe5y+VYT2m0DrK3N5M33PPB/5j7IknNJOcqkLt3vPjCHZeP8bhUjh9yzIpDExEsDMcOMgkOwi8/Ha8AU0t4HXu4eziSIUFI6IpXD0lYiQJrw4qdoYQ2DAikd5zl26SdoRGRbMPDCKT2ZMWIAPo7uKkQ8IftTP7fotWgjHPXrflm0Wj3T6qIRg2BdkqTeCTm4dyz0ponA1z05DNq4xdVAYsr/m2R3ETBuC6PSYBy x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?iso-8859-1?Q?1R5hWu7QyLqoUaLI27B3+Z0nJY7F8avftpVmz3DnwaNQpQ7EP06aOsj02c?= =?iso-8859-1?Q?Y2Wove9rTC/2k3O0feSxxaeoX3x8nL4rEglVWiY3sHcwkCfhxb8eu+XPxv?= =?iso-8859-1?Q?FgAloCCJba0j7VUSY7Ewwa/PSCpLledZFLrLsj6VkyOOxKPLYJc1iBbT30?= =?iso-8859-1?Q?+BGZVTqCg2e5KEvjmLF03JczpwsGZHC1jOHnQQ3xw28srPLgw+DUxD9hrK?= =?iso-8859-1?Q?ARQ0cC+M6qHwXqtKmmTynLcCYJkDmtd4o0FpJt/4vU4CpGJUsn9uqt8H/I?= =?iso-8859-1?Q?U+3NjwwXycKlfHHemqB/ixJhM8XTpTSI0e0rlgZd/Jp3FLPGk0onYN6ZJM?= =?iso-8859-1?Q?wh4VTcmOzZIxJee+r3lGNU76ZEZw0DhtzSJCnSbP5Tlr540OWhWJ1ebWGq?= =?iso-8859-1?Q?92tE/kSzNFVR9MFNfyFUCuRGq1PjHSKjedz0/YAbyO1z0WaPKW5xPfbWYL?= =?iso-8859-1?Q?cE1P8MT91Jhl8xLACKDryhd/LWQXfQZzCP8RRaoemhKZgncBMfOaiv5Dix?= =?iso-8859-1?Q?epXWdm2+k3PVzLiqKvxhjEkVMYGkmiUu9B72vuRZv06/+2HV0+3QxR8U1e?= =?iso-8859-1?Q?EftTA9b+YrWrEOLbmAGq669vhjWJafrW9q39/SdQTHhlgZ2RwhHzy9yU5y?= =?iso-8859-1?Q? X-OriginatorOrg: sct-15-20-4755-11-msonline-outlook-fb43a.templateTenant X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: PAXP192MB1608.EURP192.PROD.OUTLOOK.COM X-MS-Exchange-CrossTenant-RMS-PersistedConsumerOrg: 00000000-0000-0000-0000-000000000000 X-MS-Exchange-CrossTenant-Network-Message-Id: b874f2f1-ead1-4db4-74d8-08dc0799e94c X-MS-Exchange-CrossTenant-originalarrivaltime: 28 Dec 2023 11:41:20.5117 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 84df9e7f-e9f6-40af-b435-aaaaaaaaaaaa X-MS-Exchange-CrossTenant-rms-persistedconsumerorg: 00000000-0000-0000-0000-000000000000 X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM9P192MB0951 Received-SPF: pass client-ip=40.92.48.47; envelope-from=vincent.b.1@hotmail.fr; helo=EUR02-VI1-obe.outbound.protection.outlook.com X-Spam_score_int: -16 X-Spam_score: -1.7 X-Spam_bar: - X-Spam_report: (-1.7 / 5.0 requ) BAYES_00=-1.9, FREEMAIL_ENVFROM_END_DIGIT=0.25, FREEMAIL_FROM=0.001, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:314273 Archived-At: --_000_PAXP192MB1608BA27910F0DBCEB4EEF83849EAPAXP192MB1608EURP_ Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable Dear Eli, Thank you for your quick and very complete reply. Yes, I think that the bes= t would be for me to have this translation under the Emacs project, as it w= ould be kept consistent with the source code. Is doc/fr/misc/ses.texi OK fo= r the French version path, as the original is doc/misc/ses.texi ? V. ________________________________ De : emacs-devel-bounces+vincent.b.1=3Dhotmail.fr@gnu.org de la part de Eli Zaretskii Envoy=E9 : jeudi 28 d=E9cembre 2023 08:15 =C0 : Vincent Bela=EFche Cc : emacs-devel@gnu.org Objet : Re: Where to contribute manual translations ? > From: Vincent Bela=EFche > Date: Wed, 27 Dec 2023 21:14:06 +0000 > msip_labels: > > Where is the right place to contribute a translation to French of the SES= manual ? We don't have a place yet. Do you intend to contribute this to the Emacs project, so that this manual is maintained as part of Emacs and distributed with the release tarballs, or do you intend to make it a separately-maintained manual available from outside of emacs.git? In the latter case, perhaps making it a GNU ELPA package could be a possibility? > Is it there : https://savannah.nongnu.org/projects/emacsdoc-fr It could be. But I'm not sure it's the best place, at least from the discoverability POV. > Or can it be placed directly under the Emacs repo (or is there any git su= bmodule planned under > directory doc for that ?) It can, if you'd like to contribute this manual to the Emacs project, and keep maintaining it as part of Emacs. > Another question : how to internationalize docstrings ? IMHO it would be = great if the docstring could > have some info manual anchor in it, and one could display it from the cur= rently selected language > manual. Besides, reading docstring from manual via some anchor is basical= ly what Calc does with > some kitchen tricks. We don't yet have the necessary infrastructure for translating doc strings. This was discussed in the past several times, and the conclusion was that it's a non-trivial project. Some of the previous discussions: https://lists.gnu.org/archive/html/emacs-devel/2017-04/msg00750.html https://lists.gnu.org/archive/html/emacs-devel/2017-05/msg00645.html https://lists.gnu.org/archive/html/emacs-devel/2017-05/msg00751.html https://lists.gnu.org/archive/html/emacs-devel/2017-05/msg00806.html https://lists.gnu.org/archive/html/emacs-devel/2019-03/msg00081.html https://lists.gnu.org/archive/html/help-gnu-emacs/2021-07/msg00422.html --_000_PAXP192MB1608BA27910F0DBCEB4EEF83849EAPAXP192MB1608EURP_ Content-Type: text/html; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable
Dear Eli,

Thank you for you= r quick and very complete reply. Yes, I think that the best would be for me= to have this translation under the Emacs project, as it would be kept consistent with the source code. Is doc/fr/misc/ses.te= xi OK for the French version path, as the original is doc/misc/ses.texi ?

   = ;V.

De : emacs-devel-bounces+vi= ncent.b.1=3Dhotmail.fr@gnu.org <emacs-devel-bounces+vincent.b.1=3Dhotmai= l.fr@gnu.org> de la part de Eli Zaretskii <eliz@gnu.org>
Envoy=E9 : jeudi 28 d=E9cembre 2023 08:15
=C0 : Vincent Bela=EFche <vincent.b.1@hotmail.fr>
Cc : emacs-devel@gnu.org <emacs-devel@gnu.org>
Objet : Re: Where to contribute manual translations ?
 
> From: Vincent Bela=EFche <vincent.b.1@hotm= ail.fr>
> Date: Wed, 27 Dec 2023 21:14:06 +0000
> msip_labels:
>
> Where is the right place to contribute a translation to French of the = SES manual ?

We don't have a place yet.  Do you intend to contribute this to the Emacs project, so that this manual is maintained as part of Emacs and
distributed with the release tarballs, or do you intend to make it a
separately-maintained manual available from outside of emacs.git?  In<= br> the latter case, perhaps making it a GNU ELPA package could be a
possibility?

> Is it there : https://savannah.nongnu.org/projects/emacsdoc-fr

It could be.  But I'm not sure it's the best place, at least from the<= br> discoverability POV.

> Or can it be placed directly under the Emacs repo (or is there any git= submodule planned under
> directory doc for that ?)

It can, if you'd like to contribute this manual to the Emacs project,
and keep maintaining it as part of Emacs.

> Another question : how to internationalize docstrings ? IMHO it would = be great if the docstring could
> have some info manual anchor in it, and one could display it from the = currently selected language
> manual. Besides, reading docstring from manual via some anchor is basi= cally what Calc does with
> some kitchen tricks. 

We don't yet have the necessary infrastructure for translating doc
strings.  This was discussed in the past several times, and the
conclusion was that it's a non-trivial project.  Some of the previous<= br> discussions:

  https://lists.gnu.org/archive/html/emacs-devel/2017-04/msg00750.html   https://lists.gnu.org/archive/html/emacs-devel/2017-05/msg00645.html   https://lists.gnu.org/archive/html/emacs-devel/2017-05/msg00751.html   https://lists.gnu.org/archive/html/emacs-devel/2017-05/msg00806.html   https://lists.gnu.org/archive/html/emacs-devel/2019-03/msg00081.html   https://lists.gnu.org/archive/html/help-gnu-emacs/2021-07/msg00422.html=

--_000_PAXP192MB1608BA27910F0DBCEB4EEF83849EAPAXP192MB1608EURP_--