GNU bug report logs - #19722
25.0.50; (elisp) `Tool Bar': Add xref to doc for image specifications

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 19722 in the body.
You can then email your comments to 19722 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 25.0.50; (elisp) `Tool Bar': Add xref to doc for image specifications
Date: Thu, 29 Jan 2015 08:39:35 -0800 (PST)

The doc here describes `:image' in terms of "image specifications".
It should cross-reference the part of the manual that describes the
latter.  Otherwise, there is no way to understand what IMAGE means
in `:image IMAGE'.

Also, there is a typo:

   `:image IMAGE'
      IMAGES is either...

IMAGE or IMAGES?


In GNU Emacs 25.0.50.1 (i686-pc-mingw32)
 of 2014-10-20 on LEG570
Bzr revision: 118168 rgm <at> gnu.org-20141020195941-icp42t8ttcnud09g
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --enable-checking=yes,glyphs CPPFLAGS=-DGLYPH_DEBUG=1'

Message #8 received at 19722 <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: 19722 <at> debbugs.gnu.org
Subject: RE: bug#19722: 25.0.50; (elisp) `Tool Bar': Add xref to doc for image
 specifications
Date: Thu, 29 Jan 2015 08:50:47 -0800 (PST)

[Message part 1 (text/plain, inline)]

I note too that neither ":image" nor "image spec" has a substring match
for `i'.  (Yes, I know that you will reply that the former cannot be
indexed - dommage.)

FWIW, these (attached) are the only index entries I see when matching
"image" as a substring.  Dunno where to find the info about "image
specifications."  (Even searching for ":image" did not seem to help.)

[throw-elisp-manual-index--image.png (image/png, attachment)]

Message #11 received at 19722 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 19722 <at> debbugs.gnu.org
Subject: Re: bug#19722: 25.0.50;
 (elisp) `Tool Bar': Add xref to doc for image specifications
Date: Thu, 29 Jan 2015 19:13:03 +0200

> Date: Thu, 29 Jan 2015 08:50:47 -0800 (PST)
> From: Drew Adams <drew.adams <at> oracle.com>
> 
> I note too that neither ":image" nor "image spec" has a substring match
> for `i'.  (Yes, I know that you will reply that the former cannot be
> indexed - dommage.)
> 
> FWIW, these (attached) are the only index entries I see when matching
> "image" as a substring.  Dunno where to find the info about "image
> specifications."  (Even searching for ":image" did not seem to help.)

Please tell what information you were looking for, and which phrases
went through your head when you looked for that.

Message #14 received at 19722 <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: Eli Zaretskii <eliz <at> gnu.org>, Drew Adams <drew.adams <at> oracle.com>
Cc: 19722 <at> debbugs.gnu.org
Subject: RE: bug#19722: 25.0.50; (elisp) `Tool Bar': Add xref to doc for image
 specifications
Date: Thu, 29 Jan 2015 09:42:32 -0800 (PST)

> > I note too that neither ":image" nor "image spec" has a substring match
> > for `i'.  (Yes, I know that you will reply that the former cannot be
> > indexed - dommage.)
> >
> > FWIW, these (attached) are the only index entries I see when matching
> > "image" as a substring.  Dunno where to find the info about "image
> > specifications."  (Even searching for ":image" did not seem to help.)
> 
> Please tell what information you were looking for, and which phrases
> went through your head when you looked for that.

I was trying to find what an "image specification" is - its
format/structure etc.  One cannot understand the doc for `:image' in
that node without knowing what "image specification" amounts to.

Perhaps "image format" or "image descriptor" is the same thing? If so
then it could help to use the same terminology throughout, but an xref
is still needed here, IMO.  Perhaps it should go to node `Image Formats'
or to node `Image Descriptors'.  Dunno.

The term "image specification" is used in the manual in many places,
but none of those places seem to define/describe what it is.  Perhaps
each of those occurrences should be changed to a different term (?).
And perhaps each of those occurrences should have an xref to wherever
this thingie is described.

Message #17 received at 19722 <at> debbugs.gnu.org (full text, mbox):

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 19722 <at> debbugs.gnu.org
Subject: Re: bug#19722: 25.0.50;
 (elisp) `Tool Bar': Add xref to doc for image specifications
Date: Sat, 30 Apr 2016 18:48:40 +0200

Drew Adams <drew.adams <at> oracle.com> writes:

> The doc here describes `:image' in terms of "image specifications".
> It should cross-reference the part of the manual that describes the
> latter.  Otherwise, there is no way to understand what IMAGE means
> in `:image IMAGE'.

I've now added a link.

> Also, there is a typo:
>
>    `:image IMAGE'
>       IMAGES is either...
>
> IMAGE or IMAGES?

Fixed.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.