From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#29721: 26.0; doc string of `invisible-p' Date: Sat, 16 Dec 2017 12:22:00 +0200 Message-ID: <83k1xnrn07.fsf@gnu.org> References: Reply-To: Eli Zaretskii NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1513419794 11942 195.159.176.226 (16 Dec 2017 10:23:14 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 16 Dec 2017 10:23:14 +0000 (UTC) Cc: 29721-done@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Dec 16 11:23:09 2017 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eQ9ca-0002Yo-29 for geb-bug-gnu-emacs@m.gmane.org; Sat, 16 Dec 2017 11:23:08 +0100 Original-Received: from localhost ([::1]:50089 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eQ9cf-0002yz-Oa for geb-bug-gnu-emacs@m.gmane.org; Sat, 16 Dec 2017 05:23:13 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:42119) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eQ9cZ-0002yG-NQ for bug-gnu-emacs@gnu.org; Sat, 16 Dec 2017 05:23:08 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eQ9cW-0001t5-Fw for bug-gnu-emacs@gnu.org; Sat, 16 Dec 2017 05:23:07 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:55994) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1eQ9cW-0001sp-D2 for bug-gnu-emacs@gnu.org; Sat, 16 Dec 2017 05:23:04 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1eQ9cU-00012R-2Z for bug-gnu-emacs@gnu.org; Sat, 16 Dec 2017 05:23:04 -0500 Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-To: bug-gnu-emacs@gnu.org Resent-Date: Sat, 16 Dec 2017 10:23:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: cc-closed 29721 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Mail-Followup-To: 29721@debbugs.gnu.org, eliz@gnu.org, drew.adams@oracle.com Original-Received: via spool by 29721-done@debbugs.gnu.org id=D29721.15134197313913 (code D ref 29721); Sat, 16 Dec 2017 10:23:01 +0000 Original-Received: (at 29721-done) by debbugs.gnu.org; 16 Dec 2017 10:22:11 +0000 Original-Received: from localhost ([127.0.0.1]:36441 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eQ9be-000113-RH for submit@debbugs.gnu.org; Sat, 16 Dec 2017 05:22:11 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:50778) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eQ9bc-00010p-Vl for 29721-done@debbugs.gnu.org; Sat, 16 Dec 2017 05:22:09 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eQ9bT-0000y8-Sm for 29721-done@debbugs.gnu.org; Sat, 16 Dec 2017 05:22:03 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:59864) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eQ9bT-0000xu-PC; Sat, 16 Dec 2017 05:21:59 -0500 Original-Received: from [176.228.60.248] (port=2194 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1eQ9bT-0006bM-3d; Sat, 16 Dec 2017 05:21:59 -0500 In-reply-to: (message from Drew Adams on Fri, 15 Dec 2017 09:41:55 -0800 (PST)) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:141149 Archived-At: > Date: Fri, 15 Dec 2017 09:41:55 -0800 (PST) > From: Drew Adams > > 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.