From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Matt Swift Newsgroups: gmane.emacs.devel Subject: Re: proposed new variable `emacs-lisp-docstring-fill-column' Date: Sat, 01 Mar 2003 15:54:56 -0500 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: References: <200303012038.h21KcGr24763@rum.cs.yale.edu> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: main.gmane.org 1046552293 6535 80.91.224.249 (1 Mar 2003 20:58:13 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Sat, 1 Mar 2003 20:58:13 +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 18pE3f-0001hH-00 for ; Sat, 01 Mar 2003 21:58:11 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian)) id 18pELi-0004Uk-00 for ; Sat, 01 Mar 2003 22:16:50 +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 18pE3d-0005nQ-05 for emacs-devel@quimby.gnus.org; Sat, 01 Mar 2003 15:58:09 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.10.13) id 18pE2s-0005Fe-00 for emacs-devel@gnu.org; Sat, 01 Mar 2003 15:57:22 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.10.13) id 18pE2W-000504-00 for emacs-devel@gnu.org; Sat, 01 Mar 2003 15:57:01 -0500 Original-Received: from pool-68-160-54-133.bos.east.verizon.net ([68.160.54.133] helo=beth.swift.xxx) by monty-python.gnu.org with esmtp (Exim 4.10.13) id 18pE0g-0004Sb-00 for emacs-devel@gnu.org; Sat, 01 Mar 2003 15:55:07 -0500 Original-Received: from beth.swift.xxx (swift@localhost.swift.xxx [127.0.0.1]) h21KsupF024826verify=FAIL); Sat, 1 Mar 2003 15:54:56 -0500 Original-Received: (from swift@localhost) by beth.swift.xxx (8.12.7/8.12.7/Debian-2) id h21KsuPI024824; Sat, 1 Mar 2003 15:54:56 -0500 Original-To: "Stefan Monnier" In-Reply-To: <200303012038.h21KcGr24763@rum.cs.yale.edu> ("Stefan Monnier"'s message of "Sat, 01 Mar 2003 15:38:16 -0500") User-Agent: Gnus/5.090016 (Oort Gnus v0.16) Emacs/21.2 (i386-debian-linux-gnu) X-Mailscanner: clean (beth.swift.xxx) 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:12051 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:12051 >> "S" == Stefan wrote: S> I don't like this change because docstrings shouldn't be S> limted to 65 chars. The doc only says that they should S> fit within 80 columns. Only the first line should be shorter. Is this an objection to the variable or to the default value? If the default value were t instead of 65, default behavior of Emacs would not change. Users who do like the feature could enable it with customization. I agree the wording below is not a requirement, but it is a recommendation, and I was looking for a way to heed it while still filling code and comments to a more practical, wider length. >>From (elisp)Documentation Tips: * Format the documentation string so that it fits in an Emacs window on an 80-column screen. It is a good idea for most lines to be no ^^^^^^... wider than 60 characters. The first line should not be wider than 67 characters or it will look bad in the output of `apropos'.