Subject: bug#33168: closed (Re: bug#33168: 26; Doc string of `region-bounds')

From: [email-masked] (GNU bug Tracking System)
Date: Sat, 27 Oct 2018 10:53:02 +0000

Your bug report

#33168: 26; Doc string of `region-bounds'

which was filed against the emacs package, has been closed.

The explanation is attached below, along with your original report.
If you require more details, please reply to [email-masked].

-- 
33168: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=33168
GNU Bug Tracking System
Contact [email-masked] with problems

Subject: Re: bug#33168: 26; Doc string of `region-bounds'
From: Eli Zaretskii <[email-masked]>
To: Drew Adams <[email-masked]>
Cc: [email-masked]
Date: Sat, 27 Oct 2018 13:52:41 +0300
List-Id: <debbugs-submit.debbugs.gnu.org>

> Date: Fri, 26 Oct 2018 08:48:17 -0700 (PDT)
> From: Drew Adams <[email-masked]>
> 
> Doc string:
> 
>   Return the boundaries of the region as a pair of positions.
>   Value is a list of cons cells of the form (START . END).
> 
> Those two sentences are incompatible.

Right; fixed.

> Further, assuming that the second sentence is correct, something needs
> to be said about what it means to be a boundary of the region.

I said "something" about that.

> Presumably, in the case of a contiguous region the return value is
> ((BEG . END)), where BEG is the start of the region and END is the END.
> But what if the region is noncontiguous?  Something should be said
> about what each (BEG<N> . END<N>) pair corresponds to (means).

And about this.

Thanks.

Subject: 26; Doc string of `region-bounds'
From: Drew Adams <[email-masked]>
To: [email-masked]
Date: Fri, 26 Oct 2018 08:48:17 -0700 (PDT)
List-Id: <debbugs-submit.debbugs.gnu.org>

Doc string:

  Return the boundaries of the region as a pair of positions.
  Value is a list of cons cells of the form (START . END).

Those two sentences are incompatible.

The first says that it returns a _single pair_ of positions: (START END)
or (START . END).  (It doesn't say what it means by "pair".  If it means
a cons then it should say so.)

The second says that it returns a _list of such pairs_, that is, a list
of conses of the form (START . END), where START and END are buffer
positions.

Further, assuming that the second sentence is correct, something needs
to be said about what it means to be a boundary of the region.
Presumably, in the case of a contiguous region the return value is
((BEG . END)), where BEG is the start of the region and END is the END.
But what if the region is noncontiguous?  Something should be said
about what each (BEG<N> . END<N>) pair corresponds to (means).

In GNU Emacs 26.1 (build 1, x86_64-w64-mingw32)
 of 2018-05-30
Repository revision: 07f8f9bc5a51f5aa94eb099f3e15fbe0c20ea1ea
Windowing system distributor `Microsoft Corp.', version 10.0.16299
Configured using:
 `configure --without-dbus --host=x86_64-w64-mingw32
 --without-compress-install 'CFLAGS=-O2 -static -g3''