GNU bug report logs -
#11225
24.1.50; Explanation of SPECS arg in docstrings in face-remap.el insufficient
Previous Next
Reported by: michael_heerdegen <at> web.de
Date: Wed, 11 Apr 2012 18:28:02 UTC
Severity: minor
Found in version 24.1.50
Done: Chong Yidong <cyd <at> gnu.org>
Bug is archived. No further changes may be made.
To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 11225 in the body.
You can then email your comments to 11225 AT debbugs.gnu.org in the normal way.
Toggle the display of automated, internal messages from the tracker.
Report forwarded
to
bug-gnu-emacs <at> gnu.org
:
bug#11225
; Package
emacs
.
(Wed, 11 Apr 2012 18:28:02 GMT)
Full text and
rfc822 format available.
Acknowledgement sent
to
michael_heerdegen <at> web.de
:
New bug report received and forwarded. Copy sent to
bug-gnu-emacs <at> gnu.org
.
(Wed, 11 Apr 2012 18:28:02 GMT)
Full text and
rfc822 format available.
Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):
Hello,
there are commands in face-remap.el that take a "specs" argument
(`face-remap-add-relative', `face-remap-set-base'). Their doc tells
that SPECS can also be a list of faces. It doesn't explain what the
meaning of a list of faces for that functions is.
Also the manual doesn't explain it (Node "Face Remapping"). There
is only this little example:
;; Remap the `escape-glyph' face into a combination
;; of the `highlight' and `italic' faces:
(face-remap-add-relative 'escape-glyph 'highlight 'italic)
which seems to say that the given faces are combined in some way (how?).
Maybe the docstrings and the manual can be clarified by adding just
one or two sentences that describe the meaning.
Thanks,
Michael
In GNU Emacs 24.1.50.1 (i486-pc-linux-gnu, GTK+ Version 3.2.3)
of 2012-04-10 on zelenka, modified by Debian
(emacs-snapshot package, version 2:20120410-1)
Windowing system distributor `The X.Org Foundation', version 11.0.11104000
Configured using:
`configure '--build' 'i486-linux-gnu' '--host' 'i486-linux-gnu'
'--prefix=/usr' '--sharedstatedir=/var/lib' '--libexecdir=/usr/lib'
'--localstatedir=/var' '--infodir=/usr/share/info'
'--mandir=/usr/share/man' '--with-pop=yes'
'--enable-locallisppath=/etc/emacs-snapshot:/etc/emacs:/usr/local/share/emacs/24.1.50/site-lisp:/usr/local/share/emacs/site-lisp:/usr/share/emacs/24.1.50/site-lisp:/usr/share/emacs/site-lisp'
'--without-compress-info' '--with-crt-dir=/usr/lib/i386-linux-gnu/'
'--with-x=yes' '--with-x-toolkit=gtk3' '--with-imagemagick=yes'
'build_alias=i486-linux-gnu' 'host_alias=i486-linux-gnu'
'CFLAGS=-DDEBIAN -DSITELOAD_PURESIZE_EXTRA=5000 -g -O2''
Information forwarded
to
bug-gnu-emacs <at> gnu.org
:
bug#11225
; Package
emacs
.
(Sat, 09 Jun 2012 06:30:02 GMT)
Full text and
rfc822 format available.
Message #8 received at 11225 <at> debbugs.gnu.org (full text, mbox):
Michael Heerdegen <michael_heerdegen <at> web.de> writes:
> there are commands in face-remap.el that take a "specs" argument
> (`face-remap-add-relative', `face-remap-set-base'). Their doc tells
> that SPECS can also be a list of faces. It doesn't explain what the
> meaning of a list of faces for that functions is.
>
> Also the manual doesn't explain it (Node "Face Remapping").
>
> Maybe the docstrings and the manual can be clarified by adding just
> one or two sentences that describe the meaning.
I've changed the manual and docstrings to clarify this. Thanks.
bug closed, send any further explanations to
11225 <at> debbugs.gnu.org and michael_heerdegen <at> web.de
Request was from
Chong Yidong <cyd <at> gnu.org>
to
control <at> debbugs.gnu.org
.
(Sat, 09 Jun 2012 06:31:02 GMT)
Full text and
rfc822 format available.
bug archived.
Request was from
Debbugs Internal Request <help-debbugs <at> gnu.org>
to
internal_control <at> debbugs.gnu.org
.
(Sat, 07 Jul 2012 11:24:02 GMT)
Full text and
rfc822 format available.
This bug report was last modified 11 years and 305 days ago.
Previous Next
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997,2003 nCipher Corporation Ltd,
1994-97 Ian Jackson.