From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Po Lu Newsgroups: gmane.emacs.help Subject: Re: I'd like to request a change to the Emacs Info documentation Date: Fri, 21 Jan 2022 11:53:09 +0800 Message-ID: <87zgnpycbe.fsf@yahoo.com> References: Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="25584"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.60 (gnu/linux) Cc: help-gnu-emacs@gnu.org To: Ramin Honary Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Fri Jan 21 04:53:54 2022 Return-path: Envelope-to: geh-help-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 1nAkzq-0006Vg-9T for geh-help-gnu-emacs@m.gmane-mx.org; Fri, 21 Jan 2022 04:53:54 +0100 Original-Received: from localhost ([::1]:59842 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nAkzo-0000H1-Qu for geh-help-gnu-emacs@m.gmane-mx.org; Thu, 20 Jan 2022 22:53:52 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:59000) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nAkzQ-0000Gs-QU for help-gnu-emacs@gnu.org; Thu, 20 Jan 2022 22:53:28 -0500 Original-Received: from sonic316-21.consmr.mail.ne1.yahoo.com ([66.163.187.147]:33473) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nAkzO-0000X9-OV for help-gnu-emacs@gnu.org; Thu, 20 Jan 2022 22:53:28 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1642737204; bh=YOeTCYodDfryob3ES4vOd8QZy96tGNzlk0pTL8BIGQA=; h=From:To:Cc:Subject:References:Date:In-Reply-To:From:Subject:Reply-To; b=m39a+w+KhgJk/S5yRUnbaIA2urz1x3peXOjq2IR4Z8kb4JSxlKYXchbklmSj91LHBuQWyJHS2p7A4hJ1add3JizE+v5tCxhM1ovPI9eNnvyrCwrwb1BGl78CCjpRcJ3a4NjHHf9iPuDxJoBcr8xbeKQ5aGatxR3k/8IAZwYtVlpSzC0ndNnd5MGeySe5LeQEJysXpUfI9kgR+yr5Zuv5fdZq19lIDuKuTskkTYtJ9FB9KqLcx57vfFer2cbeIl0Eog7ymXST37Ttdjp6ZlHKth96GG7KwRrQyW4uoeVTMMa+FI8JSV/iJOr2dY9MVQ0UyvLgdM6Nibbo4q7i1XIl3A== X-SONIC-DKIM-SIGN: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1642737204; bh=pXLMOlVQqM8AqgLq+CFykYyw7nMjPwgH2aH2iHASj1D=; h=X-Sonic-MF:From:To:Subject:Date:From:Subject; b=qKEc4+TNtiMBgFp+g/yxKteAlz9AH9nfN/IyhJtmJxMFpT4d3066/kmLJY+rrN6oXX/ZJNJfIypracbvI5BBEWpW7y2rO0tHtThUvHtToYWAMHXMQCBJ9G61FQ8qUhqI+Mu6ceneapm/e0WnYAxSn5La8QASSlf+JnQBKD3+nG4eqRH4uok8Sfek/DQwZ/YUvUe3SRK072GQdETFTHzCBqrI1dzSa6erLOXmMX1Wrq16SrZoLnL1anb503ovsO36rKerY/pB2FVcEbCWLW0Q8aEvzQ7a60CyziLEZyHHDssuMGcbOkdxTTkZECW3yAX+W1dXBe+HMcRm+5On3uNHxw== X-YMail-OSG: ylKzGZYVM1kKgY1pMRzE1UpUmPjRQ1W.B6KHEerqtzK1ejv6WmSjvjtM4ydd6uc GsfC0Hnuy3V4mLWHpqv29w_GH6wpvmyG6PYSqipN7wJY0peiTw_4oge_3c6WBJVZ4WNuFRXohc39 a85KyBT8HybjoJliKHr73na0o1pBhiiux9vDflpwvpmHpSvopG0IBTDVQHHz52Oow90hsQHNtUwk Y7gZ4hA5aMu.5hzN6UlNcrOzS1K1wZzd9sVUkdZPEzZxmJWWUbPEK9fNah.UAeyoDnPktB8_cdhw w_ojPEC8kERr8Zo6rICHty7YkEilXDDmKtI6n4dFr6FbCkQDz4_hAwY.IxGdL3.gizrPm39eoBfv xgPXaGjPJky06RMql1LFeOLsIXxot3au3AoCPKXrPqgAxYCJAGZY5eShEmNG9awTzsXf_a8tELw4 ZFJ16pfZjGkcmIinxpycCLPTbyqqhPDaoBgYBE3K6sMi4cnJ46ZFKJLrKQiiB083V32u0Zx_APiO cBhYtUmdwDg0rqHLEOMbWRn.WKhznw9wh1kbrut7aTUUH2.C7FB7HnEiPS8MuryTEboJXxJ5ag5D Eo7gKPbVKiY22c93Tg0JJNFMmdUBDPeimOvLgcxshECWVKMBA1LCd9aFJAee.5iuK_R58.V9FOQn mpMWWGBMRG8Binb3SCxiQrKkg8XZAb6qSvwgk7airEXl6DjxWVyzFJdDsvwz4DFtaIvmwM1FZdqb 3deU3J_IYquOnqoXVSk1hnpKNsFo._TBfVJNDufpbgb2_OA_7CA42YnKh8IQq1SW06tULung4BJ_ BQSm_9WE268kLeKQSBG_yRadO8LBH5sh2FZ4h0cB2I X-Sonic-MF: Original-Received: from sonic.gate.mail.ne1.yahoo.com by sonic316.consmr.mail.ne1.yahoo.com with HTTP; Fri, 21 Jan 2022 03:53:24 +0000 Original-Received: by kubenode514.mail-prod1.omega.sg3.yahoo.com (VZM Hermes SMTP Server) with ESMTPA ID 03ac6021c192fce5e473a3e9d720e20c; Fri, 21 Jan 2022 03:53:20 +0000 (UTC) In-Reply-To: (Ramin Honary's message of "Fri, 21 Jan 2022 12:38:36 +0900") X-Mailer: WebService/1.1.19615 mail.backend.jedi.jws.acl:role.jedi.acl.token.atz.jws.hermes.yahoo Received-SPF: pass client-ip=66.163.187.147; envelope-from=luangruo@yahoo.com; helo=sonic316-21.consmr.mail.ne1.yahoo.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 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_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "help-gnu-emacs" Xref: news.gmane.io gmane.emacs.help:135464 Archived-At: Ramin Honary writes: > Hello, everyone. I thought it would be better to ask my question here > first, so I don't end up adding noise to the emacs-devel@gnu.org > mailing list. This isn't much of a question, so I think it should be sent to bug-gnu-emacs or emacs-devel instead. > I would like to change the top-level node of the Info document for > Emacs so that it displays in prominent lettering how to do index > search (bound to the "i" key) and full text search (bound to the "s" > key) at the top of the document. I would like it to read: > > SEARCH IN THIS MANUAL: > - Press `i` to enter an index search term > - Press `m` to search this "menu" (the table of contents) Does `m' really search the menu? I thought it just asks for a menu item to jump to. > - Press `s` to do a full text search. This should probably mention that regexps are accepted. > - Press `q` to quit (close this screen) I don't understand what kind of screen you refer to here. > Search is not an "advanced" feature, it is *essential.* And I would > argue that any mention of the most important feature of an interactive > documentation browser has been completely buried, which is > unfortunate. I-search works in Info, so most Emacs users would probably try that first. Secondly, I think the best place to place this information (if the advanced search functionality is indeed as important as you say it is, of that I have no opinion) would be somewhere in section 1 of the Info manual, instead of some extra text at the top level of the directory node, since that text is not generated by Emacs. Also, doesn't this kind of change have to be coordinated with the stand-alone Info developers? IIRC, the same documentation is used by both Info readers. Thanks.