From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Lawrence Mitchell Newsgroups: gmane.emacs.bugs Subject: bug#10868: 24.0.93; `comment-style' needs to be explained Date: Thu, 23 Feb 2012 09:22:24 +0000 Message-ID: <87ehtlykdr.fsf@gmx.li> References: <7AF76478FD534B8B9A07E9FB79060E64@us.oracle.com> <5b4nuizqj9.fsf@fencepost.gnu.org> <3251750A293C4D74AAB64FD8672192CE@us.oracle.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: dough.gmane.org 1329989027 1631 80.91.229.3 (23 Feb 2012 09:23:47 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Thu, 23 Feb 2012 09:23:47 +0000 (UTC) To: 10868@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Feb 23 10:23:46 2012 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1S0Utu-0001gj-6w for geb-bug-gnu-emacs@m.gmane.org; Thu, 23 Feb 2012 10:23:46 +0100 Original-Received: from localhost ([::1]:55665 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1S0Utt-00011K-N8 for geb-bug-gnu-emacs@m.gmane.org; Thu, 23 Feb 2012 04:23:45 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]:33451) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1S0Utq-0000zF-8z for bug-gnu-emacs@gnu.org; Thu, 23 Feb 2012 04:23:43 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1S0Utk-00022B-1l for bug-gnu-emacs@gnu.org; Thu, 23 Feb 2012 04:23:41 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:48364) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1S0Utj-00021w-Nu for bug-gnu-emacs@gnu.org; Thu, 23 Feb 2012 04:23:35 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1S0Uw6-0004jC-4t for bug-gnu-emacs@gnu.org; Thu, 23 Feb 2012 04:26:02 -0500 X-Loop: help-debbugs@gnu.org In-Reply-To: Resent-From: Lawrence Mitchell Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 23 Feb 2012 09:26:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 10868 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: moreinfo X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.132998913418134 (code B ref -1); Thu, 23 Feb 2012 09:26:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 23 Feb 2012 09:25:34 +0000 Original-Received: from localhost ([127.0.0.1]:51987 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1S0Uvd-0004iQ-GJ for submit@debbugs.gnu.org; Thu, 23 Feb 2012 04:25:34 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]:59371) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1S0Uva-0004i9-D5 for submit@debbugs.gnu.org; Thu, 23 Feb 2012 04:25:32 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1S0Ut1-0001tb-VM for submit@debbugs.gnu.org; Thu, 23 Feb 2012 04:22:57 -0500 Original-Received: from lists.gnu.org ([140.186.70.17]:46133) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1S0Ut1-0001tW-Mr for submit@debbugs.gnu.org; Thu, 23 Feb 2012 04:22:51 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]:33197) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1S0Usx-0007Fm-OB for bug-gnu-emacs@gnu.org; Thu, 23 Feb 2012 04:22:51 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1S0Usr-0001qo-EX for bug-gnu-emacs@gnu.org; Thu, 23 Feb 2012 04:22:47 -0500 Original-Received: from plane.gmane.org ([80.91.229.3]:49361) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1S0Usr-0001qK-9R for bug-gnu-emacs@gnu.org; Thu, 23 Feb 2012 04:22:41 -0500 Original-Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1S0Usm-0000pV-J2 for bug-gnu-emacs@gnu.org; Thu, 23 Feb 2012 10:22:36 +0100 Original-Received: from e4300lm.epcc.ed.ac.uk ([129.215.63.156]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Thu, 23 Feb 2012 10:22:36 +0100 Original-Received: from wence by e4300lm.epcc.ed.ac.uk with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Thu, 23 Feb 2012 10:22:36 +0100 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 54 Original-X-Complaints-To: usenet@dough.gmane.org X-Gmane-NNTP-Posting-Host: e4300lm.epcc.ed.ac.uk User-Agent: Gnus/5.130004 (Ma Gnus v0.4) Emacs/24.0.93 (gnu/linux) Cancel-Lock: sha1:yR8Qmujt1PyX4ccTRvPAJBaJdnE= X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:57133 Archived-At: Drew Adams wrote: >>> Read the bug #3370 thread, if you want to understand the problem. >> Unfortunately, I did. It is long-winded and goes nowhere. >> I encourage everyone else not to bother. > Is it really so hard to understand? > "the doc string for `comment-style' (which is pretty much > useless) refers to `comment-styles', which is not > recognized (and therefore has no link)." > emacs -Q > C-h v comment-style > Style to be used for `comment-region'. > See `comment-styles' for a list of available styles. > C-h v comment-styles > Bzzzzt -not recognized - no such variable, no such "list of available styles" > ... until you load newcomment.el. [...] OK, here's the problem, and here's a patch. 2012-02-23 Lawrence Mitchell * lisp/newcomment.el: Autoload comment-styles (Bug#3370). The docstring of comment-style refers the user to comment-styles for details on what the values mean. However, this is not available until after newcomment.el is loaded. So autoload comment-styles to avoid this problem. --- lisp/newcomment.el | 1 + 1 files changed, 1 insertions(+), 0 deletions(-) diff --git a/lisp/newcomment.el b/lisp/newcomment.el index 16282af..cd887cb 100644 --- a/lisp/newcomment.el +++ b/lisp/newcomment.el @@ -185,6 +185,7 @@ The `plain' comment style doubles this value. This should generally stay 0, except for a few modes like Lisp where it is 1 so that regions are commented with two or three semi-colons.") +;;;###autoload (defconst comment-styles '((plain nil nil nil nil "Start in column 0 (do not indent), as in Emacs-20") -- 1.7.9.rc0.23.g7e521