From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Where to contribute manual translations ? Date: Thu, 28 Dec 2023 09:15:41 +0200 Message-ID: <837cky94rm.fsf@gnu.org> References: Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="37723"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Vincent =?iso-8859-1?Q?Bela=EFche?= Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Thu Dec 28 08:16:50 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 1rIkdO-0009ce-0C for ged-emacs-devel@m.gmane-mx.org; Thu, 28 Dec 2023 08:16:50 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rIkcZ-0005in-Hw; Thu, 28 Dec 2023 02:15:59 -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 1rIkcX-0005hq-Bq for emacs-devel@gnu.org; Thu, 28 Dec 2023 02:15:57 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rIkcW-0004RC-VX; Thu, 28 Dec 2023 02:15:56 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From: Date; bh=PsAYo2h63VWnfTxlzWLB7MSoXB4AAJEm3OCi6eANYzs=; b=jW68CTxsfRulZmn4dkG6 NK9pMitCXfdEdCtjlJHn37/JximsGC78ENuTHmrPomv4GismQoWoUcDz43noXl60lnEPy7CIxngwk JvNqc4TjWgFQjRPFdXpoiTDOKvwl95/NvioCoTNgtChZlRbqQskdw4ufG80TCQdVyWrohPwX6VQ0J NGEcLgG3k1kyn2XI5HAj8NrkocnpQEbr3m7ntd0HwE3IXOV4cFUKmMrefWrBvQyxNmzvWvaPUrOXS FGegSgPdY/o+ZJiJKajMH56W5crQMayb5eIFY0Fasve1x8fiMvvIOyjf1hosgonUBLd3xBfYvgQYG wyHY3sKsbsRLOA==; In-Reply-To: (message from Vincent =?iso-8859-1?Q?Bela=EFche?= on Wed, 27 Dec 2023 21:14:06 +0000) 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:314271 Archived-At: > From: Vincent Belaïche > 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 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 basically 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