GNU bug report logs - #9675
24.0.50; doc for font name specification

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 9675 in the body.
You can then email your comments to 9675 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: 24.0.50; doc for font name specification
Date: Wed, 5 Oct 2011 07:59:47 -0700

(elisp) Low-Level Font says this about `font-spec' keyword `:name':
 
 The font name (a string), in either XLFD, Fontconfig, or GTK
 format.  *Note Font Specification Options: (emacs)Font X.
 
There is no explanation or cross reference to understand what those 3
formats are, and without that info this description is useless.  The
cross ref that is there takes you to a node about font specification on
the command line (for X Window only?).
 
Please _specify_ the available formats for the `:name' value.  Or if
they are in fact already clearly specified somewhere, then please cross
reference that/those location(s).
 

In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600)
 of 2011-09-19 on 3249CTO
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (4.5) --no-opt'
 

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

From: "Drew Adams" <drew.adams <at> oracle.com>
To: <9675 <at> debbugs.gnu.org>
Subject: RE: bug#9675: 24.0.50; doc for font name specification
Date: Wed, 5 Oct 2011 08:03:47 -0700

Also, the same node, (elisp) Low-Level Font, has this in its description of
`font-xlfd-name':

 "*Note Font Specification Options: (emacs)Font X, for
  information about XLFDs."

AFAICT, there is nothing at that cross referenced node that says anything about
XLFDs.  Seems like the wrong cross reference is being used, or perhaps the
relevant information was moved out of the cross-referenced node.

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

From: Chong Yidong <cyd <at> stupidchicken.com>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 9675 <at> debbugs.gnu.org
Subject: Re: bug#9675: 24.0.50; doc for font name specification
Date: Wed, 05 Oct 2011 17:40:00 -0400

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

> Also, the same node, (elisp) Low-Level Font, has this in its description of
> `font-xlfd-name':
>
>  "*Note Font Specification Options: (emacs)Font X, for
>   information about XLFDs."
>
> AFAICT, there is nothing at that cross referenced node that says anything about
> XLFDs.  Seems like the wrong cross reference is being used, or perhaps the
> relevant information was moved out of the cross-referenced node.

Fixed, thanks.

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

From: Jason Rumney <jasonr <at> gnu.org>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 9675 <at> debbugs.gnu.org
Subject: Re: bug#9675: 24.0.50; doc for font name specification
Date: Thu, 06 Oct 2011 22:08:02 +0800

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

> (elisp) Low-Level Font says this about `font-spec' keyword `:name':
>  
>  The font name (a string), in either XLFD, Fontconfig, or GTK
>  format.  *Note Font Specification Options: (emacs)Font X.
>  
> There is no explanation or cross reference to understand what those 3
> formats are, and without that info this description is useless.

Font X has a cross-reference to Fonts which does contain the
documentation you are looking for. I presume Chong's fix was to link
directly there.

But before specifying the formats, it says "on X...". Windows accepts
the first three formats listed, but I am not sure about the NS port. If
that accepts those formats too, then the "on X..." should be removed.

Previous Next

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