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 08:59:56 +0200 Message-ID: <837ckx7atv.fsf@gnu.org> References: <837cky94rm.fsf@gnu.org> <83v88i77ui.fsf@gnu.org> <83jzoy71pb.fsf@gnu.org> <83il4i6yhv.fsf@gnu.org> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="24555"; 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 08:01:05 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 1rJ6rg-0006Cm-8d for ged-emacs-devel@m.gmane-mx.org; Fri, 29 Dec 2023 08:01:04 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rJ6qz-0007pK-TN; Fri, 29 Dec 2023 02:00:22 -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 1rJ6qx-0007ow-EI for emacs-devel@gnu.org; Fri, 29 Dec 2023 02:00:19 -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 1rJ6qw-0002A3-Qh; Fri, 29 Dec 2023 02:00:18 -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=Vk1jaUk7r1lvkor9JPfV8buTRirNM+JAS8OBLC88bo8=; b=okoBTJiAHAUS V9dKjve3QUfJlWNA20Xi9qTFQgqVxBVYaEoLNGIjuzLhG0n/5QR51EdyqH3+WfH8sH16SJYT9MDZE T0Ii2ky3NL7H3YxxGDj9MeAVoNdD3YPfEaPfIM5fw2N/GB5mmEHgoaA48dm3rrymZ2iHW2yIKMzRa C2FQf/T4dLKAu/7B0GJleA48tOz830tnqcKd+wH8jj8aZxg0iji55HMUyxxz4M2ctvXaUp9LrjWcO 1BfH2auMr6ZkDmdWNLKvgaa9cwEOXbQMym2BPk2Y+IPKMsxH/R92hq9XC4nUrL+3TNh7VyGAZz1MS 1j4FpQ81YihtzYpJxzAyNg==; In-Reply-To: (message from Stefan Kangas on Thu, 28 Dec 2023 18:05:41 -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:314310 Archived-At: > From: Stefan Kangas > Date: Thu, 28 Dec 2023 18:05:41 -0800 > Cc: vincent.b.1@hotmail.fr, emacs-devel@gnu.org > > Eli Zaretskii writes: > > > And if we are going to have separate directories for each language, > > both under doc/ and under info/, why do we also have to name the files > > FOO-fr.texi or FOO-fr.info? > > I had in mind a shared directory for all translations, but we would > compile them to separate directories under info such that > > doc/translations/misc/ses-fr.texi > > compiles into > > info/fr/ses-fr.info > > In the info/$LANG directories, we would put a separate `dir` file. > Then we could simply add those language specific directories to > `Info-directory-list' based on the locale, I think. Using subdirectories in the Info hierarchy is problematic: not only will we need to tweak Info-directory-list, we'll also need to coordinate with Texinfo so that the stand-alone Info reader supports these subdirectories (which means either that INFOPATH will need to include them, or that the Info reader would need to be modified to search those subdirectories without them appearing in INFOPATH). Come to think of that, adding those directories to Info-directory-list is also not the best idea, since there will be eventually many such subdirectories, and the search for Info manuals will become much slower as result. We could teach info.el that FOO-fr.info should be in the "fr" subdirectory of each directory in Info-directory-list, or have stuff like "(fr/ses-fr)." in DIR, but how is this better than just having ses-fr.info in the info directory to begin with? 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. > The main purpose of having "ses-fr.texi" is to avoid having several > files with the same file name under version control, which I personally > find very confusing. I'm okay with having subdirectories in the doc/ directory, if that has some, even small, advantages.