bug#38051: 26.3; (elisp) `Insertion' use of verb "point"

[Eli Zaretskii]

> Date: Fri, 8 Nov 2019 17:53:06 +0000 (UTC)
> From: Drew Adams <drew.adams@oracle.com>
> Cc: 38051@debbugs.gnu.org
> 
> 1. From a user point of view (conceptual model),
>    markers _are_ objects that can be located
>    _in_ a buffer, _at_ buffer positions.

That is incorrect.  A marker stores a buffer and a location within
that buffer, but it isn't itself located in a buffer.

> 3. When we document `char-after', we don't say
>    that the char (which is conceptually _in_ the
>    buffer) "points at" a buffer position.  We
>    say "Return the character _in_ current buffer
>    _at_ position POS."
> 
>    Markers, like characters, are at buffer
>    positions (chars are actually after, not at).

See above: that's correct about characters, but incorrect about
markers.

> This is how we treat overlays.

Overlays are completely different beasts.