From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Hong Xu Newsgroups: gmane.emacs.bugs Subject: bug#25033: [PATCH] Add a missing index for `man'. Date: Sat, 26 Nov 2016 02:06:02 -0800 Message-ID: <8760nav9md.fsf@topbug.net> References: <1480151906-14773-1-git-send-email-hong@topbug.net> <83zikm1tdj.fsf@gnu.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha1; protocol="application/pgp-signature" X-Trace: blaine.gmane.org 1480154832 10067 195.159.176.226 (26 Nov 2016 10:07:12 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 26 Nov 2016 10:07:12 +0000 (UTC) User-Agent: mu4e 0.9.17; emacs 25.1.50.14 Cc: 25033@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Nov 26 11:07:08 2016 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cAZsx-0001tf-R4 for geb-bug-gnu-emacs@m.gmane.org; Sat, 26 Nov 2016 11:07:07 +0100 Original-Received: from localhost ([::1]:49875 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cAZt1-00024m-AB for geb-bug-gnu-emacs@m.gmane.org; Sat, 26 Nov 2016 05:07:11 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:50867) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cAZsw-00024g-43 for bug-gnu-emacs@gnu.org; Sat, 26 Nov 2016 05:07:07 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cAZss-0002ux-US for bug-gnu-emacs@gnu.org; Sat, 26 Nov 2016 05:07:06 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:54972) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1cAZss-0002tz-Qt for bug-gnu-emacs@gnu.org; Sat, 26 Nov 2016 05:07:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1cAZss-00024a-Fp for bug-gnu-emacs@gnu.org; Sat, 26 Nov 2016 05:07:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Hong Xu Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 26 Nov 2016 10:07:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 25033 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 25033-submit@debbugs.gnu.org id=B25033.14801547747913 (code B ref 25033); Sat, 26 Nov 2016 10:07:02 +0000 Original-Received: (at 25033) by debbugs.gnu.org; 26 Nov 2016 10:06:14 +0000 Original-Received: from localhost ([127.0.0.1]:42138 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cAZs6-00023Z-Ij for submit@debbugs.gnu.org; Sat, 26 Nov 2016 05:06:14 -0500 Original-Received: from sender163-mail.zoho.com ([74.201.84.163]:21429) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cAZs5-00023P-0d for 25033@debbugs.gnu.org; Sat, 26 Nov 2016 05:06:13 -0500 Original-Received: from localhost (cpe-104-32-170-214.socal.res.rr.com [104.32.170.214]) by mx.zohomail.com with SMTPS id 148015476641032.70381663478713; Sat, 26 Nov 2016 02:06:06 -0800 (PST) In-reply-to: <83zikm1tdj.fsf@gnu.org> X-Zoho-Virus-Status: 1 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 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.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:126113 Archived-At: --=-=-= Content-Type: text/plain On 2016-11-26 Sat 01:29 GMT-0800, Eli Zaretskii wrote: >> From: Hong Xu >> Date: Sat, 26 Nov 2016 01:18:26 -0800 >> >> * programs.texi (Man Page): Add the index for `man'. >> --- >> doc/emacs/programs.texi | 1 + >> 1 file changed, 1 insertion(+) >> >> diff --git a/doc/emacs/programs.texi b/doc/emacs/programs.texi >> index e409affd67d1..fc9f8e88b47a 100644 >> --- a/doc/emacs/programs.texi >> +++ b/doc/emacs/programs.texi >> @@ -1193,6 +1193,7 @@ Man Page >> with Info (@pxref{Misc Help}). This process is not finished, so it is >> still useful to read manual pages. >> >> +@findex man >> @findex manual-entry >> You can read the man page for an operating system command, library >> function, or system call, with the @kbd{M-x man} command. This > > If I type "i man RET" in the current Emacs manual, I land in that > node, and "i man TAB" produces a list of completions one of which is > "man pages", which leads to the same node. So why did you see the > need for adding this index entry? The missing index actually confused me when I searched the manual for it, as it was hidden in my completion list. The main reason is though for the completeness of the documentation -- "man" should be an indexed function name just like "manual-entry". I don't see how it could be harmful to add this index, although the benefit may also not be significant. --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v1 iQIcBAEBAgAGBQJYOV6KAAoJECZsfTOCL4R4X1cP/0kSwtySpH/UfBxQj300lsS6 xrMnLzFPgKfQM7FhxF3q+Knut2TNtIpGIwK7De9J68FclkDMdoRhupPp2ULC0YGe J1aCe2RstOQBeLL7pyql66dQX1h5Gp+uqmMxN3BhviKHb5inL1+ofdGFnvnj5tLl t78suVZETYe4yA0N8FyPLozsWXS4wkPo0XJhExDBkzSu8no9ewPs/RtkDWtnFlOz bGz46y563IpN5ZNzlveMHWKt1bcLFo1EklAPMOQl0goNEN/XeAz4yXInDkeAmRNC MjZ7bxKMRyoEHspXJCy9fDKZONwESZ7n/nlaTctUWrs6kgGKdT/u31Su+RET216t O7waUUt7cfGsBoP0f9LPTg/br1gEzklXnNeTx9SM489BIBteLQkV6vrEeG3jvFBp OEPHpAbLnHVzEbLurHst2Qanc7RGqAH0XtmMZwomAMsYSicrdXZCCTL9ipQuSdAg LtR0w9hMRwaiRkXXo5CK/rxKDfU71ABehhFLjXq8789cYyflj9BAPun/7KsjS8rb gnXggCsjZ+w0ZRgu4YkjEmBbsUiXn4BWlXXFBIohGOjA85BNo1FQK/o8H6pzQyJh hpMbRWJV8H4+EwkALG7LZQyxcuDPLPHvpsnmZ5hboTGPdmKQ5YPWWXTmo0YeBsZA I3lsCNrGXU+X55986fjP =fzRp -----END PGP SIGNATURE----- --=-=-=--