[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[debbugs-tracker] bug#19628: closed (25.0.50; doc of button functions)

From: GNU bug Tracking System
Subject: [debbugs-tracker] bug#19628: closed (25.0.50; doc of button functions)
Date: Tue, 20 Jan 2015 19:24:02 +0000

Your message dated Tue, 20 Jan 2015 21:23:26 +0200
with message-id <address@hidden>
and subject line Re: bug#19628: 25.0.50; doc of button functions
has caused the debbugs.gnu.org bug report #19628,
regarding 25.0.50; doc of button functions
to be marked as done.

(If you believe you have received this mail in error, please contact

19628: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=19628
GNU Bug Tracking System
Contact address@hidden with problems
--- Begin Message --- Subject: 25.0.50; doc of button functions Date: Mon, 19 Jan 2015 08:20:52 -0800 (PST)
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

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 (i686-pc-mingw32)
 of 2014-10-20 on LEG570
Bzr revision: 118168 address@hidden
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --enable-checking=yes,glyphs CPPFLAGS=-DGLYPH_DEBUG=1'

--- End Message ---
--- Begin Message --- Subject: Re: bug#19628: 25.0.50; doc of button functions Date: Tue, 20 Jan 2015 21:23:26 +0200
> Date: Tue, 20 Jan 2015 10:51:20 -0800 (PST)
> From: Drew Adams <address@hidden>
> Cc: address@hidden
> As I said, in `Manipulating Buttons', for example, the description of
> `button-activate' refers to "BUTTON's `action' property".  That property
> is not explained there, so there should be a cross-ref from there to the
> place where it is described: `Button Properties'.

OK, I added a few words about 'action' there.  (Having a
cross-reference just to save a sentence or two didn't sound right.)

--- End Message ---

reply via email to

[Prev in Thread] Current Thread [Next in Thread]