From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: "Stephen J. Turnbull" Newsgroups: gmane.emacs.devel Subject: Re: The minibuffer vs. Dialog Boxes (Re: Making XEmacs be more up-to-date) Date: 22 Apr 2002 11:58:55 +0900 Organization: The XEmacs Project Sender: emacs-devel-admin@gnu.org Message-ID: References: <87vgal3w79.fsf@tleepslib.sk.tsukuba.ac.jp> NNTP-Posting-Host: localhost.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: main.gmane.org 1019444470 9405 127.0.0.1 (22 Apr 2002 03:01:10 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Mon, 22 Apr 2002 03:01:10 +0000 (UTC) Cc: xemacs-design@xemacs.org, emacs-devel@gnu.org Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by main.gmane.org with esmtp (Exim 3.33 #1 (Debian)) id 16zU4k-0002Ra-00 for ; Mon, 22 Apr 2002 05:01:10 +0200 Original-Received: from fencepost.gnu.org ([199.232.76.164]) by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian)) id 16zU5F-00084U-00 for ; Mon, 22 Apr 2002 05:01:42 +0200 Original-Received: from localhost ([127.0.0.1] helo=fencepost.gnu.org) by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian)) id 16zU4N-0005Jm-00; Sun, 21 Apr 2002 23:00:47 -0400 Original-Received: from tleepslib.sk.tsukuba.ac.jp ([130.158.98.109]) by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian)) id 16zU3M-0005DL-00 for ; Sun, 21 Apr 2002 22:59:44 -0400 Original-Received: from steve by tleepslib.sk.tsukuba.ac.jp with local (Exim 3.35 #1 (Debian)) id 16zU2a-0004av-00; Mon, 22 Apr 2002 11:58:56 +0900 Original-To: Brady Montz In-Reply-To: Original-Lines: 54 User-Agent: Gnus/5.0808 (Gnus v5.8.8) XEmacs/21.4 (Common Lisp) X-Delivery-Agent: TMDA/0.51 (Python 2.1.3 on Linux/i686) Errors-To: emacs-devel-admin@gnu.org X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.0.9 Precedence: bulk List-Help: List-Post: List-Subscribe: , List-Id: Emacs development discussions. List-Unsubscribe: , List-Archive: Xref: main.gmane.org gmane.emacs.devel:2971 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:2971 >>>>> "Brady" == Brady Montz writes: Brady> "Stephen J. Turnbull" writes: >> Hm, I use them all the time. My only complaint is that we only >> have mouse bindings for them. I'd like to be able to type RET >> on them. Bonus points if C-x o TAB TAB RET Does The Right >> Thing. Brady> I didn't say you didn't use them. Just that I haven't seen Brady> many doc strings that take much advantage of them for the Brady> "see also" purpose. Brady> Taking my running example of sort-lines, It's doc tells me Brady> about it's config variable sort-fold-case, but I had to do I would say that's exactly right for a docstring. Brady> a find-library sort to look at the source to find out about Brady> sort-paragraphs, sort-pages, sort-fields, ... That may be what _you_ resorted to, but besides Eli's suggestion of C-h a sort- RET, there's C-h C-f sort-lines RET (output appended below; taller than you would get on a 80x24 TTY, but the line containing "sort-paragraphs" would almost certainly appear). My conclusion is that we don't need to redo all the docstrings, but rather to educate people better about the available help functions. ------------------------------------------------------------------------ resulting expression looks like this: (sort-regexp-fields nil "^.*$" "\\" (region-beginning) (region-end)) If you call `sort-regexp-fields' interactively, it prompts for RECORD-REGEXP and KEY-REGEXP in the minibuffer. - Command: sort-lines reverse start end This command alphabetically sorts lines in the region between START and END. If REVERSE is non-`nil', the sort is in reverse order. - Command: sort-paragraphs reverse start end This command alphabetically sorts paragraphs in the region between START and END. If REVERSE is non-`nil', the sort is in reverse order. ------------------------------------------------------------------------ -- Institute of Policy and Planning Sciences http://turnbull.sk.tsukuba.ac.jp University of Tsukuba Tennodai 1-1-1 Tsukuba 305-8573 JAPAN Don't ask how you can "do" free software business; ask what your business can "do for" free software.