bug#81569: 31.0.90; easy-mmode.el: Zero seems inadvertently removed or omitted from documentation

Eli Zaretskii <[email protected]> Fri, 07 Aug 2026 08:02:14 +0300
Newsgroups gmane.emacs.bugs
Message-ID <[email protected]>
> From: Markus Triska <[email protected]>
> Date: Thu, 06 Aug 2026 20:21:34 +0200 (CEST)
> 
> 
> It seems 5cea77af41b59ba6f6386264812c36ec31ba2efc and
> 423a23ef7549ec425f26b537861c67e3ae78554c inadvertently removed or
> omitted the value zero (0) from the documentation, which is indicated
> elsewhere in the documentation as disabling the minor mode.

Stefan, wasn't that deliberate?

Who uses zero, anyway, and why?

> Maybe the following patch is applicable?
> 
> Thank you a lot!
> Markus
> 
> commit fe3ed370d3d457ded1c0f4e78b25cf9742d23efb
> Author: Markus Triska <[email protected]>
> Date:   Thu Aug 6 20:09:17 2026 +0200
> 
>     Zero also disables the mode.
>     
>     * lisp/emacs-lisp/easy-mmode.el
>     (easy-mmode--arg-docstring)
>     (define-globalized-minor-mode): Add zero.
> 
> diff --git a/lisp/emacs-lisp/easy-mmode.el b/lisp/emacs-lisp/easy-mmode.el
> index 51f0168d2fb..88160800cec 100644
> --- a/lisp/emacs-lisp/easy-mmode.el
> +++ b/lisp/emacs-lisp/easy-mmode.el
> @@ -88,7 +88,7 @@ easy-mmode--arg-docstring
>  
>  If called from Lisp, toggle the mode if ARG is `toggle'.
>  Enable the mode if ARG is nil, omitted, or is a positive number.
> -Disable the mode if ARG is a negative number.
> +Disable the mode if ARG is zero or a negative number.
>  
>  To check whether the minor mode is enabled in the current buffer,
>  evaluate %s.
> @@ -548,7 +548,7 @@ define-globalized-minor-mode
>                    "\n\n"
>                    "If called from Lisp, toggle the mode if ARG is `toggle'.
>  Enable the mode if ARG is nil, omitted, or is a positive number.
> -Disable the mode if ARG is a negative number.\n\n"
> +Disable the mode if ARG is zero or a negative number.\n\n"
>                    (internal--format-docstring-line
>                     "See `%s' for more information on %s."
>                     mode pretty-name)
> 
> 
> 
> In GNU Emacs 31.0.90 (build 2, x86_64-pc-linux-gnu, X toolkit, Xaw
>  scroll bars) of 2026-07-19 built on beelink-ser8
> Repository revision: 407de5142c2631d42d53c8da470188f61e46ab22
> Repository branch: HEAD
> Windowing system distributor 'The X.Org Foundation', version 11.0.12101016
> System Description: Debian GNU/Linux 13 (trixie)
> 
> Configured using:
>  'configure --without-cairo --with-x-toolkit=lucid
>  --with-xpm=ifavailable --with-gif=ifavailable --with-tiff=ifavailable
>  --with-gnutls=ifavailable --with-native-compilation=no'
> 
> Configured features:
> DBUS FREETYPE GIF GLIB GMP GNUTLS GSETTINGS HARFBUZZ JPEG LIBSYSTEMD
> LIBXML2 MODULES NOTIFY INOTIFY PDUMPER PNG RSVG SECCOMP SOUND THREADS
> TIFF TOOLKIT_SCROLL_BARS TREE_SITTER WEBP X11 XDBE XFT XIM XINERAMA
> XINPUT2 XPM XRANDR LUCID ZLIB
> 
> 
> 
>