From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Brady Montz Newsgroups: gmane.emacs.devel Subject: Re: The minibuffer vs. Dialog Boxes (Re: Making XEmacs be more up-to-date) Date: 21 Apr 2002 10:17:13 -0700 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 1019409532 4298 127.0.0.1 (21 Apr 2002 17:18:52 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Sun, 21 Apr 2002 17:18:52 +0000 (UTC) Cc: Eli Zaretskii , rms@gnu.org, 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 16zKzE-00017D-00 for ; Sun, 21 Apr 2002 19:18:52 +0200 Original-Received: from fencepost.gnu.org ([199.232.76.164]) by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian)) id 16zKzX-0003RF-00 for ; Sun, 21 Apr 2002 19:19:11 +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 16zKz2-0003NO-00; Sun, 21 Apr 2002 13:18:40 -0400 Original-Received: from c64-255-216-95.sea1.cablespeed.com ([64.255.216.95] helo=sandman.balestra.org) by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian)) id 16zKxh-0003Lu-00; Sun, 21 Apr 2002 13:17:17 -0400 Original-Received: (from bradym@localhost) by sandman.balestra.org (8.10.2/8.10.2) id g3LHHDQ03574; Sun, 21 Apr 2002 10:17:13 -0700 (PDT) X-Authentication-Warning: sandman.balestra.org: bradym set sender to bradym@balestra.org using -f Original-To: "Stephen J. Turnbull" In-Reply-To: <87vgal3w79.fsf@tleepslib.sk.tsukuba.ac.jp> Original-Lines: 30 User-Agent: Gnus/5.0808 (Gnus v5.8.8) XEmacs/21.5 (bamboo) 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:2948 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:2948 "Stephen J. Turnbull" writes: > >>>>> "Brady" == Brady Montz writes: > > [re cross-references in docstrings] > > Brady> Yeah, not too far off here. That is nice, but I've seen few > Brady> docstrings that make much use of it. > > 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. I didn't say you didn't use them. Just that I haven't seen many doc strings that take much advantage of them for the "see also" purpose. Taking my running example of sort-lines, It's doc tells me about it's config variable sort-fold-case, but I had to do a find-library sort to look at the source to find out about sort-paragraphs, sort-pages, sort-fields, ... And, taking this example further, I've actually been wanting sort-paragraphs for years but never enough or at the right time to take the effort of looking for it. While I'm pleased with myself that I'd finally found it, this is precisely the sort of thing I wish had jumped out at me long ago. -- Brady Montz bradym@balestra.org