From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Gavin Smith Newsgroups: gmane.comp.tex.texinfo.general,gmane.emacs.devel Subject: Re: @dircategory (Re: Translating Emacs manuals is of strategic importance) Date: Sat, 6 Jan 2024 20:16:54 +0000 Message-ID: References: <8734vda9kz.fsf@yahoo.com> <5EC9A02F-DB34-48B6-BD2D-CB9E89A385D0@traductaire-libre.org> <83r0iwuek9.fsf@gnu.org> <837cknvkrx.fsf@gnu.org> <83jzoms1sx.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="12771"; mail-complaints-to="usenet@ciao.gmane.io" Cc: jean.christophe.helary@traductaire-libre.org, stefankangas@gmail.com, vincent.b.1@hotmail.fr, emacs-devel@gnu.org, rms@gnu.org, help-texinfo@gnu.org To: Eli Zaretskii Original-X-From: help-texinfo-bounces+gnu-help-texinfo2=m.gmane-mx.org@gnu.org Sat Jan 06 21:17:18 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 1rMD6c-0003EV-Fb for gnu-help-texinfo2@m.gmane-mx.org; Sat, 06 Jan 2024 21:17:18 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rMD6L-0004Od-9J; Sat, 06 Jan 2024 15:17:01 -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 1rMD6K-0004O2-5g; Sat, 06 Jan 2024 15:17:00 -0500 Original-Received: from mail-wm1-x32e.google.com ([2a00:1450:4864:20::32e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1rMD6I-0005up-GJ; Sat, 06 Jan 2024 15:16:59 -0500 Original-Received: by mail-wm1-x32e.google.com with SMTP id 5b1f17b1804b1-40e36e29685so7686085e9.3; Sat, 06 Jan 2024 12:16:57 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1704572215; x=1705177015; darn=gnu.org; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:date:from:from:to:cc:subject:date:message-id:reply-to; bh=SwBzSn84xcZIAULHmPYY2QkR4AeuxVbgumcFrQJ1Q6A=; b=ji/ypu+NRdZD3U6R5C5iz+bgVxRJC9aovOMqq02RLRj5kPU7/SpqILGne7nFCBX/DV QueG/VX4Mitgw/Rt1EmCMVVbzMLYR7pOpW6pKx2KRz408L2eihRc9XYNlht5H4cnZw4f YRhikHSsk1YdWC3cPh/0VQfTOk6iL3TAD8yTfD7uWYBNMGgLrjq7gZZrOR5DonuhYXfT v38RRGru6zlm1DkiYB0eoLzkDVroKvXYnG8TAjujSDAeDhUdSEnXfVfLGeYALcNObK5E Sm1f2xv8LFU6tGdwHvXQ5NeCoor8K6zAkxljI8MmhyaQ55kpYYQB9gW7rk2aAOC80JOF HVmg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1704572215; x=1705177015; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:date:from:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=SwBzSn84xcZIAULHmPYY2QkR4AeuxVbgumcFrQJ1Q6A=; b=LjCPRYYLbDKqMyk3jqxVCdQ7vNZySlqygkHEFyeqQdNbfaTwAxiFEohdSbeM6X0GTF /W3v/ndW9YisvU4f94FexKE56ir8EIunRf1t0oNx4xeSwgpzAsHA26SHS7s7vfHhQejk S0Rk4VzwScQjNOGndwCeoOlHPpIYb0vmlxFWWs/hDJjKOqWN9ev4aDZHasBPKWkbbrDF 96J+stVdr8Iueq1pmq2T+HEoM6hZ2O8Ec9WZkuh9UIbtdWFAUK3ALxcJM7X/t+n6UDjV X8zvjhAQCdMNHNG0qLdUWNYU5AU08B4uCuHKb+0AOuoA4K3i9LBJK3+sVbVlRbkOidpo Q32g== X-Gm-Message-State: AOJu0Yz6PSSe+EFND0ZbedcQFRX7SRSnY/UDArgMcZhRRuG7EzpP359H vAy7Icryat0qk0cRcdfMz27YazOwzrenkQ== X-Google-Smtp-Source: AGHT+IEGB5WJLRa9eDeqgBs4pgwEMxL/T1jlBymnGUiiS/bI7qrd+OC/NGUsrtjYGPb+yy0PlEr9Bw== X-Received: by 2002:a05:600c:2303:b0:40d:3b3f:6040 with SMTP id 3-20020a05600c230300b0040d3b3f6040mr710901wmo.45.1704572214823; Sat, 06 Jan 2024 12:16:54 -0800 (PST) Original-Received: from localhost ([2a02:c7f:c29:b00:cd5c:ff9c:7813:a266]) by smtp.gmail.com with ESMTPSA id o14-20020adfeace000000b0033690139ea5sm3961370wrn.44.2024.01.06.12.16.54 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 06 Jan 2024 12:16:54 -0800 (PST) X-Google-Original-From: Gavin Smith Content-Disposition: inline In-Reply-To: <83jzoms1sx.fsf@gnu.org> Received-SPF: pass client-ip=2a00:1450:4864:20::32e; envelope-from=gavinsmith0123@gmail.com; helo=mail-wm1-x32e.google.com X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_ENVFROM_END_DIGIT=0.25, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action 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:3388 gmane.emacs.devel:314651 Archived-At: On Sat, Jan 06, 2024 at 09:24:14PM +0200, Eli Zaretskii wrote: > > It's up to people writing the Texinfo manuals what they put for > > @dircategory. In practice it seems that there aren't any well-followed > > conventions for this so top-level dir files end up quite disorganised. > > > > There are no conventions that I know of for the @dircategory of translated > > manuals. > > I always thought that utils/dir-example is the de-facto standard of > the categories which are "blessed" by the Texinfo project. It was "categories of the Free Software Directory" but that no longer follows the same structure as it did when that recommendation was first made. The Texinfo manual under @dircategory lists a few example categories which could be used (fairly consistent with what is in util/dir-example) but at this point it is up to document authors to decide what categories to use. They could look at what other documents do or invent their own categories if none are appropriate. > In this thread, we are raising the issue of some kind of > standardization of the categories for translated manuals. If you are > saying that you don't think there should be such standardization, then > I guess we in the Emacs project will come up with our own solutions, > and the rest of the GNU Project will have to cope with that, since the > categories we use gets copied to the system-wide DIR files when Emacs > is installed. As I said, my personal preference is that categories should be translated, although it is the decision of the translator in conjunction with the user community of that language. > > If desired, users could have a directory containing solely Info manuals > > in a certain language along with a dir file containing their dir entries. > > That would mean INFOPATH will have to be amended to include such > directories. It also means that INFOPATH will eventually include a > lot of directories, and search for Info manuals might become > significantly slower. I'm not sure this is a scalable arrangement. There's a limit to how many languages one person can read, so they won't need dozens of such directories.