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:31:49 +0000 Message-ID: References: <837cknvkrx.fsf@gnu.org> <83r0iuuacz.fsf@gnu.org> <83a5piu1y3.fsf@gnu.org> <3BA42BAC-B6D2-4531-BDC2-D8037E7038F7@traductaire-libre.org> <83wmsmsjbt.fsf@gnu.org> <83il46ryx6.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="3237"; 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:32:20 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 1rMDL9-0000im-Uv for gnu-help-texinfo2@m.gmane-mx.org; Sat, 06 Jan 2024 21:32:19 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rMDKx-0007cf-WB; Sat, 06 Jan 2024 15:32:08 -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 1rMDKl-0007bM-M6; Sat, 06 Jan 2024 15:31:55 -0500 Original-Received: from mail-wr1-x432.google.com ([2a00:1450:4864:20::432]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1rMDKk-0006CN-1P; Sat, 06 Jan 2024 15:31:55 -0500 Original-Received: by mail-wr1-x432.google.com with SMTP id ffacd0b85a97d-3368ac0f74dso610719f8f.0; Sat, 06 Jan 2024 12:31:52 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1704573110; x=1705177910; 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=pDmds9MeB/U7hpn7tmRHpfG0QwO3rqntjJN41yFfJJQ=; b=U3Te+PDiBd5qmHjNxcksYbOgXfJLM4ILg7penTCK4sFpYqk/8ocgyWCbrDTvYCwxmS USNisweuX/maDtz/ZCGXaSn6k0MaHEeNdzD/XsT2hMnvmIMkFuRsLZ+p4vy/3jF5W9rd eXhe4Hbx6j7k64BzzbiwqDWG3hwMRM0E7PukmDSGlbJAqJVSpf9qKSdZQrUmOhvM5USE 9OhR/9ouWJL7w9j27gVgdWWirRmhQbssiLaXxI/l26fma8p4ZG7kgIkzpxYE7Lpzy3fh PtrlY891uNQLHiuetZgkZtYl2K59axzySQbRJpfqvPs1iRnegb5IoVyy22aX2AYyr1Is gKcQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1704573110; x=1705177910; 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=pDmds9MeB/U7hpn7tmRHpfG0QwO3rqntjJN41yFfJJQ=; b=shXik3XY8vgWEXJGTwa/CoU+0h5XHH7x7iCTMWal5pwtLW3UiZNzifw5VBW5rIpyku Bb+IdJcfc9XzZJxC9HC5CGIouPqGcNOZbJh4iHwwNLbrapDEObdJ6MfMmtB+vWgnpCsr W5MjkXQT8D4GatAZqS0+MhMFKhzwHCyMJbPNXDwf68e0cElsndbGuVkImfBAMuxld9nJ hkdrwxJ4VC1mRhj7BVXkbNB4MnqLaqRKd86R7HtUSQUOFr1WLX5yvQb60bX8b3fMgfpG xsDJuIMEis6VPwOWNNc8T4aOOgvl6UmycEgtVoXzXvDLB/vOUX28UXRU2h1CCVhqQ49F 2SDQ== X-Gm-Message-State: AOJu0YxUy2B4pm0r/qEeDf44sXmMo7sy7EwXo5KoM/qV8CCSTywfkr6c 1hXQRQmW+va8OS2WEyujRGt/LELK9dcbfQ== X-Google-Smtp-Source: AGHT+IHE/ilr+L7nnQCvZs2eVQP8NHpkGkHErvMsTJV3IU4hCNG+cRKO424WXUs5gxoQ2Dv6NhQDSQ== X-Received: by 2002:a5d:4f81:0:b0:336:c32d:a850 with SMTP id d1-20020a5d4f81000000b00336c32da850mr705825wru.112.1704573110288; Sat, 06 Jan 2024 12:31:50 -0800 (PST) Original-Received: from localhost ([2a02:c7f:c29:b00:cd5c:ff9c:7813:a266]) by smtp.gmail.com with ESMTPSA id df14-20020a5d5b8e000000b0033677aae2e2sm3960634wrb.107.2024.01.06.12.31.49 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 06 Jan 2024 12:31:49 -0800 (PST) X-Google-Original-From: Gavin Smith Content-Disposition: inline In-Reply-To: <83il46ryx6.fsf@gnu.org> Received-SPF: pass client-ip=2a00:1450:4864:20::432; envelope-from=gavinsmith0123@gmail.com; helo=mail-wr1-x432.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:3390 gmane.emacs.devel:314653 Archived-At: On Sat, Jan 06, 2024 at 10:26:29PM +0200, Eli Zaretskii wrote: > > From: Gavin Smith > > Date: Sat, 6 Jan 2024 19:41:27 +0000 > > Cc: Eli Zaretskii , stefankangas@gmail.com, > > vincent.b.1@hotmail.fr, emacs-devel@gnu.org, rms@gnu.org, > > help-texinfo@gnu.org > > > > On Sat, Jan 06, 2024 at 01:49:53PM +0000, Jean-Christophe Helary wrote: > > > Thinking out loud here, but @node currently requires the node-name > > > argument and has next/preious/up optional argument. It seems to me that > > > most of the issues would be fixed by adding a fifth argument that acts > > > like the cross-references' second argument (online-label). That way, > > > node-name can stay as it is and act as the pointer but is displayed as > > > "online-label", which is the translated part. > > > > A document author can use @anchor to provide target text for a > > cross-reference which does not appear in the reader-visible part > > of the manual. I don't see that extending the Texinfo language is > > necessary. > > Do you mean that a translated manual should have an @anchor for each > @node, where nodes have translated names and the anchors give their > original names in English? Yes, exactly.