From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Miles Bader Newsgroups: gmane.emacs.devel Subject: Re: help-fns.el patch for commands to describe options and commands Date: Sun, 21 Oct 2007 11:46:53 +0900 Message-ID: <87r6jp6v6q.fsf@catnip.gol.com> References: Reply-To: Miles Bader NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1192934845 23391 80.91.229.12 (21 Oct 2007 02:47:25 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 21 Oct 2007 02:47:25 +0000 (UTC) Cc: rms@gnu.org, Drew Adams , emacs-devel@gnu.org To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Oct 21 04:47:25 2007 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1IjQqa-0002FM-Cv for ged-emacs-devel@m.gmane.org; Sun, 21 Oct 2007 04:47:24 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1IjQqS-0005Ab-MF for ged-emacs-devel@m.gmane.org; Sat, 20 Oct 2007 22:47:16 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1IjQqP-0005AB-BM for emacs-devel@gnu.org; Sat, 20 Oct 2007 22:47:13 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1IjQqO-00059z-QJ for emacs-devel@gnu.org; Sat, 20 Oct 2007 22:47:13 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1IjQqO-00059w-Ki for emacs-devel@gnu.org; Sat, 20 Oct 2007 22:47:12 -0400 Original-Received: from smtp02.dentaku.gol.com ([203.216.5.72]) by monty-python.gnu.org with esmtps (TLS-1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1IjQqD-00064I-DO; Sat, 20 Oct 2007 22:47:02 -0400 Original-Received: from 203-216-97-240.dsl.gol.ne.jp ([203.216.97.240] helo=catnip.gol.com) by smtp02.dentaku.gol.com with esmtpa (Dentaku) id 1IjQq7-0007aO-BM; Sun, 21 Oct 2007 11:46:55 +0900 Original-Received: by catnip.gol.com (Postfix, from userid 1000) id EE87B2F4B; Sun, 21 Oct 2007 11:46:53 +0900 (JST) System-Type: i686-pc-linux-gnu In-Reply-To: (Stefan Monnier's message of "Sat\, 20 Oct 2007 22\:09\:45 -0400") Original-Lines: 27 X-Abuse-Complaints: abuse@gol.com X-detected-kernel: by monty-python.gnu.org: Linux 2.6, seldom 2.4 (older, 4) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:81330 Archived-At: Stefan Monnier writes: >> Yes. When you are looking for a command, you don't want to see a zillion >> non-interactive functions as candidates. This cuts down that noise >> *considerably*. > > I could buy that. But those users for whom it matters most won't know to > use the C-u prefix. And usually the C-u prefix means something like "give > me more control", so it would make more sense to only list commands/options > and let C-u specify that we actually want to see all functions/variables. I dunno which way should be the default (though I favor the backward compatible way, I guess), but please, add the functionality, because it's _useful_ (I'm not talking about newbies, just about my own use; probably it's useful to newbies in some form too). I very often want to peruse the _user interface_ of a package is, and tend to do this by using "C-h C-f prefix- ?", see what functions there are, then type the name of one to see how it works. Clearly this gets tons of noise from the non-command functions, and so it would be _very_ useful to have a command-only version of C-h C-f. -Miles -- [|nurgle|] ddt- demonic? so quake will have an evil kinda setting? one that will make every christian in the world foamm at the mouth? [iddt] nurg, that's the goal