From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Luc Teirlinck Newsgroups: gmane.emacs.devel Subject: Re: comment-multi-line docstring Date: Sun, 26 Sep 2004 17:47:31 -0500 (CDT) Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Message-ID: <200409262247.i8QMlVU29361@raven.dms.auburn.edu> References: <200409251828.i8PISNv18628@raven.dms.auburn.edu> NNTP-Posting-Host: deer.gmane.org X-Trace: sea.gmane.org 1096238901 5880 80.91.229.6 (26 Sep 2004 22:48:21 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sun, 26 Sep 2004 22:48:21 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Sep 27 00:48:11 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 1CBhoR-0001cU-00 for ; Mon, 27 Sep 2004 00:48:11 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CBhud-0005ek-Hy for ged-emacs-devel@m.gmane.org; Sun, 26 Sep 2004 18:54:35 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33) id 1CBhuT-0005eG-RU for emacs-devel@gnu.org; Sun, 26 Sep 2004 18:54:25 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33) id 1CBhuQ-0005do-9Z for emacs-devel@gnu.org; Sun, 26 Sep 2004 18:54:25 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CBhuQ-0005dl-6E for emacs-devel@gnu.org; Sun, 26 Sep 2004 18:54:22 -0400 Original-Received: from [131.204.53.104] (helo=manatee.dms.auburn.edu) by monty-python.gnu.org with esmtp (Exim 4.34) id 1CBhoC-0002t2-AZ for emacs-devel@gnu.org; Sun, 26 Sep 2004 18:47:56 -0400 Original-Received: from raven.dms.auburn.edu (raven.dms.auburn.edu [131.204.53.29]) by manatee.dms.auburn.edu (8.12.10/8.12.10) with ESMTP id i8QMltiU020900; Sun, 26 Sep 2004 17:47:55 -0500 (CDT) Original-Received: (from teirllm@localhost) by raven.dms.auburn.edu (8.11.7p1+Sun/8.11.7) id i8QMlVU29361; Sun, 26 Sep 2004 17:47:31 -0500 (CDT) X-Authentication-Warning: raven.dms.auburn.edu: teirllm set sender to teirllm@dms.auburn.edu using -f Original-To: monnier@iro.umontreal.ca In-reply-to: (message from Stefan on Sat, 25 Sep 2004 15:33:31 -0400) 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:27589 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:27589 Stefan Monnier wrote: 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. What about the following new docstring? Too bad that \\[...] does not recognize aliases. I had to use \\[indent-new-comment-line] to get C-M-j. \\[comment-indent-new-line] produced `M-x comment-indent-new-line'. ===File ~/newcomment-diff=================================== *** newcomment.el 07 Sep 2004 09:18:13 -0500 1.79 --- newcomment.el 26 Sep 2004 17:26:27 -0500 *************** *** 215,222 **** ;;;###autoload (defcustom comment-multi-line nil ! "*Non-nil means \\[comment-indent-new-line] continues comments, with no new terminator or starter. ! This is obsolete because you might as well use \\[newline-and-indent]." :type 'boolean) (defcustom comment-empty-lines nil --- 215,227 ---- ;;;###autoload (defcustom comment-multi-line nil ! "*Non-nil means `comment-indent-new-line' continues comments. ! That is, it inserts no new terminator or starter. ! This affects `auto-fill-mode', which is the main reason to ! customize this variable. ! ! It also affects \\[indent-new-comment-line]. However, if you want this ! behavior for explicit filling, you might as well use \\[newline-and-indent]." :type 'boolean) (defcustom comment-empty-lines nil ============================================================