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: Wed, 14 Feb 2018 20:36:50 -0500 Message-ID: <87fu63824t.fsf@gmail.com> References: <8760709sah.fsf@users.sourceforge.net> <83d118xjrh.fsf@gnu.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Trace: blaine.gmane.org 1518658520 27346 195.159.176.226 (15 Feb 2018 01:35:20 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Thu, 15 Feb 2018 01:35:20 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.0.90 (gnu/linux) Cc: 11636@debbugs.gnu.org, monnier@iro.umontreal.ca, duthen.mac.01@gmail.com To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Feb 15 02:35:16 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 1em8S7-0006XR-DW for geb-bug-gnu-emacs@m.gmane.org; Thu, 15 Feb 2018 02:35:11 +0100 Original-Received: from localhost ([::1]:52954 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1em8U9-00043w-A5 for geb-bug-gnu-emacs@m.gmane.org; Wed, 14 Feb 2018 20:37:17 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:56406) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1em8Tx-00043Q-VW for bug-gnu-emacs@gnu.org; Wed, 14 Feb 2018 20:37:09 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1em8Tu-0008Ay-Qd for bug-gnu-emacs@gnu.org; Wed, 14 Feb 2018 20:37:06 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:35586) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1em8Tu-0008Au-Mw for bug-gnu-emacs@gnu.org; Wed, 14 Feb 2018 20:37:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1em8Tu-0008GZ-H8 for bug-gnu-emacs@gnu.org; Wed, 14 Feb 2018 20:37:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Noam Postavsky Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 15 Feb 2018 01:37:02 +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: patch Original-Received: via spool by 11636-submit@debbugs.gnu.org id=B11636.151865862031767 (code B ref 11636); Thu, 15 Feb 2018 01:37:02 +0000 Original-Received: (at 11636) by debbugs.gnu.org; 15 Feb 2018 01:37:00 +0000 Original-Received: from localhost ([127.0.0.1]:43483 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1em8Ts-0008GJ-HR for submit@debbugs.gnu.org; Wed, 14 Feb 2018 20:37:00 -0500 Original-Received: from mail-it0-f42.google.com ([209.85.214.42]:36966) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1em8Tr-0008G6-Gn for 11636@debbugs.gnu.org; Wed, 14 Feb 2018 20:36:59 -0500 Original-Received: by mail-it0-f42.google.com with SMTP id d10so11258502itj.2 for <11636@debbugs.gnu.org>; Wed, 14 Feb 2018 17:36:59 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=Xoc77mqUHaCgsobUxpBKg3U1Lodsu11mQzzoq7cMgjU=; b=QxEt3R24TAwQUtfIvPzFE1/RUPrJkfh13Tiw17lsElhqhu7aYnuQBgniHrBXfc5gM7 uSZk9PDdAthcOy/kbXCnvMZvn2wJXbVxjN5f8i4iJNoPB2OMdwFjIHILmUL1gWBwKlBM G8ghSm73exBSmhTaydRFF3z3ZPqq4cNzjeFRDgv2QLo/4FvHe9kdoLubrj4v1GvU4Ckw CZNOf3Qv1kkYlBBrL8iNhAggLt+f3RGkHuXRvaGDQ3yiUErFWPT6niuxWxwPFVtIn9ES IJu2b6PkTGBpp3jVuB+P8cQlxtcW+TmKwwKS+FVXGEUDIY86Jbal5yx2LcZCdFqisNOE /huw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version; bh=Xoc77mqUHaCgsobUxpBKg3U1Lodsu11mQzzoq7cMgjU=; b=V100V9+7PY3Atfx7ib+hv2ADVYsZhs/+4/uHOlUiFS80zlqrnCMkDw1sdnxKf6Pyi8 x08NKZBfsLJ9KWtCtITZDZdLqjWXPSMjJwDuLG1HyeySL99vmPGqOGgzjRMWtePcyTgK /lfs+iXflUOz8E78zX/jIguCPhb1OhbkPegVHvSk73A7LwkRMAGJxlETXac2t6e4/o4D t5CDkEdoVdNbb2uXsJ11hEXMRMcqDccObX2Rh2AmdcToZqjy0liiQL6TtzxOYFhiRLwP F7zUeH8t2rLE1432WY91Qjvdx16ojTaxY5oOQ92jeYgTolN1Y6tOdjqQWO15AvmCD6QS 0rBA== X-Gm-Message-State: APf1xPDGmWo4eKFGQKrYcy/za7tBGpEYwcc8OTQKFhjuZ3Er8EspolMe JrZwW3jweSpA3doZ+J3X0tU= X-Google-Smtp-Source: AH8x225PHuDp9aV1y/HGCYCaBD0KOwqD5jSqs7CQDPy9i7gXzfOTmHUJwCva0ciy2s0gyBZh3DTkAw== X-Received: by 10.36.203.70 with SMTP id u67mr1325226itg.48.1518658613908; Wed, 14 Feb 2018 17:36:53 -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 x82sm14261009itb.36.2018.02.14.17.36.51 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Wed, 14 Feb 2018 17:36:52 -0800 (PST) In-Reply-To: <83d118xjrh.fsf@gnu.org> (Eli Zaretskii's message of "Wed, 14 Feb 2018 06:44:34 +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:143297 Archived-At: --=-=-= Content-Type: text/plain Eli Zaretskii writes: > Sounds good, but could you please break those two longish sentences > into 2, so that the text reads more easily? Is this better? --=-=-= Content-Type: text/x-diff Content-Disposition: inline; filename=v2-0001-Document-comment-fill-column-in-the-manual-Bug-11.patch Content-Description: patch >From cc0349f11f9e45afcad696aed35d80dd3d3e5f70 Mon Sep 17 00:00:00 2001 From: Noam Postavsky Date: Tue, 13 Feb 2018 22:10:03 -0500 Subject: [PATCH v2] 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 | 25 ++++++++++++++----------- 1 file changed, 14 insertions(+), 11 deletions(-) diff --git a/doc/emacs/programs.texi b/doc/emacs/programs.texi index 4289124545..7d54a99c09 100644 --- a/doc/emacs/programs.texi +++ b/doc/emacs/programs.texi @@ -988,13 +988,13 @@ Comment Commands characters), the comment is indented to the same position where @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 -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 -point after the comment's starting delimiter, so that you can start -typing the comment text right away. +character on the line. Emacs tries to fit the comment between the +columns specified by the variables @code{comment-column} and +@code{comment-fill-column} (@pxref{Options for Comments}), if +possible. Otherwise, it will choose some other suitable position, +usually separated from the non-comment text by at least one space. In +each case, Emacs places point after the comment's starting delimiter, +so that you can start typing the comment text right away. You can also use @kbd{M-;} to align an existing comment. If a line already contains the comment-start string, @kbd{M-;} realigns it to @@ -1088,13 +1088,16 @@ 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 between the +columns specified by the buffer-local variables @code{comment-column} +and @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 --=-=-=--