From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Luc Teirlinck Newsgroups: gmane.emacs.devel Subject: Re: Docstring line length Date: Tue, 20 Dec 2005 18:59:57 -0600 (CST) Message-ID: <200512210059.jBL0xve13533@raven.dms.auburn.edu> References: NNTP-Posting-Host: main.gmane.org X-Trace: sea.gmane.org 1135126967 25785 80.91.229.2 (21 Dec 2005 01:02:47 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Wed, 21 Dec 2005 01:02:47 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Dec 21 02:02:44 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1EosMw-0007PY-12 for ged-emacs-devel@m.gmane.org; Wed, 21 Dec 2005 02:02:14 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EosNp-00089o-KL for ged-emacs-devel@m.gmane.org; Tue, 20 Dec 2005 20:03:10 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1EosNW-00089N-F1 for emacs-devel@gnu.org; Tue, 20 Dec 2005 20:02:50 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1EosNV-000892-Jv for emacs-devel@gnu.org; Tue, 20 Dec 2005 20:02:49 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EosNV-00088z-G4 for emacs-devel@gnu.org; Tue, 20 Dec 2005 20:02:49 -0500 Original-Received: from [131.204.53.104] (helo=manatee.dms.auburn.edu) by monty-python.gnu.org with esmtp (Exim 4.34) id 1EosQi-0002hQ-Im for emacs-devel@gnu.org; Tue, 20 Dec 2005 20:06:08 -0500 Original-Received: from raven.dms.auburn.edu (raven.dms.auburn.edu [131.204.53.29]) by manatee.dms.auburn.edu (8.13.3+Sun/8.13.3) with ESMTP id jBL11pbP002836; Tue, 20 Dec 2005 19:01:51 -0600 (CST) Original-Received: (from teirllm@localhost) by raven.dms.auburn.edu (8.11.7p1+Sun/8.11.7) id jBL0xve13533; Tue, 20 Dec 2005 18:59:57 -0600 (CST) X-Authentication-Warning: raven.dms.auburn.edu: teirllm set sender to teirllm@dms.auburn.edu using -f Original-To: drew.adams@oracle.com In-reply-to: X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-2.0.1 (manatee.dms.auburn.edu [131.204.53.104]); Tue, 20 Dec 2005 19:01:51 -0600 (CST) 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:48132 Archived-At: >>From my earlier message: 67 for the first line. That is a given. 68 already forces an ugly continuation line in the apropos output. To me 70 for most subsequent lines with an absolute limit of 79 seems better than the current 60. But I do not believe that this is a really big deal. I meant that whether the convention for "most" subsequent lines is no big deal ("most" is vague anyway). I believe that more than 79 for _any_ line is really bad and that such docstrings should definitely be fixed. I also believe that docstrings with a first line longer than 67 should be fixed. Sincerely, Luc.