Re: Elisp manual doc on `intangible' is incomplete

2007-05-30 Thread Lennart Borgman (gmail)

Drew Adams wrote:

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.



___
emacs-pretest-bug mailing list
emacs-pretest-bug@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-pretest-bug


RE: Elisp manual doc on `intangible' is incomplete

2007-05-30 Thread 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.



___
emacs-pretest-bug mailing list
emacs-pretest-bug@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-pretest-bug


Re: Elisp manual doc on `intangible' is incomplete

2007-05-30 Thread Stefan Monnier
 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.

 I clarified that.  Thanks.

I'd also add a big red warning that this is a very big hammer which tend to
break other code not expecting such odd behavior of goto-char (and friends)
and should thus be used with a lot of extra care and only when
absolutely necessary.


Stefan


___
emacs-pretest-bug mailing list
emacs-pretest-bug@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-pretest-bug