From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stephen Berman Newsgroups: gmane.emacs.devel Subject: comment-add Date: Tue, 25 Sep 2007 00:55:56 +0200 Message-ID: <87ir5zwu4j.fsf@escher.local.home> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1190674634 11166 80.91.229.12 (24 Sep 2007 22:57:14 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Mon, 24 Sep 2007 22:57:14 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Sep 25 00:57:08 2007 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 1IZwrK-0001kV-CJ for ged-emacs-devel@m.gmane.org; Tue, 25 Sep 2007 00:56:58 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1IZwrH-0004bb-8s for ged-emacs-devel@m.gmane.org; Mon, 24 Sep 2007 18:56:55 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1IZwrD-0004al-4v for emacs-devel@gnu.org; Mon, 24 Sep 2007 18:56:51 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1IZwrB-0004a9-F2 for emacs-devel@gnu.org; Mon, 24 Sep 2007 18:56:50 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1IZwrB-0004a1-9a for emacs-devel@gnu.org; Mon, 24 Sep 2007 18:56:49 -0400 Original-Received: from main.gmane.org ([80.91.229.2] helo=ciao.gmane.org) by monty-python.gnu.org with esmtps (TLS-1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1IZwrB-0003S4-0f for emacs-devel@gnu.org; Mon, 24 Sep 2007 18:56:49 -0400 Original-Received: from list by ciao.gmane.org with local (Exim 4.43) id 1IZwqq-00050M-V6 for emacs-devel@gnu.org; Mon, 24 Sep 2007 22:56:28 +0000 Original-Received: from i577bfcdc.versanet.de ([87.123.252.220]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Mon, 24 Sep 2007 22:56:28 +0000 Original-Received: from Stephen.Berman by i577bfcdc.versanet.de with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Mon, 24 Sep 2007 22:56:28 +0000 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 26 Original-X-Complaints-To: usenet@sea.gmane.org X-Gmane-NNTP-Posting-Host: i577bfcdc.versanet.de User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/23.0.50 (gnu/linux) X-Detected-Kernel: Linux 2.6, seldom 2.4 (older, 4) 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:79767 Archived-At: Since this change: 2007-09-17 Richard Stallman * newcomment.el (comment-add): New arg EXTRA. (comment-region-default): Pass EXTRA if not indenting lines. the docstring of the variable comment-add: How many more comment chars should be inserted by `comment-region'. This determines the default value of the numeric argument of `comment-region'. This should generally stay 0, except for a few modes like Lisp where it can be convenient to set it to 1 so that regions are commented with two semi-colons. doesn't reflect the default behavior in Lisp mode, which is now to comment regions with three semi-colons, given the default comment-style 'plain. If the default comment-style were changed to 'indent, then the doctring would (once again) be accurate. If the default comment-style is kept 'plain, the change in behavior should be mentioned in NEWS. In case anyone's tallying votes on this, I am in favor of making the default comment-style 'indent. Steve Berman