From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: "Stefan Monnier" Newsgroups: gmane.emacs.devel Subject: Re: proposed new variable `emacs-lisp-docstring-fill-column' Date: Sat, 01 Mar 2003 15:38:16 -0500 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <200303012038.h21KcGr24763@rum.cs.yale.edu> References: NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: main.gmane.org 1046552008 5744 80.91.224.249 (1 Mar 2003 20:53:28 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Sat, 1 Mar 2003 20:53:28 +0000 (UTC) Cc: emacs-devel@gnu.org Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by main.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 18pDz5-0001UU-00 for ; Sat, 01 Mar 2003 21:53:27 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian)) id 18pEH8-0004SV-00 for ; Sat, 01 Mar 2003 22:12:06 +0100 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 18pDv7-0002I5-01 for emacs-devel@quimby.gnus.org; Sat, 01 Mar 2003 15:49:21 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.10.13) id 18pDsx-0001vB-00 for emacs-devel@gnu.org; Sat, 01 Mar 2003 15:47:07 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.10.13) id 18pDph-0000xt-00 for emacs-devel@gnu.org; Sat, 01 Mar 2003 15:44:01 -0500 Original-Received: from rum.cs.yale.edu ([128.36.229.169]) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 18pDkr-0008Mj-00 for emacs-devel@gnu.org; Sat, 01 Mar 2003 15:38:45 -0500 Original-Received: (from monnier@localhost) by rum.cs.yale.edu (8.11.6/8.11.6) id h21KcGr24763; Sat, 1 Mar 2003 15:38:16 -0500 X-Mailer: exmh version 2.4 06/23/2000 with nmh-1.0.4 Original-To: Matt Swift X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1b5 Precedence: list List-Id: Emacs development discussions. List-Help: List-Post: List-Subscribe: , List-Archive: List-Unsubscribe: , Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:12050 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:12050 > > rms> It sounds like a good idea; would you like to implement the code > rms> to actually use it, and show us that? > > Here's the whole change. I've been using it happily for a dozen or > two hours of working in Emacs Lisp mode. I'm noticing other bugs in > filling ELisp, but they're not due to this change. I don't like this change because docstrings shouldn't be limted to 65 chars. The doc only says that they should fit within 80 columns. Only the first line should be shorter. > (2) add "`(" to `paragraph-start' so that `defmacro's whose bodies > begin with backquote (i.e. most of them) will fill properly. > This requires ?( to be escaped when "`(" begins a line in a > docstring. I think good style would escape all ?( chars in > a docstring. > (3) recognize (and thus do not fill) a docstring's first line when > it ends with ?, as well as ?. Checkdoc-mode optionally permits > a comma, so let's have filling recognize that situation. I have no opinion on this part, on the other hand. Stefan