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.bugs Subject: bug#44043: Info Files Showing "see" or "*note" when using @ref in source Date: Sat, 17 Oct 2020 14:48:32 +0300 Message-ID: <83blh1t6nj.fsf@gnu.org> References: <831rhxuxco.fsf@gnu.org> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="33854"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 44043-done@debbugs.gnu.org To: Christopher Dimech Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Oct 17 13:49:09 2020 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 1kTkhx-0008iW-LR for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 17 Oct 2020 13:49:09 +0200 Original-Received: from localhost ([::1]:42512 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kTkhw-0007NG-Nj for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 17 Oct 2020 07:49:08 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:44568) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kTkhq-0007Mi-GU for bug-gnu-emacs@gnu.org; Sat, 17 Oct 2020 07:49:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:50300) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kTkhq-0005cH-73 for bug-gnu-emacs@gnu.org; Sat, 17 Oct 2020 07:49:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kTkhq-0005f3-4q for bug-gnu-emacs@gnu.org; Sat, 17 Oct 2020 07:49:02 -0400 Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-To: bug-gnu-emacs@gnu.org Resent-Date: Sat, 17 Oct 2020 11:49:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: cc-closed 44043 X-GNU-PR-Package: emacs Mail-Followup-To: 44043@debbugs.gnu.org, eliz@gnu.org, dimech@gmx.com Original-Received: via spool by 44043-done@debbugs.gnu.org id=D44043.160293532121725 (code D ref 44043); Sat, 17 Oct 2020 11:49:01 +0000 Original-Received: (at 44043-done) by debbugs.gnu.org; 17 Oct 2020 11:48:41 +0000 Original-Received: from localhost ([127.0.0.1]:33612 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kTkhU-0005eL-Uu for submit@debbugs.gnu.org; Sat, 17 Oct 2020 07:48:41 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:37704) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kTkhT-0005e5-0r for 44043-done@debbugs.gnu.org; Sat, 17 Oct 2020 07:48:39 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:54155) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kTkhN-0005aL-CP; Sat, 17 Oct 2020 07:48:33 -0400 Original-Received: from [176.228.60.248] (port=4443 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1kTkhM-00014F-LU; Sat, 17 Oct 2020 07:48:33 -0400 In-Reply-To: (message from Christopher Dimech on Sat, 17 Oct 2020 12:47:17 +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" Xref: news.gmane.io gmane.emacs.bugs:190804 Archived-At: > From: Christopher Dimech > Cc: 44043@debbugs.gnu.org > Date: Sat, 17 Oct 2020 12:47:17 +0200 > > The Emacs Manual does not mention hide so did not try it. Now > that I have, the problem is resolved. The Emacs Manual needs > to be updated as the option is not described. It only describes > "t" and "nil". Here are the sections concerned: > > 1.5 Invisible text in Emacs Info > 1.7 Following Cross-References > 2.6 Emacs Info-mode Variables You mean, the Info mode manual, not the Emacs manual. I fixed the last one of these 3 sections, as only it includes the full description of the variable, and the other two only discuss limited effects of the variable. > Using M-x describe-variable Info-hide-note-references, > although if would help with an improved documentation. Indeed, the doc string of a variable is the recommended place to look first for the details of the variable. The manual could provide some background and more elaborate info, but it could also completely ignore the variable (we don't document every variable and every function in our manuals). With that, I'm closing this bug report. Thanks.