Subject: Re: bug#35163: 25.1; `narrow-to-region' docstring no mention of args

From: Emanuel Berg <[email-masked]>
Date: Fri, 05 Apr 2019 21:26:55 +0200

Eli Zaretskii wrote:

>> From: Emanuel Berg <[email-masked]>
>> Date: Fri, 05 Apr 2019 20:51:37 +0200
>> 
>> 25.1; `narrow-to-region' docstring no
>> mention of args
>> 
>> The `narrow-to-region' docstring does not
>> mention its arguments as is the norm.
>
> It does:
>
> When calling from a program, pass two
> arguments; positions (integers or markers)
> bounding the text that should remain visible.

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.

(checkdoc-current-buffer t) would tell you this
if you run it in an Elisp pack. If you run it
in a C file, I don't know what will happen, but
the principle is still a good idea both from
a principal and a practical standpoint.

-- 
underground experts united
http://user.it.uu.se/~embe8573