* bug#16516: 24.3.50; NEWS item about `apropos-*-face' user options and new faces
@ 2014-01-22 3:06 Drew Adams
2014-02-09 4:24 ` Lars Ingebrigtsen
0 siblings, 1 reply; 2+ messages in thread
From: Drew Adams @ 2014-01-22 3:06 UTC (permalink / raw)
To: 16516
1. This is the inadequate NEWS item:
** Apropos
*** The faces used by Apropos are now directly customizable.
These faces are named `apropos-symbol', `apropos-keybinding', and so on;
see the `apropos' Custom group for details.
*** The old options whose values specified faces to use have been removed
(i.e. `apropos-symbol-face', `apropos-keybinding-face', etc.).
Why inadequate? Because it does not list the options, so users can check
their current customizations of those options and transfer them to the
new faces (something that Emacs could have done for them, BTW).
It is not enough to say "etc." and "and so on." List the options. By
my checking, I find these: apropos-keybinding-face, apropos-label-face,
apropos-match-face, apropos-property-face, apropos-symbol-face. Is it
so hard to find and state the list, to help users?
You go to great lengths to help users locate the new faces (telling them
to use `M-x customize-group apropos'. But from a user point of view
what's first needed is the list of options that the new faces replace.
This is what a NEWS item about replacement needs to inform users of: A
has been replaced by B. Why? So users can replace A with B in their
own code, custom files, etc.
2. Plus, this removal and replacement is apparently not the case for all
`apropos-*-face' options - see option `apropos-match-face'. Why this
inconsistency? Point it out in NEWS, at least, if it really has a good
reason for continuing. As it stands now, the NEWS text is incorrect,
claiming the removal of all such face options.
In GNU Emacs 24.3.50.1 (i686-pc-mingw32)
of 2014-01-17 on ODIEONE
Bzr revision: 116059 michael.albinus@gmx.de-20140117182409-gz695p2c951idlee
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
`configure --prefix=/c/Devel/emacs/binary --enable-checking=yes,glyphs
'CFLAGS=-O0 -g3' LDFLAGS=-Lc:/Devel/emacs/lib
CPPFLAGS=-Ic:/Devel/emacs/include'
^ permalink raw reply [flat|nested] 2+ messages in thread
* bug#16516: 24.3.50; NEWS item about `apropos-*-face' user options and new faces
2014-01-22 3:06 bug#16516: 24.3.50; NEWS item about `apropos-*-face' user options and new faces Drew Adams
@ 2014-02-09 4:24 ` Lars Ingebrigtsen
0 siblings, 0 replies; 2+ messages in thread
From: Lars Ingebrigtsen @ 2014-02-09 4:24 UTC (permalink / raw)
To: Drew Adams; +Cc: 11457, 16516
Drew Adams <drew.adams@oracle.com> writes:
> It is not enough to say "etc." and "and so on." List the options. By
> my checking, I find these: apropos-keybinding-face, apropos-label-face,
> apropos-match-face, apropos-property-face, apropos-symbol-face. Is it
> so hard to find and state the list, to help users?
Fixed on trunk.
--
(domestic pets only, the antidote for overdose, milk.)
bloggy blog http://lars.ingebrigtsen.no/
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2014-02-09 4:24 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2014-01-22 3:06 bug#16516: 24.3.50; NEWS item about `apropos-*-face' user options and new faces Drew Adams
2014-02-09 4:24 ` Lars Ingebrigtsen
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).