From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.devel Subject: RE: line-move-visual Date: Fri, 10 Jul 2009 09:11:54 -0700 Message-ID: References: <200907092112.21879.jem@iki.fi> <87ws6hupsk.fsf@bzg.ath.cx> <87ocrtulzd.fsf@bzg.ath.cx> <87tz1lja6l.fsf@bzg.ath.cx><87prc8ucfq.fsf@thinkpad.tsdh.de> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1247242649 7955 80.91.229.12 (10 Jul 2009 16:17:29 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 10 Jul 2009 16:17:29 +0000 (UTC) Cc: 'Bastien' , 'Kenichi Handa' , jem@iki.fi, emacs-devel@gnu.org To: "'Scot Becker'" , "'Miles Bader'" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Jul 10 18:17:21 2009 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1MPImm-0005qq-Iv for ged-emacs-devel@m.gmane.org; Fri, 10 Jul 2009 18:17:21 +0200 Original-Received: from localhost ([127.0.0.1]:47950 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MPIml-00052h-FW for ged-emacs-devel@m.gmane.org; Fri, 10 Jul 2009 12:17:19 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MPIho-00019o-Ae for emacs-devel@gnu.org; Fri, 10 Jul 2009 12:12:12 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MPIhj-000130-LF for emacs-devel@gnu.org; Fri, 10 Jul 2009 12:12:11 -0400 Original-Received: from [199.232.76.173] (port=34704 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MPIhj-00012o-Fl for emacs-devel@gnu.org; Fri, 10 Jul 2009 12:12:07 -0400 Original-Received: from acsinet11.oracle.com ([141.146.126.233]:54768) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MPIhg-0007b6-Mq; Fri, 10 Jul 2009 12:12:05 -0400 Original-Received: from rgminet15.oracle.com (rcsinet15.oracle.com [148.87.113.117]) by acsinet11.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n6AGBxIU014079 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Fri, 10 Jul 2009 16:12:00 GMT Original-Received: from abhmt003.oracle.com (abhmt003.oracle.com [141.146.116.12]) by rgminet15.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n6AGC45N026505; Fri, 10 Jul 2009 16:12:05 GMT Original-Received: from dradamslap1 (/24.5.190.74) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Fri, 10 Jul 2009 09:11:55 -0700 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: Thread-Index: AcoBSI5KZLYZ2XkpSRyk26NKRU5xSwALqoEA X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5579 X-Source-IP: abhmt003.oracle.com [141.146.116.12] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A010202.4A57684D.0021:SCFSTAT5015188,ss=1,fgs=0 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 1) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:112313 Archived-At: > A few helpful additions would be that (1) there would > be a way for users to create such customization groups for > distribution to other users. They wouldn't be hard-coded, like > today's customization groups (apparently are). Yes; see my other reply. It would help to make it easier for users to group options (and faces). > And (2) ideally there'd be the opportunity to optionally include > extended user documentation in amongst the variables to give guidance > beyond what one might find in the docstrings. The docstrings can be a > bit minimal if what you want to do is explain the significance of > various choices to a user who is only now encountering some new > concept lying behind a variable. That's OK, but it's the sharing of such annotations that is most helpful. Your adding helpful info to a doc string locally doesn't help me understand it better where I am. It's helpful to send a bug report with the suggestion, so it can be incorporated for others to see too. The problem with that is that the official doc must be a one-size-fits-all, to some extent. An alternative is to share your extra doc using Emacs Wiki. One possibility might be (_might_ be - just thinking out loud) to have a doc string link to an EmacsWiki page that details only that variable, function, or whatever. This would be somewhat like a doc string link to the manual, but the difference is that anyone can participate in any way in editing the wiki page. Just half-baked food for thought.