GNU bug report logs - #35163
25.1; `narrow-to-region' docstring no mention of args

Previous Next

Package: emacs;

Reported by: Emanuel Berg <moasenwood <at> zoho.eu>

Date: Fri, 5 Apr 2019 18:54:02 UTC

Severity: wishlist

Found in version 25.1

Done: Eli Zaretskii <eliz <at> gnu.org>

Bug is archived. No further changes may be made.

Full log


View this message in rfc822 format

From: Eli Zaretskii <eliz <at> gnu.org>
To: Emanuel Berg <moasenwood <at> zoho.eu>
Cc: 35163 <at> debbugs.gnu.org
Subject: bug#35163: 25.1; `narrow-to-region' docstring no mention of args
Date: Sat, 06 Apr 2019 12:01:06 +0300
> From: Emanuel Berg <moasenwood <at> zoho.eu>
> Cc: 35163 <at> debbugs.gnu.org
> Date: Sat, 06 Apr 2019 09:10:04 +0200
> 
> Eli Zaretskii wrote:
> 
> >> The words START and END do not appear, in
> >> that order, in the docstring. Actually, they
> >> don't appear at all. That means they are
> >> not searchable.
> >
> > This is a command, first and foremost.
> > The primary goal of its doc string is to tell
> > users (not Lisp programmers) how to use the
> > command and what it does. In interactive
> > usage, START and END come from the region and
> > are not under user control explicitly.
> >
> > So I don't think there's anything wrong with
> > this doc string.
> 
> ;;; docstring-experiment.el --- illustrate docstring deficiency

Please don't ask me to run arbitrary code I receive from the
Internet.  I'd appreciate a direct response to what I wrote above.

Thanks.




This bug report was last modified 6 years and 101 days ago.

Previous Next


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