From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Stefan Newsgroups: gmane.emacs.devel Subject: Re: comment-multi-line docstring Date: Sat, 25 Sep 2004 15:33:31 -0400 Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Message-ID: References: <200409251828.i8PISNv18628@raven.dms.auburn.edu> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1096140859 9737 80.91.229.6 (25 Sep 2004 19:34:19 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 25 Sep 2004 19:34:19 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Sep 25 21:34:06 2004 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1CBIJ3-0002Dq-00 for ; Sat, 25 Sep 2004 21:34:06 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CBIPC-000181-PD for ged-emacs-devel@m.gmane.org; Sat, 25 Sep 2004 15:40:26 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33) id 1CBIOw-00016X-RN for emacs-devel@gnu.org; Sat, 25 Sep 2004 15:40:11 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33) id 1CBIOu-000162-Qc for emacs-devel@gnu.org; Sat, 25 Sep 2004 15:40:10 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CBIOu-00015s-Mp for emacs-devel@gnu.org; Sat, 25 Sep 2004 15:40:08 -0400 Original-Received: from [206.47.199.165] (helo=simmts7-srv.bellnexxia.net) by monty-python.gnu.org with esmtp (Exim 4.34) id 1CBIIW-0003t2-0G for emacs-devel@gnu.org; Sat, 25 Sep 2004 15:33:32 -0400 Original-Received: from empanada.home ([67.71.24.92]) by simmts7-srv.bellnexxia.net (InterMail vM.5.01.06.10 201-253-122-130-110-20040306) with ESMTP id <20040925193102.YATC1960.simmts7-srv.bellnexxia.net@empanada.home>; Sat, 25 Sep 2004 15:31:02 -0400 Original-Received: by empanada.home (Postfix, from userid 502) id 9C33A306265; Sat, 25 Sep 2004 15:33:32 -0400 (EDT) Original-To: Luc Teirlinck In-Reply-To: <200409251828.i8PISNv18628@raven.dms.auburn.edu> (Luc Teirlinck's message of "Sat, 25 Sep 2004 13:28:23 -0500 (CDT)") User-Agent: Gnus/5.1006 (Gnus v5.10.6) Emacs/21.3.50 (darwin) 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: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:27569 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:27569 > From C-h v comment-multi-line: > *Non-nil means M-x comment-indent-new-line continues comments, with no > new terminator or starter. > This is obsolete because you might as well use C-j. > Is that "This is obsolete" really accurate? I think it isn't. IIRC, when I wrote newcomment.el I was pretty concerned about backward compatibility (I wanted to make sure that the package was going to be accepted as a *replacement* for the old commenting code, rather than like cperl-mode and ibuffer), so I preserved everything as much as I could. This variable was one I didn't understand at the time, so I just did my best to preserve the behavior (without actually knowing it, so it was basically preserving the code) and touched it as little as possible. I've since learned a bit more about this variable (mostly thanks to bug reports from Martin Stjernholm) which seems to be actually used by default in CC-mode and which I've since also used in sgml-mode. So I think the docstring should be rewritten to remove the `obsolete' part and to better explain what it does. AFAIk, what it does it change auto-fill-mode so that it doesn't add a "end+start" pair of comment markers when breaking a line. Stefan