GNU bug report logs -
#35163
25.1; `narrow-to-region' docstring no mention of args
Previous Next
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: 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.