From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Suhail Singh Newsgroups: gmane.emacs.bugs Subject: bug#74844: 29.4; m-buffer: Broken Top Directory node in Info manual due to malformed Texinfo direntry Date: Sun, 15 Dec 2024 12:53:01 -0500 Message-ID: <87zfkwygsi.fsf@gmail.com> References: <87zfl0bc7o.fsf@gmail.com> <87cyhuey26.fsf_-_@gmail.com> <86r069s9dp.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="9129"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Cc: yantar92@posteo.net, 74844@debbugs.gnu.org, Suhail Singh , monnier@iro.umontreal.ca To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Dec 15 18:55:12 2024 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1tMspj-0002C3-2A for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 15 Dec 2024 18:55:11 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1tMspc-0002ST-R2; Sun, 15 Dec 2024 12:55:04 -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 1tMspa-0002R8-PE for bug-gnu-emacs@gnu.org; Sun, 15 Dec 2024 12:55:02 -0500 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1tMspa-0000pH-GD for bug-gnu-emacs@gnu.org; Sun, 15 Dec 2024 12:55:02 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=MIME-Version:Date:References:In-Reply-To:From:To:Subject; bh=syKhe216JYQnyNMLsyta6HbVYeOPDrHTStniUDiGi2A=; b=QItIUoFeMfpXfmfFiZbl7LMUQUDxeZ2b9FSuknMhDxr48n/uu3eJbW3rPfx1brmuoSvSbLronaznMxzf01JIzedTpIcLuV1XtCPTSYbTamLPj921qra3inkaXcfMaFBBbr8rx0WXGPR7t5JZ2G7o762T5qkKDrjpP+dxAVyLgUsESvz3gtcB3Pe8HwMz5DAh2+2vq/J5OiuD3wVUOaD5Kd3wtQYkN+VdViuY8b6QT38o4ZypR3en6BcnHDloiUfgmEga2xW15Sq0Rph+iyDXtVV1whtRjuduG6f6ij12jfpghBMLBlquvg47go4MlW4GgSHTjH/N+TD9elS0Yk2xZw==; Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1tMspa-0002Dk-Ak for bug-gnu-emacs@gnu.org; Sun, 15 Dec 2024 12:55:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Suhail Singh Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 15 Dec 2024 17:55:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 74844 X-GNU-PR-Package: emacs Original-Received: via spool by 74844-submit@debbugs.gnu.org id=B74844.17342852578466 (code B ref 74844); Sun, 15 Dec 2024 17:55:02 +0000 Original-Received: (at 74844) by debbugs.gnu.org; 15 Dec 2024 17:54:17 +0000 Original-Received: from localhost ([127.0.0.1]:51878 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1tMsom-0002CN-0K for submit@debbugs.gnu.org; Sun, 15 Dec 2024 12:54:17 -0500 Original-Received: from mail-qk1-f196.google.com ([209.85.222.196]:46281) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1tMsoj-0002Bn-Ib for 74844@debbugs.gnu.org; Sun, 15 Dec 2024 12:54:10 -0500 Original-Received: by mail-qk1-f196.google.com with SMTP id af79cd13be357-7b6e4d38185so265177885a.0 for <74844@debbugs.gnu.org>; Sun, 15 Dec 2024 09:54:09 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1734285183; x=1734889983; darn=debbugs.gnu.org; h=content-transfer-encoding:mime-version:user-agent:message-id:date :references:in-reply-to:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=syKhe216JYQnyNMLsyta6HbVYeOPDrHTStniUDiGi2A=; b=b2mKZ7oJFgQ7TG30RnqDxUu9473FRduKIXaJeoMfBcNzRpXbheCjQr6pUOlRQ5yByq 2d1SyiLe9YUWTmRGvLZ0/4Aa+Mxm4UK7vJLKNvcatF0KhkKfbWeoDreRFfzeZvz2Tg0q KrF/Fh9mzzAQag06DXpbbsF3lOZ2lONKeKHZp5CmMiFCiKbcAkPZe/M1HBJKIbXFgOCl sayTaN+sTPmlWfuau1tKprnnbDMjJKCqQh5rbWGDSnkgMjZh8ICZWwtOP+jd6WhPMemG K+nHTn+Cx7yW4XX2BIm+djJ2tVQQRMJozjzqMFl/yBhbE54ZVHYFTcbZwtbTL3oKBu2D kXyQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1734285183; x=1734889983; h=content-transfer-encoding:mime-version:user-agent:message-id:date :references:in-reply-to:subject:cc:to:from:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=syKhe216JYQnyNMLsyta6HbVYeOPDrHTStniUDiGi2A=; b=pLNmQkQY6OfX1APM3Pba6RJsjdcxLhxGvvaHFR8Bl+FRltGNsGkDBswyrYF3VPYGgY Jw3Rl6IMB7lXrIt0qVUylraBJoANF6xtfiSUEQDyI3vtZjCF4QLRae9x/IsChtVljDNo 8OO0hR3uALJHB7WWHosJXOm62/04++6qaM71oVf5rY99oW14RjlbQYyakPy5v9Rus8H/ EUkPygkcwRFwzuCjqRo/ryopCLHu/SpwdUubhDtByETfvtnHdiEFMbLWNHH6/MPveqOK EU98ltCbWyEIr09+NpkMUR9DR0Sr43qzDmJFe9ngZx/0pyEgEDNijcedjRRwekIh1oxo UbkA== X-Forwarded-Encrypted: i=1; AJvYcCUrz7iy906a5VkZW8RnraRNq+qlzkhmNRMHSQbwbpwwckNzD2ayUSf420bXLIsRsdrCmKoPLA==@debbugs.gnu.org X-Gm-Message-State: AOJu0YzjNIK1PDjPoqIeWXRUHSzsPAKQ7Iw8kUKKDjGNPR729ytzKR06 vAnLGYGbOX7VdlP84/T2Gb8GruA37Rm4VOIAR5LKhjk6WlsJDKPsK9dZAwvE X-Gm-Gg: ASbGncseyJX7gLdZP1aWn5tnPj9b9CD3y6EKtBEwLb/toatPTPw19nXJmDiru4+9LSO O3OF2QiXSKafPZNbWxu69T3fnCYUeCWQlLf3mFezT4143mlV/KqzGWQW4TEpXOwaq3XVhUuUkHb r3ZzYrDbRcS0C7KlPW20TAMMQcslg0LeA1EMcBHVbO54f9C+P47aw/n3dqynOLHUWbntORMtGO5 gpv/+yzdTRfYGhxPtvNUUsjqhJ5DJ7LbhQBFdjFXnZnTeyvRAlztBth3Vh/TiODeCVgt3rn9ZAt qsIhAUlzHsfwR25liw== X-Google-Smtp-Source: AGHT+IHJizaSrVLzbAzilDoDIRtrLYyuBtWhuUjQ2X15/tZP7ajY5JOe1CMSwjx/T02SrAl2x7EWkA== X-Received: by 2002:a05:620a:1b86:b0:7b6:e9db:3b21 with SMTP id af79cd13be357-7b6fbee80aemr1719079585a.14.1734285183406; Sun, 15 Dec 2024 09:53:03 -0800 (PST) Original-Received: from gnus (mtrlpq0776w-70-26-179-129.dsl.bell.ca. [70.26.179.129]) by smtp.gmail.com with ESMTPSA id af79cd13be357-7b7047f66fasm152068885a.69.2024.12.15.09.53.01 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 15 Dec 2024 09:53:02 -0800 (PST) In-Reply-To: <86r069s9dp.fsf@gnu.org> (Eli Zaretskii's message of "Sun, 15 Dec 2024 09:17:22 +0200") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:297116 Archived-At: Eli Zaretskii writes: >> Btw, based on my interpretation of the Org manual >> (info "(org) Texinfo specific export settings"), I would've expected the >> below to work: >>=20 >> #+begin_src diff >> -#+TEXINFO_DIR_TITLE: m-buffer-doc >> -#+TEXINFO_DIR_DESC: Manipulate the Contents of Emacs Buffers >> +#+TEXINFO_FILENAME: m-buffer-doc.texi >> +#+TEXINFO_DIR_NAME: m-buffer >> #+end_src > > Why do you suggest removing TEXINFO_DIR_TITLE Because of this comment in ox-texinfo.el which suggests that it is obsolete: #+begin_src emacs-lisp (:texinfo-dirtitle "TEXINFO_DIR_TITLE" nil nil t) ;Obsolete. #+end_src Elsewhere in the same file: #+begin_src emacs-lisp (dn (or (plist-get info :texinfo-dirname) (plist-get info :texinfo-dirtitle))) ;Obsolete name. #+end_src > and TEXINFO_DIR_DESC? Per (info "(org) Texinfo specific export settings"): #+begin_quote =E2=80=98TEXINFO_DIR_DESC=E2=80=99 The directory description of the document. Defaults to the title of the document. #+end_quote The Org document in question already has a TITLE specified. > And why is TEXINFO_FILENAME important? Per (info "(org) Texinfo specific export settings"): #+begin_quote =E2=80=98TEXINFO_FILENAME=E2=80=99 The Texinfo filename. #+end_quote Also, #+begin_quote =E2=80=98TEXINFO_DIR_NAME=E2=80=99 The directory name of the document. This is the short name under which the =E2=80=98m=E2=80=99 command will find your manual in the m= ain Info directory. It defaults to the base name of the Texinfo file. The full form of the Texinfo entry is =E2=80=98* DIRNAME: NODE.=E2= =80=99 where =E2=80=98NODE=E2=80=99 is usually just =E2=80=98(FILENAME)=E2=80=99.= Normally this option only provides the =E2=80=98DIRNAME=E2=80=99 part, but if you need more co= ntrol, it can also be the full entry (recognized by the presence of parentheses or a leading ~* ~). #+end_quote I interpreted "FILENAME" above to mean TEXINFO_FILENAME, which is also what's suggested by the code: #+begin_src emacs-lisp (file (or (org-strip-quotes (plist-get info :texinfo-filename)) (plist-get info :output-file))) #+end_src --=20 Suhail