# HG changeset patch # User Stefan Monnier # Date 1138982276 0 # Node ID ca4201c7597dbaa71f38573daf18f638ac028212 # Parent 8e80e7413fc22398fed5e371f4c7bc5d32609a59 Docstring fixes. diff -r 8e80e7413fc2 -r ca4201c7597d lisp/newcomment.el --- a/lisp/newcomment.el Fri Feb 03 13:14:43 2006 +0000 +++ b/lisp/newcomment.el Fri Feb 03 15:57:56 2006 +0000 @@ -1,7 +1,7 @@ ;;; newcomment.el --- (un)comment regions of buffers ;; Copyright (C) 1999, 2000, 2002, 2003, 2004, -;; 2005 Free Software Foundation, Inc. +;; 2005, 2006 Free Software Foundation, Inc. ;; Author: code extracted from Emacs-20's simple.el ;; Maintainer: Stefan Monnier @@ -96,7 +96,7 @@ ;;;###autoload (defcustom comment-column 32 - "*Column to indent right-margin comments to. + "Column to indent right-margin comments to. Each mode establishes a different default value for this variable; you can set the value for a particular mode using that mode's hook. Comments might be indented to a value smaller than this in order @@ -200,7 +200,7 @@ ;;;###autoload (defcustom comment-style 'plain - "*Style to be used for `comment-region'. + "Style to be used for `comment-region'. See `comment-styles' for a list of available styles." :type (if (boundp 'comment-styles) `(choice ,@(mapcar (lambda (s) `(const ,(car s))) comment-styles)) @@ -220,7 +220,7 @@ ;;;###autoload (defcustom comment-multi-line nil - "*Non-nil means `comment-indent-new-line' continues comments. + "Non-nil means `comment-indent-new-line' continues comments. That is, it inserts no new terminator or starter. This affects `auto-fill-mode', which is the main reason to customize this variable. @@ -1081,7 +1081,8 @@ case it calls `uncomment-region'). Else, if the current line is empty, insert a comment and indent it. Else if a prefix ARG is specified, call `comment-kill'. -Else, call `comment-indent'." +Else, call `comment-indent'. +You can configure `comment-style' to change the way regions are commented." (interactive "*P") (comment-normalize-vars) (if (and mark-active transient-mark-mode)