[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] emacs-25 71d23f9: Document 'comment-line'
From: |
Eli Zaretskii |
Subject: |
[Emacs-diffs] emacs-25 71d23f9: Document 'comment-line' |
Date: |
Sat, 28 Nov 2015 13:26:22 +0000 |
branch: emacs-25
commit 71d23f9503b2a632fc20299751bf0486131e15c9
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>
Document 'comment-line'
* doc/emacs/programs.texi (Comment Commands): Document
'comment-line'.
* etc/NEWS: Move the entry for 'comment-line' into "Editing Changes".
---
doc/emacs/programs.texi | 14 ++++++++++++++
etc/NEWS | 5 +++--
2 files changed, 17 insertions(+), 2 deletions(-)
diff --git a/doc/emacs/programs.texi b/doc/emacs/programs.texi
index 1f2c8b1..f9d9a27 100644
--- a/doc/emacs/programs.texi
+++ b/doc/emacs/programs.texi
@@ -917,6 +917,8 @@ will indent the comment to the appropriate position.
@item @kbd{M-;}
Insert or realign comment on current line; if the region is active,
comment or uncomment the region instead (@code{comment-dwim}).
address@hidden @kbd{C-x C-;}
+Comment or uncomment the current line (@code{comment-line}).
@item @kbd{C-u M-;}
Kill comment on current line (@code{comment-kill}).
@item @kbd{C-x ;}
@@ -971,6 +973,18 @@ are not moved. Even when an existing comment is properly
aligned,
@kbd{M-;} is still useful for moving directly to the start of the
comment text.
address@hidden comment-line
address@hidden C-x C-;
+ @kbd{C-x C-;} (@code{comment-line}) comments or uncomments complete
+lines. When a region is active (@pxref{Mark}), @kbd{C-x C-;} either
+comments or uncomments the lines in the region. If the region is not
+active, this command comments or uncomments the line point is on.
+With a positive prefix argument @var{n}, it operates on @var{n} lines
+starting with the current one; with a negative @var{n}, it affects
address@hidden preceding lines. After invoking this command with a negative
+argument, successive invocations with a positive argument will operate
+on preceding lines as if the argument were negated.
+
@findex comment-kill
@kindex C-u M-;
@kbd{C-u M-;} (@code{comment-dwim} with a prefix argument) kills any
diff --git a/etc/NEWS b/etc/NEWS
index 4e06e31..c783ec1 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -135,8 +135,6 @@ frames.
Works for functions, variables, faces, etc. It is bound to `C-h o' by
default.
-** New command `comment-line' bound to `C-x C-;'.
-
** New function `custom-prompt-customize-unsaved-options' checks for
unsaved customizations and prompts user to customize (if found).
@@ -318,6 +316,9 @@ at configure time.
** Successive single-char deletions are collapsed in the undo-log just like
successive char insertions.
++++
+** New command `comment-line' bound to `C-x C-;'.
+
** Unicode names entered via C-x 8 RET now use substring completion by default.
** C-x 8 now has shorthands for these chars: ‐ ‑ ‒ – — ― ‘ ’ “ ” † ‡ • ′ ″
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] emacs-25 71d23f9: Document 'comment-line',
Eli Zaretskii <=