Subject: bug#25428: 25.1; Incorrect doc string for `delete-selection-mode'

From: [email-masked]
Date: Wed, 16 Aug 2017 22:24:15 -0400

[email-masked] (N. Jackson) writes:

> [Temporary minor rant: Personally it seems absurd to me that a
> `nil' argument doesn't turn a minor mode off; and that calling the
> minor mode function with no argument doesn't toggle it. But that
> is all history of course.]

There is a good reason to have it like that: it allows doing

    (add-hook 'some-hook #'the-minor-mode)

Rather than having to do

    (add-hook 'some-hook (lambda () (the-minor-mode +1)))

or

    (defun turn-on-the-minor-mode () (the-minor-mode +1))
    (add-hook 'some-hook #'turn-on-the-minor-mode)