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: 24 Apr 2002 02:09:57 +0900 Organization: The XEmacs Project Sender: emacs-devel-admin@gnu.org Message-ID: References: <87vgal3w79.fsf@tleepslib.sk.tsukuba.ac.jp> <87vgak30cw.fsf@tleepslib.sk.tsukuba.ac.jp> <7263-Mon22Apr2002224014+0300-eliz@is.elta.co.il> <87bscbysbm.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 1019581948 31445 127.0.0.1 (23 Apr 2002 17:12:28 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Tue, 23 Apr 2002 17:12:28 +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 1703q8-0008B2-00 for ; Tue, 23 Apr 2002 19:12:28 +0200 Original-Received: from fencepost.gnu.org ([199.232.76.164]) by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian)) id 1703rP-0000tP-00 for ; Tue, 23 Apr 2002 19:13:47 +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 1703py-0007Yf-00; Tue, 23 Apr 2002 13:12:18 -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 1703oT-0007Tb-00 for ; Tue, 23 Apr 2002 13:10:46 -0400 Original-Received: from steve by tleepslib.sk.tsukuba.ac.jp with local (Exim 3.35 #1 (Debian)) id 1703ni-0002P3-00; Wed, 24 Apr 2002 02:09:58 +0900 Original-To: Brady Montz In-Reply-To: Original-Lines: 36 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:3117 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:3117 >>>>> "Brady" == Brady Montz writes: Brady> "Stephen J. Turnbull" writes: >> But more what? Does that mean go from the docstring to Info >> page (and should that be the User Guide or the Lispref?), or >> the mode's keymap wallpaper, or the mode docstring, or >> hyperapropos, or Info index? Or (dare I say it?) help-on-help? Brady> Sounds like a good start to me. But describing it took 5 lines, and putting in the xrefs themselves won't be much less ... many docstrings are two or three. Overkill, I think, and pretty quickly very annoying. TBH, I don't see the kind of concrete example/suggestion here that I could take and run with, not yet. Brady> However, I have found MSDN, especially the newer content Brady> which appears to have a higher quality standard, to be very Brady> useful though. I've satisfied 90% of my windows API Brady> questions by wandering about there, and have learned lots Brady> of unasked for but very useful stuff along the way. This is exactly what Eli and I recommend that you do with the Emacs docs ... wander about. Hm. I see some difference between Emacs and Windows, but enough similarity in scale and scope to justify the analogy. -- 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.