From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#7509: 24.0.50; doc for `comment-style' and `comment-styles' Date: Sun, 28 Nov 2010 14:49:30 -0800 Message-ID: References: <9166F5772B0D414D84ECE3808ECD3964@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1290986140 2090 80.91.229.12 (28 Nov 2010 23:15:40 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sun, 28 Nov 2010 23:15:40 +0000 (UTC) Cc: 7509@debbugs.gnu.org To: "'Stefan Monnier'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Nov 29 00:15:36 2010 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1PMqSs-00077x-5A for geb-bug-gnu-emacs@m.gmane.org; Mon, 29 Nov 2010 00:15:28 +0100 Original-Received: from localhost ([127.0.0.1]:42490 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PMqSr-0002dN-IN for geb-bug-gnu-emacs@m.gmane.org; Sun, 28 Nov 2010 18:15:25 -0500 Original-Received: from [140.186.70.92] (port=35322 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PMqSi-0002bm-Ub for bug-gnu-emacs@gnu.org; Sun, 28 Nov 2010 18:15:18 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PMqSh-0006cr-Gw for bug-gnu-emacs@gnu.org; Sun, 28 Nov 2010 18:15:16 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:35374) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PMqSh-0006cn-FA for bug-gnu-emacs@gnu.org; Sun, 28 Nov 2010 18:15:15 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1PMq1N-0001cy-TW; Sun, 28 Nov 2010 17:47:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 28 Nov 2010 22:47:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 7509 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 7509-submit@debbugs.gnu.org id=B7509.12909843676189 (code B ref 7509); Sun, 28 Nov 2010 22:47:01 +0000 Original-Received: (at 7509) by debbugs.gnu.org; 28 Nov 2010 22:46:07 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PMq0V-0001bm-2w for submit@debbugs.gnu.org; Sun, 28 Nov 2010 17:46:07 -0500 Original-Received: from rcsinet10.oracle.com ([148.87.113.121]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PMq0T-0001bJ-C8 for 7509@debbugs.gnu.org; Sun, 28 Nov 2010 17:46:05 -0500 Original-Received: from rcsinet13.oracle.com (rcsinet13.oracle.com [148.87.113.125]) by rcsinet10.oracle.com (Switch-3.4.2/Switch-3.4.2) with ESMTP id oASMpaNY012758 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sun, 28 Nov 2010 22:51:37 GMT Original-Received: from acsmt354.oracle.com (acsmt354.oracle.com [141.146.40.154]) by rcsinet13.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id oASL1sn1008914; Sun, 28 Nov 2010 22:51:35 GMT Original-Received: from abhmt021.oracle.com by acsmt354.oracle.com with ESMTP id 810554151290984579; Sun, 28 Nov 2010 14:49:39 -0800 Original-Received: from dradamslap1 (/10.159.220.140) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sun, 28 Nov 2010 14:49:39 -0800 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5994 Thread-Index: AcuPP2pXrRJLgVKnSyWiYj1n937sKQADD4owAAClX3A= X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Sun, 28 Nov 2010 17:47:01 -0500 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) 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: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:41993 Archived-At: > > I don't understand: the docstring of comment-styles (like all other > > variable docstrings) doesn't describe its current value, but > > rather what are its possible value(s) and what they mean. It > > seems to be just as up-to-date as when I originally wrote it > > The possible values seem to include `box' and `box-multi' (at > least I see those in the default alist value). Neither of those > is described in the doc string. I was mistaken. I was interpreting the alist values wrt the labels in the menu for `comment-style'. I guess that all that's missing are descriptions of the latter.