RE: Elisp manual doc on `intangible' is incomplete

[Drew Adams]

> > Elisp manual node Special Properties says this about `intangible':
> >
> >      If a group of consecutive characters have equal and non-`nil'
> >      `intangible' properties, then you cannot place point between them.
> >      If you try to move point forward into the group, point actually
> >      moves to the end of the group.  If you try to move point backward
> >      into the group, point actually moves to the start of the group.
> >
> >      When the variable `inhibit-point-motion-hooks' is non-`nil', the
> >      `intangible' property is ignored.
> >
> > It does not say anything about what the meaning or behavior is if
> > consecutive characters have unequal but non-nil `intangible'
> > values. Why the qualification of having equal values? What is a user
> > to understand about this?
>
>
> Is it not a corallary that the values does not have to be equal? Even
> consecutive characters with non-nil, but unequal values will form a
> group behaving the same way.

I think it would help to add an explicit statement that you can place point
between groups (which are defined as consecutive characters with the same
`intangible' value). That is, clarify that you can place point between
groups, but not within a group.

The text might imply this, but it would be clearer to say it explicitly.
That way, the purpose of such groups is made clear.