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.comp.tex.texinfo.general,gmane.emacs.devel Subject: Re: @dircategory (Re: Translating Emacs manuals is of strategic importance) Date: Sat, 06 Jan 2024 22:37:28 +0200 Message-ID: <83h6jqryev.fsf@gnu.org> References: <8734vda9kz.fsf@yahoo.com> <5EC9A02F-DB34-48B6-BD2D-CB9E89A385D0@traductaire-libre.org> <83r0iwuek9.fsf@gnu.org> <837cknvkrx.fsf@gnu.org> <83r0iuuacz.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="34579"; mail-complaints-to="usenet@ciao.gmane.io" Cc: stefankangas@gmail.com, jean.christophe.helary@traductaire-libre.org, vincent.b.1@hotmail.fr, emacs-devel@gnu.org, rms@gnu.org, help-texinfo@gnu.org To: Gavin Smith Original-X-From: help-texinfo-bounces+gnu-help-texinfo2=m.gmane-mx.org@gnu.org Sat Jan 06 21:38:19 2024 Return-path: Envelope-to: gnu-help-texinfo2@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 1rMDQv-0008n3-SJ for gnu-help-texinfo2@m.gmane-mx.org; Sat, 06 Jan 2024 21:38:17 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rMDQR-0000m0-6l; Sat, 06 Jan 2024 15:37:47 -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 1rMDQP-0000gW-7w; Sat, 06 Jan 2024 15:37:45 -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 1rMDQN-00011v-E7; Sat, 06 Jan 2024 15:37:43 -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=m1oyi6q9icMbOe6DtRFvEdGbJi6N8mYJ9s22kMGZZPE=; b=N+DOoEh+e6vZUJwJwfDl Pi1OBTzKsh2uINxtAmVqn/efkXTOC/W7Qnn7B5Ot0AjyhoGqftN5uTYX/rVOyoX9+tR0hlE+/uvcb RC3rtc12MxvgwNxf8gkQRdsdRXqG6u4ifaZglA0vmmSbIqPB84pKNKuaetnnvBUowWVgBqwQiDbg0 eEJVOEDd6II21K0rsg9/Z3Mq57lKn+i456eWcW9c1OhE6wzc4nNecEY10F1D+jNpbhGKHQR0bnpfo v/DfyJFfacDZ6dreLatv3UHu8wh0TwfZAM1Zf1I8mhyw8BUv2/MtIn8K0lPiLUjkmqUxuSRaoSkrw 4UAKdZaLepqW+A==; In-Reply-To: (message from Gavin Smith on Sat, 6 Jan 2024 20:02:32 +0000) X-BeenThere: help-texinfo@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Users list for the Texinfo documentation system List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-texinfo-bounces+gnu-help-texinfo2=m.gmane-mx.org@gnu.org Original-Sender: help-texinfo-bounces+gnu-help-texinfo2=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.comp.tex.texinfo.general:3391 gmane.emacs.devel:314654 Archived-At: > From: Gavin Smith > Date: Sat, 6 Jan 2024 20:02:32 +0000 > Cc: Eli Zaretskii , > Jean-Christophe Helary , > vincent.b.1@hotmail.fr, emacs-devel@gnu.org, rms@gnu.org, > help-texinfo@gnu.org > > > I'd probably take it a step further and completely hide translations (by > > default at least) outside of relevant locales. We already do basically > > that for the tutorial. > > I think it would be a good idea to hide them. This could be dealt with > by installing translated manuals in a different location. This would be un-Emacsy, I think. Emacs does not obey the locale so completely, it changes the defaults to follow the locale, but allows the user to request variants that are not the locale's defaults. For example, the command to show the tutorial by default shows the tutorial for the locale's language, but it can optionally be requested to show the tutorial in any other language specified by the user. I would prefer to have something similar for translated manuals. > For example, in my top-level dir node, which I see by running "info", > I have the following lines: > > Развој програма > * help2man-sr: (help2man-sr). Самостално стварање > странице упутства. > > Розробка програмного забезпечення > * help2man-uk: (help2man-uk). Програма для > автоматичного створення сторінок > підручника (man). > > 软件开发 > * help2man-zh_CN: (help2man-zh_CN). > 自动手册页生成。 > > These are of no interest to me as I can't read the languages. This > could potentially get worse if more manuals were translated and the > translations installed by default in the default Info directories. Whether to actually install those is a separate issue. A downstream distro could, for example, have separate installible components for each language. But if these _are_ installed, then why shouldn't they be available? > - Support installation of manuals in different languages, along these lines: > . support a LINGUAS file or variable saying which subdirs LL in the > source to descend into (under doc/). > . within each subdir LL, install the info files into $infodir/LL, > and run install-info on $infodir/LL/dir. > . info (both emacs and standalone) should read $infodir/$LANG/dir > as the first dir file, and likewise read info files first from > $infodir/$LANG, before falling back to $infodir. > . consider ways to avoid installing images in both places. > In fact, images probably need to be installed in a subdir > $infodir/MANUAL/ in the first place, to avoid conflicts of having > the same image name in different manuals. I think this implicitly assumes that only a single LANG plus the English manuals are ever installed. If a user installs manuals for many languages, this kind of arrangement will make INFOPATH have too many directories, which will eventually slow down the search for manuals. I think a flat directory with FOO-LL.info files for language LL is a better idea. > The $infodir/LL and $infodir/LL/dir part of this seem like a good idea > to me. This would require changes in package build and installation > systems (Automake), not necessarily in Texinfo itself. Since users > can set INFOPATH (or Emacs equivalent) themselves, it is not urgent to > implement special support for language directories per se in 'info' > or 'install-info'. This could be done once it is clear that people > are actually using installation directories that way. Actually, the Emacs Info reader is designed to work OOTB without any tweaking of its INFOPATH equivalent. So asking users to add the LL directories would be a nuisance, I think.