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: Fri, 29 Dec 2023 13:40:03 +0200 Message-ID: <83wmsx5jak.fsf@gnu.org> References: <837cky94rm.fsf@gnu.org> <83v88i77ui.fsf@gnu.org> <83jzoy71pb.fsf@gnu.org> <83il4i6yhv.fsf@gnu.org> <837ckx7atv.fsf@gnu.org> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="5479"; mail-complaints-to="usenet@ciao.gmane.io" Cc: vincent.b.1@hotmail.fr, emacs-devel@gnu.org To: Stefan Kangas Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri Dec 29 12:41:24 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 1rJBEy-0001Fl-8r for ged-emacs-devel@m.gmane-mx.org; Fri, 29 Dec 2023 12:41:24 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rJBE6-0001QE-OY; Fri, 29 Dec 2023 06:40:30 -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 1rJBE4-0001Pz-Ge for emacs-devel@gnu.org; Fri, 29 Dec 2023 06:40:28 -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 1rJBE3-0001hQ-NB; Fri, 29 Dec 2023 06:40:27 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=p6qSR70QdtotqjD4Tm/tNElI3bvyJDNiEt7iIT865WE=; b=MWvTINOvdtTm UsgGFBPLiB8e9hKcy9zD4059gRgjeIl4ldnJtA5eAZu98RHSKJ7pzJZhiNlR2eGSd6vmv50j5iyEI hLhjhH4HzpiqJN+n2kii0XdW0VoHdIJO/y1fF2vijo3E1qXW8lLV+ak0L937dXCo1vD88vwph+8lm pNuBqcc98Gg75+4MZ0264t7VhI27NJ/sWoz78leN009wgXkqHMvKTMpRunwldZHnKCyF9jOibFi3c /BrWPrla/RkLaqZbHRXUOM8sculn1N31TfRIdgm1N3Qo7BVnBuBHA29EVcGgXO5m1LRvJsC+OJTxI J6oUJM+cComD1fcWVUbzjQ==; In-Reply-To: (message from Stefan Kangas on Fri, 29 Dec 2023 01:02:21 -0800) 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:314322 Archived-At: > From: Stefan Kangas > Date: Fri, 29 Dec 2023 01:02:21 -0800 > Cc: vincent.b.1@hotmail.fr, emacs-devel@gnu.org > > Eli Zaretskii writes: > > > So I think having MANUAL-LANG.info files which are translations of > > MANUAL.info to the various languages LANG, and having them in the same > > single directory, is the best alternative, as its impact on existing > > code and distros is minimal, almost non-existent. > > OK, then let's do it that way. So, to summarize: . Texinfo sources go into the doc/LANG/ subdirectory, under which there should be the same subdirectories 'emacs', 'lispref', misc' etc. (we will actually create a directory when the first translation of the corresponding English manual will be submitted); . Texinfo sources of a translation of MANUAL.texi into the language LANG will be called MANUAL-LANG.texi; . Info output should go to info/MANUAL-LANG.info (this should be specified in the @setfilename directive in the Texinfo source). OK? > However, does that mean that, e.g. `ses-fr`, would always be listed, or > would it be listed only when using a French locale? If ses-fr.info is installed, then it will be listed, yes. > I imagine that most users would never want to look at most foreign > language manuals (they typically speak only a few languages), so > showing all translations risks mostly getting in the way. This is something to coordinate with both the Texinfo project and the downstream distros, I think. Basically, if a user never wants to see ses-fr.info, that user should not install it in the first place. It is possible to do something more sophisticated based on the locale, but that would require coordination with the Texinfo project, and then how would that support users who, for some reason, want to have manuals in several languages available? So it sounds a bit complicated, and I'd say let the sleeping dogs lie at this point.