From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Noam Postavsky Newsgroups: gmane.emacs.bugs Subject: bug#11636: 23.1; wrong comment indentation Date: Tue, 13 Feb 2018 22:14:14 -0500 Message-ID: <8760709sah.fsf@users.sourceforge.net> References: NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Trace: blaine.gmane.org 1518578017 22174 195.159.176.226 (14 Feb 2018 03:13:37 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Wed, 14 Feb 2018 03:13:37 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.0.90 (gnu/linux) Cc: 11636@debbugs.gnu.org, Stefan Monnier To: Jack Duthen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Feb 14 04:13:33 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1elnVO-00049T-Ix for geb-bug-gnu-emacs@m.gmane.org; Wed, 14 Feb 2018 04:13:10 +0100 Original-Received: from localhost ([::1]:55878 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1elnXQ-0003YF-Ep for geb-bug-gnu-emacs@m.gmane.org; Tue, 13 Feb 2018 22:15:16 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:58239) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1elnXF-0003Vi-6q for bug-gnu-emacs@gnu.org; Tue, 13 Feb 2018 22:15:06 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1elnXC-0004el-0K for bug-gnu-emacs@gnu.org; Tue, 13 Feb 2018 22:15:05 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:34123) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1elnXB-0004eY-Qp for bug-gnu-emacs@gnu.org; Tue, 13 Feb 2018 22:15:01 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1elnXB-0003g0-Ja for bug-gnu-emacs@gnu.org; Tue, 13 Feb 2018 22:15:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Noam Postavsky Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 14 Feb 2018 03:15:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 11636 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 11636-submit@debbugs.gnu.org id=B11636.151857806514078 (code B ref 11636); Wed, 14 Feb 2018 03:15:01 +0000 Original-Received: (at 11636) by debbugs.gnu.org; 14 Feb 2018 03:14:25 +0000 Original-Received: from localhost ([127.0.0.1]:42020 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1elnWb-0003ev-AD for submit@debbugs.gnu.org; Tue, 13 Feb 2018 22:14:25 -0500 Original-Received: from mail-it0-f44.google.com ([209.85.214.44]:33816) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1elnWZ-0003ec-DR; Tue, 13 Feb 2018 22:14:23 -0500 Original-Received: by mail-it0-f44.google.com with SMTP id j21so11521025ita.1; Tue, 13 Feb 2018 19:14:23 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=CfhULFRp8CjTSMxcIqSRQ9JlRO+asFAYYkl+8SENr0k=; b=rc7pXKvGqh7UrigO2P21z/zHaXQQMAFebnvOz8YBJxVXabuJrBBZPNq87k8FcYK7z6 +z5kP3VqC9FKStVhlYN7mMh649iHR8QQisSCnJ/U+keTs4HmeXPRXnMQln1uVaSXUUfZ YLgu6TQ6BPcwVJHo4AA+hl4bcLJTHR0W5ZO/mSZt16/7bGaJGFCYuJmkdI2lUxa5rnUf LjauJw6KDkxLf/z1p+yzAE+CbyNMfQVOn2s2nidxPT2AuLL35C5Lx5IqHodJ4h6bRypE yW12tr/ECp3zsCfX802igVZr7X6LJVylLOVBT0VHRhz8b8fuC//c6SW44180odz8Zfiz 525w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:from:to:cc:subject:references:date :in-reply-to:message-id:user-agent:mime-version; bh=CfhULFRp8CjTSMxcIqSRQ9JlRO+asFAYYkl+8SENr0k=; b=CXjfSZR7h+kMX9gqHE0enHcN7aY1kqanEi/DeL0EsVtLme6apcJEkQygbTg5bprDYy BnoY54LGAmAK2R/cWRaHjn2d/i8u84m2RIYmuhnmwZP6TkfYz5XV4DayoLbMBKfGzOJh xL0d+QDVxdgQv8REk3HfW24SGLWV1pK90anJQ3U9cVm5hUuIQ+2jRIOjbI1UhuCyAkZv O5qNOpHIVYC732neIILTI/nH+QLflTlUHAuPpQFUuO1uL3V909QfANxA1KHQiaBlQn2E XUtEsmg2HYiFfAlR9IIDoytdrpXLXNSaglxI3O3ABXV6Q7IG7xWBO8YA0fj5JFF/bHCp TJIg== X-Gm-Message-State: APf1xPBpVuc/iKSe2+kTrjGqJIaqDcA1uYNWTTH0B7uQVdZ/rWUe/RAC xYtiQUxKai/qVVqzdh07lfvu/g== X-Google-Smtp-Source: AH8x225Rd/qpqqLUmZTQO0jNyaSqu9RNOCPMUiVDnRYNPKybcyahqL9gc5JpTfc7iwx5wMD0iGKhBw== X-Received: by 10.36.120.80 with SMTP id p77mr4122361itc.115.1518578057786; Tue, 13 Feb 2018 19:14:17 -0800 (PST) Original-Received: from zebian (cbl-45-2-119-34.yyz.frontiernetworks.ca. [45.2.119.34]) by smtp.googlemail.com with ESMTPSA id f16sm15084974iob.75.2018.02.13.19.14.15 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Tue, 13 Feb 2018 19:14:16 -0800 (PST) In-Reply-To: (Jack Duthen's message of "Thu, 7 Jun 2012 11:10:02 +0200") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.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" Xref: news.gmane.org gmane.emacs.bugs:143264 Archived-At: --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable tags 11636 + patch quit Jack Duthen writes: > Also if you lookup-subject-in-emacs-manual or -in-elisp-manual > with comment-fill-column, you will find no reference to it. > > Maybe there should be a word about it in =C2=A730.5.1 or =C2=A730.5.3 ? How about this: --=-=-= Content-Type: text/x-diff Content-Disposition: inline; filename=v1-0001-Document-comment-fill-column-in-the-manual-Bug-11.patch Content-Description: patch >From 8f455ca6dfe5361783bf3e897527816f558dd9c9 Mon Sep 17 00:00:00 2001 From: Noam Postavsky Date: Tue, 13 Feb 2018 22:10:03 -0500 Subject: [PATCH v1] Document comment-fill-column in the manual (Bug#11636) * doc/emacs/programs.texi (Comment Commands) (Options for Comments): Mention comment-fill-column. --- doc/emacs/programs.texi | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/doc/emacs/programs.texi b/doc/emacs/programs.texi index 4289124545..6c650a4ccf 100644 --- a/doc/emacs/programs.texi +++ b/doc/emacs/programs.texi @@ -989,7 +989,8 @@ Comment Commands @key{TAB} would indent to (@pxref{Basic Indent}). If the line is non-blank, the comment is placed after the last non-whitespace character on the line; normally, Emacs tries putting it at the column -specified by the variable @code{comment-column} (@pxref{Options for +specified by the variable @code{comment-column} while keeping the end +of the comment within @code{comment-fill-column} (@pxref{Options for Comments}), but if the line already extends past that column, it puts the comment at some suitable position, usually separated from the non-comment text by at least one space. In each case, Emacs places @@ -1088,13 +1089,17 @@ Options for Comments @subsection Options Controlling Comments @vindex comment-column +@vindex comment-fill-column @kindex C-x ; @findex comment-set-column As mentioned in @ref{Comment Commands}, when the @kbd{M-j} command -adds a comment to a line, it tries to place the comment at the column -specified by the buffer-local variable @code{comment-column}. You can -set either the local value or the default value of this buffer-local -variable in the usual way (@pxref{Locals}). Alternatively, you can +adds a comment to a line, it tries to place the comment starting at +the column specified by the buffer-local variable +@code{comment-column} and ending before @code{comment-fill-column} (or +if that is @code{nil}, then the value of @code{fill-column}, +@pxref{Fill Commands}). You can set either the local value or the +default value of these buffer-local variables in the usual way +(@pxref{Locals}). Alternatively, you can type @kbd{C-x ;} (@code{comment-set-column}) to set the value of @code{comment-column} in the current buffer to the column where point is currently located. @kbd{C-u C-x ;} sets the comment column to -- 2.11.0 --=-=-=--