unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#29721: 26.0; doc string of `invisible-p'
@ 2017-12-15 17:41 Drew Adams
  2017-12-16 10:22 ` Eli Zaretskii
  0 siblings, 1 reply; 2+ messages in thread
From: Drew Adams @ 2017-12-15 17:41 UTC (permalink / raw)
  To: 29721

The doc string is unclear.

  "(invisible-p POS-OR-PROP)

   Non-nil if the property makes the text invisible."

What property?  What text?

  "The non-nil value returned can be t for truly invisible text or
   something else if the text is replaced by an ellipsis."

Huh?  What is "truly invisible"?  What "something else"?  Does
"something else" include `nil'?  What does it mean for "the text" to be
replaced by an ellipsis?  What does the (unspecified!) value signify in
the case of "the text" (?) being "replaced by an ellipsis"?

It's really not clear what this doc is trying to say.

This text was introduced in Emacs 23.  Prior to that the text was clear:
"Return non-nil if the character after POS is currently invisible."


In GNU Emacs 26.0.90 (build 3, x86_64-w64-mingw32)
 of 2017-10-13
Repository revision: 906224eba147bdfc0514090064e8e8f53160f1d4
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --without-dbus --host=x86_64-w64-mingw32
 --without-compress-install 'CFLAGS=-O2 -static -g3''





^ permalink raw reply	[flat|nested] 2+ messages in thread

* bug#29721: 26.0; doc string of `invisible-p'
  2017-12-15 17:41 bug#29721: 26.0; doc string of `invisible-p' Drew Adams
@ 2017-12-16 10:22 ` Eli Zaretskii
  0 siblings, 0 replies; 2+ messages in thread
From: Eli Zaretskii @ 2017-12-16 10:22 UTC (permalink / raw)
  To: Drew Adams; +Cc: 29721-done

> Date: Fri, 15 Dec 2017 09:41:55 -0800 (PST)
> From: Drew Adams <drew.adams@oracle.com>
> 
> The doc string is unclear.
> 
>   "(invisible-p POS-OR-PROP)
> 
>    Non-nil if the property makes the text invisible."
> 
> What property?  What text?

Thanks, fixed.

>   "The non-nil value returned can be t for truly invisible text or
>    something else if the text is replaced by an ellipsis."
> 
> Huh?  What is "truly invisible"?

"Truly" because text with 'invisible' property could be still visible,
depending on buffer-invisibility-spec.  I added the reference to that.

> What "something else"?  Does "something else" include `nil'?  [...]
> What does the (unspecified!) value signify in the case of "the text"
> (?) being "replaced by an ellipsis"?

The value itself is of no significance, besides the fact that it's not
nil and not t, so I see no reason to document what it is, exactly.  If
you are really interested, you can read the code, or try calling that
function on invisible text replaced with an ellipsis, then you will
see that the value is truly of no importance.

> What does it mean for "the text" to be replaced by an ellipsis?

That is a well-known feature, see (elisp)Invisible Text.  I hope a
reference to buffer-invisibility-spec makes it even more clear.





^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2017-12-16 10:22 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2017-12-15 17:41 bug#29721: 26.0; doc string of `invisible-p' Drew Adams
2017-12-16 10:22 ` Eli Zaretskii

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).