From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#19628: 25.0.50; doc of button functions Date: Mon, 19 Jan 2015 08:20:52 -0800 (PST) Message-ID: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1421684540 25208 80.91.229.3 (19 Jan 2015 16:22:20 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 19 Jan 2015 16:22:20 +0000 (UTC) To: 19628@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Jan 19 17:22:16 2015 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1YDF5k-0005gH-C4 for geb-bug-gnu-emacs@m.gmane.org; Mon, 19 Jan 2015 17:22:16 +0100 Original-Received: from localhost ([::1]:38384 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YDF5j-00084W-LM for geb-bug-gnu-emacs@m.gmane.org; Mon, 19 Jan 2015 11:22:15 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:38004) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YDF5f-00084N-P6 for bug-gnu-emacs@gnu.org; Mon, 19 Jan 2015 11:22:12 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YDF5W-0004tz-Po for bug-gnu-emacs@gnu.org; Mon, 19 Jan 2015 11:22:11 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:52737) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YDF5W-0004tv-Kj for bug-gnu-emacs@gnu.org; Mon, 19 Jan 2015 11:22:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1YDF5W-0002iA-BK for bug-gnu-emacs@gnu.org; Mon, 19 Jan 2015 11:22:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 19 Jan 2015 16:22:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 19628 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.142168447510360 (code B ref -1); Mon, 19 Jan 2015 16:22:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 19 Jan 2015 16:21:15 +0000 Original-Received: from localhost ([127.0.0.1]:33365 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YDF4l-0002h1-7s for submit@debbugs.gnu.org; Mon, 19 Jan 2015 11:21:15 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:35814) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YDF4i-0002gl-Pe for submit@debbugs.gnu.org; Mon, 19 Jan 2015 11:21:13 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YDF4c-0004c6-J4 for submit@debbugs.gnu.org; Mon, 19 Jan 2015 11:21:07 -0500 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:34614) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YDF4c-0004c2-FM for submit@debbugs.gnu.org; Mon, 19 Jan 2015 11:21:06 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:37521) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YDF4b-0007Ub-Cs for bug-gnu-emacs@gnu.org; Mon, 19 Jan 2015 11:21:06 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YDF4V-0004aq-PS for bug-gnu-emacs@gnu.org; Mon, 19 Jan 2015 11:21:05 -0500 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:40024) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YDF4V-0004aZ-Is for bug-gnu-emacs@gnu.org; Mon, 19 Jan 2015 11:20:59 -0500 Original-Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t0JGKwtd021393 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Mon, 19 Jan 2015 16:20:58 GMT Original-Received: from aserz7021.oracle.com (aserz7021.oracle.com [141.146.126.230]) by ucsinet22.oracle.com (8.14.5+Sun/8.14.5) with ESMTP id t0JGKvbE025978 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL) for ; Mon, 19 Jan 2015 16:20:57 GMT Original-Received: from abhmp0010.oracle.com (abhmp0010.oracle.com [141.146.116.16]) by aserz7021.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id t0JGKvtc001991 for ; Mon, 19 Jan 2015 16:20:57 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8.2 (807160) [OL 12.0.6691.5000 (x86)] X-Source-IP: ucsinet22.oracle.com [156.151.31.94] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 140.186.70.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-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:98478 Archived-At: The doc of `make-button', `insert-button', and `insert-text-button' just mentions "a sequence of PROPERTY VALUE pairs, specifying properties to add to the button", without saying anything about the text properties that are special for these functions. This is true for both the doc strings and the Elisp manual (node `Making Buttons'). Some text properties, such as `face' and `follow-link' are common, used generally, and are explained elsewhere. But others, such as `action', seem to be special to the button code and these functions. So they should be mentioned in this doc. Property `action' is mentioned for function `button-activate' (e.g. nodes `Button Properties', `Manipulating Buttons', and `Button Buffer Commands'). But it and any other properties specific to the button functions should be called out where we speak of such properties. Or else such doc should refer to some location where we do specify such properties. What's more, the doc strings of `push-button' and `button-activate' need to mention property `action', just as the Elisp doc for them does. It is not sufficient for the doc strings to simply refer to the "normal action" of the button, without saying what that means. In GNU Emacs 25.0.50.1 (i686-pc-mingw32) of 2014-10-20 on LEG570 Bzr revision: 118168 rgm@gnu.org-20141020195941-icp42t8ttcnud09g Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --enable-checking=3Dyes,glyphs CPPFLAGS=3D-DGLYPH_DEBUG=3D1'