GNU bug report logs - #4178
23.1; doc bug, Elisp manual: notion of font family is not explained

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 4178 in the body.
You can then email your comments to 4178 AT debbugs.gnu.org in the normal way.

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

Message #5 received at submit <at> emacsbugs.donarmstrong.com (full text, mbox):

From: "Drew Adams" <drew.adams <at> oracle.com>
To: <bug-gnu-emacs <at> gnu.org>
Subject: 23.1; doc bug, Elisp manual: notion of font family is not explained
Date: Mon, 17 Aug 2009 10:08:33 -0700

Various parts of the Elisp manual refer to font families, but this
concept is nowhere explained (defined).
 
Using `i' in Info shows, for example, when checking for both `font'
and `family', these index entries:
 
`face-font-family-alternatives' `font-family-list' `x-family-fonts'
 
Look at the indexed doc and you will see that it talks about font
families, without ever saying what a font family is. This makes the
doc incomprehensible. Try to understand the `x-family-fonts'
description, for instance, without knowing what a font family is
(which is my case, FWIW).
 
Substitute `zophlog' for `family', then see if you understand:
 
  Function: x-zophlog-fonts &optional zophlog frame
     This function returns a list describing the available fonts for
     zophlog ZOPHLOG on FRAME.  If ZOPHLOG is omitted or `nil', this list
     applies to all zophlogs, and therefore, it contains all available
     fonts.  Otherwise, ZOPHLOG must be a string; it may contain the
     wildcards `?' and `*'.
 
     The list describes the display that FRAME is on; if FRAME is
     omitted or `nil', it applies to the selected frame's display
     (*note Input Focus::).
 
     Each element in the list is a vector of the following form:
 
          [ZOPHLOG WIDTH POINT-SIZE WEIGHT SLANT
           FIXED-P FULL REGISTRY-AND-ENCODING]
 
     The first five elements correspond to face attributes; if you
     specify these attributes for a face, it will use this font.
 
     The last three elements give additional information about the font.
     FIXED-P is non-`nil' if the font is fixed-pitch.  FULL is the full
     name of the font, and REGISTRY-AND-ENCODING is a string giving the
     registry and encoding of the font.
 
That's as much as I understand - essentially nothing. Please define
and explain the notion `font family'.
 
Elisp manual nodes that use the unexplained notion `font family':
 
Faces
Face Attributes
Font Selection
Font Lookup
Fontsets
 
 
 
In GNU Emacs 23.1.1 (i386-mingw-nt5.1.2600)
 of 2009-07-29 on SOFT-MJASON
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (4.4)'
 

Message #10 received at 4178 <at> emacsbugs.donarmstrong.com (full text, mbox):

From: Chong Yidong <cyd <at> stupidchicken.com>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 4178 <at> debbugs.gnu.org
Subject: Re: 23.1; doc bug, Elisp manual: notion of font family is not explained
Date: Fri, 11 Sep 2009 20:20:26 -0400

> Various parts of the Elisp manual refer to font families, but this
> concept is nowhere explained (defined).

I don't think it's the place of the Emacs manual to define every single
operating system concept, especially one as self-explanatory as "font
family".  But if it makes you happy, I can add it to the glossary.

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

From: Lars Magne Ingebrigtsen <larsi <at> gnus.org>
To: Chong Yidong <cyd <at> stupidchicken.com>
Cc: 4178 <at> debbugs.gnu.org, Drew Adams <drew.adams <at> oracle.com>
Subject: Re: 23.1;
	doc bug, Elisp manual: notion of font family is not explained
Date: Tue, 12 Jul 2011 23:00:37 +0200

Chong Yidong <cyd <at> stupidchicken.com> writes:

>> Various parts of the Elisp manual refer to font families, but this
>> concept is nowhere explained (defined).
>
> I don't think it's the place of the Emacs manual to define every single
> operating system concept, especially one as self-explanatory as "font
> family".  But if it makes you happy, I can add it to the glossary.

I can't seem to find it in the glossary.  On the other hand, I think
this is something that doesn't really belong in the manual.

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

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

From: Chong Yidong <cyd <at> stupidchicken.com>
To: Lars Magne Ingebrigtsen <larsi <at> gnus.org>
Cc: 4178 <at> debbugs.gnu.org, Drew Adams <drew.adams <at> oracle.com>
Subject: Re: 23.1;
	doc bug, Elisp manual: notion of font family is not explained
Date: Tue, 12 Jul 2011 18:13:15 -0400

Lars Magne Ingebrigtsen <larsi <at> gnus.org> writes:

> Chong Yidong <cyd <at> stupidchicken.com> writes:
>
>>> Various parts of the Elisp manual refer to font families, but this
>>> concept is nowhere explained (defined).
>>
>> I don't think it's the place of the Emacs manual to define every single
>> operating system concept, especially one as self-explanatory as "font
>> family".  But if it makes you happy, I can add it to the glossary.
>
> I can't seem to find it in the glossary.  On the other hand, I think
> this is something that doesn't really belong in the manual.

I added a couple of xrefs to the Fonts node in the Emacs manual, from
which the meaning of "font families" should be obvious.  Closing the
bug.

Previous Next

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