GNU bug report logs - #33168
26; Doc string of `region-bounds'

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#33168: closed (26; Doc string of `region-bounds')
Date: Sat, 27 Oct 2018 10:53:01 +0000

[Message part 1 (text/plain, inline)]

Your message dated Sat, 27 Oct 2018 13:52:41 +0300
with message-id <8336sroe4m.fsf <at> gnu.org>
and subject line Re: bug#33168: 26; Doc string of `region-bounds'
has caused the debbugs.gnu.org bug report #33168,
regarding 26; Doc string of `region-bounds'
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)


-- 
33168: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=33168
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 26; Doc string of `region-bounds'
Date: Fri, 26 Oct 2018 08:48:17 -0700 (PDT)

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

[Message part 3 (message/rfc822, inline)]

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 33168-done <at> debbugs.gnu.org
Subject: Re: bug#33168: 26; Doc string of `region-bounds'
Date: Sat, 27 Oct 2018 13:52:41 +0300

> Date: Fri, 26 Oct 2018 08:48:17 -0700 (PDT)
> From: Drew Adams <drew.adams <at> oracle.com>
> 
> 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.

Previous Next

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