User: stephent Date: 05/11/29 13:08:42 Modified: xemacs/man/xemacs custom.texi Log: Pitiful Xft user docs and CHANGES-beta. <87zmnnslq0.fsf(a)tleepslib.sk.tsukuba.ac.jp&gt; Revision Changes Path 1.235 +3 -2 XEmacs/xemacs/CHANGES-beta Index: CHANGES-beta =================================================================== RCS file: /pack/xemacscvs/XEmacs/xemacs/CHANGES-beta,v retrieving revision 1.234 retrieving revision 1.235 diff -u -p -r1.234 -r1.235 --- CHANGES-beta 2005/11/29 03:31:25 1.234 +++ CHANGES-beta 2005/11/29 12:08:32 1.235 ＠＠ -30,6 +30,7 ＠＠ Documentation -- Improve: texi documentation of DEFSYMBOL. -- Stephen J. Turnbull -- Improve: texi documentation of XEmacs Autoconf macros. -- Malcolm Purvis -- Improve: update PROBLEMS, and install in etc. -- Malcolm Purvis +-- Update: about Jerry James. -- Stephen J. Turnbull Lisp API ＠＠ -44,7 +45,7 ＠＠ Internal API and Implementation -- Fix: compilation errors and warnings in GTK code. -- Malcolm Purvis -- Fix: help on functions without documentation. -- Ben Wing -- Fix: integer types for Berkeley db. -- Stephen J. Turnbull, Volker Zell --- Fix: make modules build on Cygwin and Mac. -- Stephen J. Turnbull, Rick Rankin +-- Fix: make modules build on Cygwin and Mac. -- Stephen J. Turnbull, Rick Rankin, Ben Wing -- Fix: quiet byte-compiler. -- Stephen J. Turnbull -- Fix: syntax error -- Marcus Crestani -- Fix: uninitialized local variables. -- Stephen J. Turnbull ＠＠ -57,7 +58,7 ＠＠ Internal API and Implementation -- Improve: refactor default_object_printer. -- Marcus Crestani -- Improve: remove dead code in lwlib. -- Stephen J. Turnbull -- Improve: reorganize lisp.h. -- Ben Wing --- Improve: tabs widget. -- Stephen J. Turnbull +-- Improve: tabs widget internals. -- Stephen J. Turnbull to 21.5.23 "daikon" Major features 1.702 +4 -0 XEmacs/xemacs/lisp/ChangeLog Index: ChangeLog =================================================================== RCS file: /pack/xemacscvs/XEmacs/xemacs/lisp/ChangeLog,v retrieving revision 1.701 retrieving revision 1.702 diff -u -p -r1.701 -r1.702 --- ChangeLog 2005/11/29 08:22:58 1.701 +++ ChangeLog 2005/11/29 12:08:35 1.702 ＠＠ -1,5 +1,9 ＠＠ 2005-11-29 Stephen J. Turnbull <stephen(a)xemacs.org&gt; + * objects.el (make-font-specifier): Document font name syntaxes. + +2005-11-29 Stephen J. Turnbull <stephen(a)xemacs.org&gt; + * about.el (about-personal-info, about-url-alist): Update `jerry'. 2005-11-26 Stephen J. Turnbull <stephen(a)xemacs.org&gt; 1.6 +5 -3 XEmacs/xemacs/lisp/objects.el Index: objects.el =================================================================== RCS file: /pack/xemacscvs/XEmacs/xemacs/lisp/objects.el,v retrieving revision 1.5 retrieving revision 1.6 diff -u -p -r1.5 -r1.6 --- objects.el 2001/04/12 18:21:32 1.5 +++ objects.el 2005/11/29 12:08:36 1.6 ＠＠ -50,9 +50,11 ＠＠ specifiers. Valid instantiators for font specifiers are: --- a string naming a font (e.g. under X this might be - \"-*-courier-medium-r-*-*-*-140-*-*-*-*-iso8859-*\" for a 14-point - upright medium-weight Courier font) +-- a string naming a font; syntax is platform dependent. Some examples for + a 14-point upright medium-weight Courier font: + X11 (and GTK1): \"-*-courier-medium-r-*-*-*-140-*-*-*-*-iso8859-*\" + Xft (and GTK2): \"Courier-14\" + MS-Windows: \"Courier:14:Western\" -- a font instance (use that instance directly if the device matches, or use the string that generated it) -- a vector of no elements (only on TTY's; this means to set no font 1.325 +5 -0 XEmacs/xemacs/man/ChangeLog Index: ChangeLog =================================================================== RCS file: /pack/xemacscvs/XEmacs/xemacs/man/ChangeLog,v retrieving revision 1.324 retrieving revision 1.325 diff -u -p -r1.324 -r1.325 --- ChangeLog 2005/11/26 11:46:03 1.324 +++ ChangeLog 2005/11/29 12:08:40 1.325 ＠＠ -1,3 +1,8 ＠＠ +2005-11-29 Stephen J. Turnbull <stephen(a)xemacs.org&gt; + + * xemacs/custom.texi (Faces): Describe some of the more important + font naming syntaxes under `set-face-font'. Fix a typo. + 2005-11-22 Stephen J. Turnbull <stephen(a)xemacs.org&gt; * internals/internals.texi (Working with Lisp Objects): Explain 1.21 +44 -1 XEmacs/xemacs/man/xemacs/custom.texi Index: custom.texi =================================================================== RCS file: /pack/xemacscvs/XEmacs/xemacs/man/xemacs/custom.texi,v retrieving revision 1.20 retrieving revision 1.21 diff -u -p -r1.20 -r1.21 --- custom.texi 2005/04/18 04:00:10 1.20 +++ custom.texi 2005/11/29 12:08:41 1.21 ＠＠ -2148,7 +2148,7 ＠＠ before the ＠code{x-bitmap-file-path} var Alternately, you can use a simpler version of ＠code{set-face-background-pixmap} called ＠code{set-face-background-pixmap-file}. This function does not give you -as much control on the pixmap instanciator, but provides filename +as much control on the pixmap instantiator, but provides filename completion. ＠findex set-face-font ＠＠ -2157,6 +2157,49 ＠＠ You can set the font of the specified ＠v name of a font. When called from a program, if the optional ＠var{frame} argument is provided, the face is changed only in that frame; otherwise, it is changed in all frames. + +The syntax of the ＠var{font} argument varies according to platform. In +each of the following syntaxes, the example shows how to specify a +14-point upright bold Courier font. + +＠table ＠strong +＠item X11 +The X11 syntax is defined by the ＠dfn{X Logical Font Descriptor} (XLFD) +standard. An XLFD contains 14 fields each preceded by a hyphen: +foundry, family, weight, slant, swidth, adstyle, pixelsize, pointsize, +xresolution, yresolution, spacing, averagewidth, registry, and encoding. +It is usually sufficient to specify family, weight, slant, pointsize, +registry, and encoding, wildcarding the rest with ＠samp{*}. If you're +not sure what's available, you can wildcard some of the fields usually +specified, too. Here's our example font in XLFD syntax: +＠code{"-*-courier-bold-r-*-*-*-140-*-*-*-*-iso8859-*"}. +The XLFD syntax is also used for GTK+ version 1. XLFD names must be +encoding in ISO-8859-1. + +＠item Xft +The Xft syntax is defined by the ＠file{fontconfig} library +＠ref{Font Names,,,fontconfig}. It is less a font naming convention than +a way to express any arbitrary subset of the font's properties in a +syntax that is both human- and machine-readable. A ＠file{fontconfig} +font name contains the family, a hyphen, and the pointsize, followed by +an arbitrary sequence of properties. Each property consists of a colon, +a keyword, an equals sign, and the property value. Here's our example +font in ＠file{fontconfig} syntax: ＠code{"Courier-14:weight=bold"}. This +syntax admits ``style abbreviations'' which can be user-defined. A +style is a single keyword denoting a sequence of properties. So the +example font may be abbreviated to ＠code{"Courier-14:bold"} ("bold" is a +standard abbreviation for "weight=bold"). The ＠file{fontconfig} syntax +is also used for GTK+ version 2. ＠file{fontconfig} names must be +encoded in UTF-8. + +＠item MS-Windows +The MS Windows syntax is superficially similar to that of Xft but +actually is more like XLFD. A font name consists of five fields, +family, size, slant, weight, and encoding, each expressed as a keyword +taking on standardized values (except family, which is just a name). +Here's our example font in MS Windows syntax: +＠code{"Courier:14:Bold:Western"}. +＠end table ＠findex set-face-foreground You can set the foreground color of the specified ＠var{face} with the