From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Alex Schroeder Newsgroups: gmane.emacs.xemacs.design,gmane.emacs.devel Subject: Re: INFO on add-ons Date: Wed, 04 Sep 2002 02:48:45 +0200 Sender: xemacs-design-admin@xemacs.org Message-ID: <87u1l6pok2.fsf@emacswiki.org> References: <3D728E82.8000808@cox.net> <87vg5pe4pr.fsf@emacswiki.org> <3D73F919.5010706@cox.net> <873csqr8b9.fsf@emacswiki.org> NNTP-Posting-Host: localhost.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: main.gmane.org 1031100337 9114 127.0.0.1 (4 Sep 2002 00:45:37 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Wed, 4 Sep 2002 00:45:37 +0000 (UTC) Cc: xemacs-design@xemacs.org Return-path: Original-Received: from gwyn.tux.org ([207.96.1.200]) by main.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 17mOIZ-0002Ms-00 for ; Wed, 04 Sep 2002 02:45:35 +0200 Original-Received: from gwyn.tux.org (localhost.localdomain [127.0.0.1]) by gwyn.tux.org (8.9.3/8.9.1) with ESMTP id UAA19311; Tue, 3 Sep 2002 20:47:06 -0400 Original-Received: (from turnbull@localhost) by gwyn.tux.org (8.9.3/8.9.1) id UAA19288 for xemacs-design-mailman@xemacs.org; Tue, 3 Sep 2002 20:46:41 -0400 Original-Received: (from mail@localhost) by gwyn.tux.org (8.9.3/8.9.1) id UAA19284 for turnbull@tux.org; Tue, 3 Sep 2002 20:46:41 -0400 Original-Received: from relay03.cablecom.net (relay03.cablecom.net [62.2.33.103]) by gwyn.tux.org (8.9.3/8.9.1) with ESMTP id UAA19280 for ; Tue, 3 Sep 2002 20:46:40 -0400 Original-Received: from smtp.swissonline.ch (mail-4.swissonline.ch [62.2.32.85]) by relay03.cablecom.net (8.12.5/8.12.5/SOL/AWF/MXRELAY/20020820) with ESMTP id g840kYMO049939; Wed, 4 Sep 2002 02:46:37 +0200 (CEST) (envelope-from alex@emacswiki.org) Original-Received: from confusibombus (dclient217-162-239-43.hispeed.ch [217.162.239.43]) by smtp.swissonline.ch (8.11.6/8.11.6/SMTPSOL/AWF/2002040101) with ESMTP id g840kYH11019; Wed, 4 Sep 2002 02:46:34 +0200 (MEST) Original-Received: from alex by confusibombus with local (Exim 3.35 #1 (Debian)) id 17mOLd-00009p-00; Wed, 04 Sep 2002 02:48:45 +0200 Original-To: emacs-devel@gnu.org X-Face: ^BC$`[IcggstLPyen&dqF+b2'zyK#r.mU*'Nms}@&4zw%SJ#5!/7SMVjBS7'lb;QK)|IPU5U'o1'522W4TyzB3Ab*IBo^iw]l4|kUbdZuUDO6=Um-.4IzhNiV'B"@K#jy_(wW|Zbk[34flKY^|PrQ?$u2\fKg^]AY>wOX#H32i In-Reply-To: <873csqr8b9.fsf@emacswiki.org> (Alex Schroeder's message of "Wed, 04 Sep 2002 00:56:42 +0200") Original-Lines: 15 User-Agent: Gnus/5.090008 (Oort Gnus v0.08) Emacs/21.2.90 (i686-pc-linux-gnu) X-XEmacs-List: design Errors-To: xemacs-design-admin@xemacs.org X-BeenThere: xemacs-design@xemacs.org X-Mailman-Version: 2.0.1 Precedence: bulk List-Help: List-Post: List-Subscribe: , List-Id: Discussion of design and features for XEmacs. List-Unsubscribe: , Xref: main.gmane.org gmane.emacs.xemacs.design:1361 gmane.emacs.devel:7414 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:7414 Alex Schroeder writes: > I would rather just put the stuff in the Commentary section, and > provide as much help as possible in the defgroup, defcustom, and > defun statements. These docstrings are what programmers and users > use in their daily life. I forgot to mention this: Emacs is supposed to be a self-documenting editor. Therefore, we should try to support that notion. Only if doc strings and commentaries (readable via package finder in Emacs, perhaps there needs to be a better interface?) fail, should we need to write Info. As I said this is for newbies, and pulling stuff together. Alex.