GNU bug report logs - #52741
27.2; Doc string of `visual-line-mode'

Previous Next

Full log

Message #8 received at 52741 <at> debbugs.gnu.org (full text, mbox):

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 52741 <at> debbugs.gnu.org
Subject: Re: bug#52741: 27.2; Doc string of `visual-line-mode'
Date: Wed, 22 Dec 2021 23:45:54 +0100

Drew Adams <drew.adams <at> oracle.com> writes:

> This part of the doc isn't helpful:
>
>  If called interactively, enable Visual-Line mode if ARG is positive,
>  and disable it if ARG is zero or negative.
>
> What on earth is ARG, for interactive use?  The description of
> interactive use should talk about things like a prefix arg, not about
> unexplained things like ARG.  How will a user know how to pass argument
> ARG interactively?
>
> (Once again, minor-mode doc problems.  This seems to be a never-ending
> cleanup.)

I think you've reported this a couple of times before?  And it's fixed
in Emacs 28:

---
This is a minor mode.  If called interactively, toggle the
‘Visual-Line mode’ mode.  If the prefix argument is positive, enable
the mode, and if it is zero or negative, disable the mode.

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.
---

So I'm closing this bug report.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.