Turn off checkdoc complaint about default argument order

* etc/NEWS: Mention change.
* lisp/emacs-lisp/checkdoc.el (checkdoc-arguments-in-order-flag):
Disable by default, note version.

diff --git a/etc/NEWS b/etc/NEWS
index d32b0e5bc89d609d8b5c0709898bca51e7fe8785..be95504cfd48c967fe5378fcd29ee78c58aa58d3 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -673,6 +673,11 @@ bound to 'Buffer-menu-unmark-all-buffers'.
 *** Two new commands 'Buffer-menu-unmark-all', bound to 'U' and
 'Buffer-menu-unmark-all-buffers', bound to 'M-DEL'.
 
+---
+** Checkdoc
+
+*** 'checkdoc-arguments-in-order-flag' now defaults to nil.
+
 ** Gnus
 
 ---

diff --git a/lisp/emacs-lisp/checkdoc.el b/lisp/emacs-lisp/checkdoc.el
index 1d6fdfa4e8790f323f9dc535e07635f1e26a379e..bc67a6be51a70c05f401eb9a6c40b75afc284267 100644 (file)
--- a/lisp/emacs-lisp/checkdoc.el
+++ b/lisp/emacs-lisp/checkdoc.el
@@ -258,12 +258,13 @@ Any more than this and a warning is generated suggesting that the construct
 \\ {keymap} be used instead."
   :type 'integer)
 
-(defcustom checkdoc-arguments-in-order-flag t
+(defcustom checkdoc-arguments-in-order-flag nil
   "Non-nil means warn if arguments appear out of order.
 Setting this to nil will mean only checking that all the arguments
 appear in the proper form in the documentation, not that they are in
 the same order as they appear in the argument list.  No mention is
 made in the style guide relating to order."
+  :version "26.1"
   :type 'boolean)
 ;;;###autoload(put 'checkdoc-arguments-in-order-flag 'safe-local-variable #'booleanp)