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: 22 Apr 2002 09:56:35 -0700 Sender: emacs-devel-admin@gnu.org Message-ID: References: <87vgal3w79.fsf@tleepslib.sk.tsukuba.ac.jp> <2950-Sun21Apr2002220958+0300-eliz@is.elta.co.il> NNTP-Posting-Host: localhost.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: main.gmane.org 1019494672 16611 127.0.0.1 (22 Apr 2002 16:57:52 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Mon, 22 Apr 2002 16:57:52 +0000 (UTC) Cc: stephen@xemacs.org, 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 16zh8S-0004Jo-00 for ; Mon, 22 Apr 2002 18:57:52 +0200 Original-Received: from fencepost.gnu.org ([199.232.76.164]) by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian)) id 16zh9F-0001cO-00 for ; Mon, 22 Apr 2002 18:58:41 +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 16zh8G-0002MK-00; Mon, 22 Apr 2002 12:57: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 16zh7H-0002IT-00; Mon, 22 Apr 2002 12:56:39 -0400 Original-Received: (from bradym@localhost) by sandman.balestra.org (8.10.2/8.10.2) id g3MGuaR03295; Mon, 22 Apr 2002 09:56:36 -0700 (PDT) X-Authentication-Warning: sandman.balestra.org: bradym set sender to bradym@balestra.org using -f Original-To: Eli Zaretskii In-Reply-To: <2950-Sun21Apr2002220958+0300-eliz@is.elta.co.il> Original-Lines: 29 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:3043 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:3043 "Eli Zaretskii" writes: > > From: Brady Montz > > Date: 21 Apr 2002 10:17:13 -0700 > > > > 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. > > How about sending bug reports about the missing references? Or even > suggesting what related functions/variables should be mentioned in > specific doc string? Well, I'm not sure the doc string is the right place for all that actually. At the very least, I've seen so few doc strings with a full set of cross-references that if it is a bug report, it would be a pretty big one. > > 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, ... > > I think "C-h a sort-" would have told you that faster... see my other reply to Stephen Turnbull -- Brady Montz bradym@balestra.org