From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.devel Subject: Re: Prefixed manual describe-function and api overview Date: Fri, 05 Jun 2020 23:59:05 -0400 Message-ID: References: Reply-To: rms@gnu.org Content-Type: text/plain; charset=Utf-8 Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="61429"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Philippe Vaucher Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat Jun 06 05:59:42 2020 Return-path: Envelope-to: ged-emacs-devel@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 1jhPzi-000FuO-5q for ged-emacs-devel@m.gmane-mx.org; Sat, 06 Jun 2020 05:59:42 +0200 Original-Received: from localhost ([::1]:56726 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jhPzh-0006df-8i for ged-emacs-devel@m.gmane-mx.org; Fri, 05 Jun 2020 23:59:41 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:59136) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jhPz9-0006Bp-Kv for emacs-devel@gnu.org; Fri, 05 Jun 2020 23:59:07 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:54629) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jhPz9-0003v4-Be; Fri, 05 Jun 2020 23:59:07 -0400 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.82) (envelope-from ) id 1jhPz7-0008OA-FQ; Fri, 05 Jun 2020 23:59:05 -0400 In-Reply-To: (message from Philippe Vaucher on Fri, 5 Jun 2020 09:55:08 +0200) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:251929 Archived-At: [[[ To any NSA and FBI agents reading my email: please consider ]]] [[[ whether defending the US Constitution against all enemies, ]]] [[[ foreign or domestic, requires you to follow Snowden's example. ]]] > It is like `describe-function` > (C-h f), but before you get to select a function you have to select a > "topic" first. The topics are the clickable links at > https://www.gnu.org/software/emacs/manual/html_node/elisp/index.html#Top. > Once you select a topic, then you get to select a function but your > choices are limited to the functions of said topic. It is worth a try. Let's see whether users find that helps them find the information they are looking for. To find out whether users find it helpful, we might want to publish it and ask users to try it. Here's an idea: make describe-function accept topic names as well as function names. When the input is a topic name, it would follow up by doing what you've implemented. If the minibuffer prompt explains this feature, users might discover it on their own. And it won't require a new command. -- Dr Richard Stallman Chief GNUisance of the GNU Project (https://gnu.org) Founder, Free Software Foundation (https://fsf.org) Internet Hall-of-Famer (https://internethalloffame.org)