[AC21.5] Fix bogus Xft resource specs in FAQ
15 years, 5 months
Stephen J. Turnbull
Stephen J. Turnbull
APPROVE COMMIT 21.5
Minor doc update.
diff -r 83e35df20028 -r dd12adb12b8f man/ChangeLog
--- a/man/ChangeLog Mon Sep 08 08:48:22 2008 +0200
+++ b/man/ChangeLog Sat Oct 04 13:57:55 2008 +0900
＠＠ -0,0 +1,5 ＠＠
+2008-10-04 Stephen J. Turnbull <stephen(a)xemacs.org>
+
+ * xemacs-faq.texi (Q5.0.7): Fix broken instructions on use of
+ antialiased fonts.
+
diff -r 83e35df20028 -r dd12adb12b8f man/xemacs-faq.texi
--- a/man/xemacs-faq.texi Mon Sep 08 08:48:22 2008 +0200
+++ b/man/xemacs-faq.texi Sat Oct 04 13:57:55 2008 +0900
＠＠ -6284,41 +6284,53 ＠＠
＠node Q5.0.7, Q5.1.1, Q5.0.6, External Subsystems
＠unnumberedsubsec Q5.0.7: How can I use antialiased fonts under X11?
-For this you need a recent beta version, and please consider the caveats
-that apply when using beta software from any source. Rebuild xemacs
-using at least the following options to configure:
-
-(a)samp{./configure --enable-mule --with-xft=emacs,menubars}
-
-For further details on the XEmacs widgets that support XFT, see the
-output of ＠code{./configure --help}. You may find that you have to
-install some lib[something]-dev packages to provide header files; see
-your packaging system's documentation. Depending on your platform, your
-packaging system will normally be something like RPM, ＠code{apt} or
-DarwinPorts.
+The X11 version of XEmacs can use antialiased fonts via the Xft,
+fontconfig, and freetype libraries. To configure this you need a recent
+beta version (at least 21.5.24); the more recent, the better. This is
+beta software, the usual caveats apply. Rebuild xemacs using the
+following configure options, plus any others you normally use:
+
+＠samp{--enable-mule --with-xft=emacs,menubars}
+
+Xft ＠emph{may} work without Mule but the developers working on the Xft
+code invariably build with Mule. The tab control also supports Xft, and
+at some date the progress gauge will as well. If they are configured in
+to XEmacs, you may add ＠samp{tabs} and ＠samp{gauges} to the value of the
+＠samp{--with-xft} option (with a comma separating each value from the
+previous ones). For further details on the XEmacs widgets that support
+XFT, see the output of ＠code{./configure --help}. If you use a package
+manager from your OS distribution, you may need to install development
+packages for ＠file{fontconfig} and ＠file{Xft}, and possibly for their
+prequisites.
To specify a particular antialiased font, put something like the
-following lines in your ＠file{~/.Xdefaults} or ＠file{~.Xresources}
-(using ＠code{#define} in ＠file{.Xresources} avoids boring hand
-substitution):
-
-＠example
-#define MONO Mono
-#define SANS Sans
-#define PTSIZEM 12
-#define PTSIZES 11
- XEmacs.default.attributeFont: MONO:size=PTSIZEM
- XEmacs.bold.attributeFont: MONO:size=PTSIZEM:style=Bold
- XEmacs.italic.attributeFont: MONO:size=PTSIZEM:style=Oblique
-XEmacs.bold-italic.attributeFont: MONO:size=PTSIZEM:style=Bold Oblique
- XEmacs.modeline.attributeFont: SANS:size=PTSIZES
- XEmacs.menubar.font: SANS:size=PTSIZES
- XEmacs*xftFont: SANS:size=PTSIZES
-＠end example
-
-And run ＠code{xrdb -merge} before starting the new, XFT-enabled xemacs.
-You can choose the available fonts from the list given by
-＠code{fc-list}; try ＠code{xfd -fa FONTNAME-SIZE} to preview a given font.
+following lines in your ＠file{~/.Xdefaults} or ＠file{~/.Xresources}:
+
+＠example
+ XEmacs.default.attributeFont: monospace-12
+ XEmacs.bold.attributeFont: monospace-12:style=Bold
+ XEmacs.italic.attributeFont: monospace-12:style=Oblique
+XEmacs.bold-italic.attributeFont: monospace-12:style=Bold Oblique
+ XEmacs.modeline.attributeFont: sans-serif-11
+ XEmacs.menubar.xftFont: sans-serif-11
+ XEmacs*XftFont: sans-serif-11
+＠end example
+
+＠strong{Warning}: These resource naming conventions are just hacks to
+get the code running; you should expect them to change. (Sorry about
+that, but this ＠emph{is} beta software!)
+
+Then run ＠code{xrdb -merge} before starting the new, XFT-enabled
+xemacs. You can choose the available fonts from the list given by
+＠code{fc-list}; try ＠code{xfd -fa FONTNAME-SIZE} to preview a given
+font. Note that ``monospace'' and ``sans-serif'' are generic aliases
+defined by fontconfig which may correspond to any of many real fonts
+based on local configuration and availability of the aliased fonts,
+and so are likely to give good results in a well-set-up system.
+
+Although Customize does not yet handle fontconfig fontspecs, you can
+pass them as strings directly to ＠samp{set-face-font} to set fonts from
+Lisp.
＠unnumberedsec 5.1: Microsoft Windows
_______________________________________________
XEmacs-Patches mailing list
XEmacs-Patches(a)xemacs.org
http://calypso.tux.org/cgi-bin/mailman/listinfo/xemacs-patches
- 1 participants
- 0 comments
[AC 21.5] Improve pointers to package docs in INSTALL
15 years, 5 months
Stephen J. Turnbull
Stephen J. Turnbull
APPROVE COMMIT 21.5
Minor doc update.
diff -r 66411359ce4e -r e8a9d6a10efa ChangeLog
--- a/ChangeLog Sat Oct 25 21:40:46 2008 +0900
+++ b/ChangeLog Sat Oct 25 21:52:48 2008 +0900
＠＠ -0,0 +1,4 ＠＠
+2008-10-25 Stephen J. Turnbull <stephen(a)xemacs.org>
+
+ * INSTALL: Give better pointers to package documentation.
+
diff -r 66411359ce4e -r e8a9d6a10efa INSTALL
--- a/INSTALL Sat Oct 25 21:40:46 2008 +0900
+++ b/INSTALL Sat Oct 25 21:52:48 2008 +0900
＠＠ -1,7 +1,7 ＠＠
XEmacs Installation Guide
Copyright (c) 1994, 1995, 1996 Board of Trustees, University of Illinois
-Copyright (c) 1994-1999, 2003 Free Software Foundation, Inc.
+Copyright (c) 1994-1999, 2003, 2008 Free Software Foundation, Inc.
Permission is granted to anyone to make or distribute verbatim copies
of this document as received, in any medium, provided that the
＠＠ -61,11 +61,13 ＠＠
PACKAGE SYSTEM
==============
-The file README.packages contain information vital to have a fully
+The FAQ sections 1.7 and 2.1 contain information vital to have a fully
working XEmacs. It includes a description of available packages, and
how to bootstrap XEmacs from a minimal or a complete set of packages.
This information was not included in this file only because it is too
-large for this terse INSTALL. Please read README.packages now!
+large for this terse INSTALL. The FAQ is available in Texinfo format
+in man/xemacs-faq.texi, as an Info file once you build XEmacs, and
+online at http://www.xemacs.org/Documentation/21.5/html/xemacs-faq_1.html.
ADD-ON LIBRARIES
================
＠＠ -794,8 +796,8 ＠＠
remove the files that `configure' created (so you can compile XEmacs
for a different configuration), type `make distclean'.
-READ README.packages
-====================
+READ THE FAQ
+============
Do it!
＠＠ -803,8 +805,8 ＠＠
========
The most common problem is that you forgot to read and follow the
-directions in README.packages. You can not have a normal XEmacs
-without downloading some additional packages.
+directions for installing bootstrap packages in the FAQ. You can not
+have a normal XEmacs without downloading some additional packages.
See the file PROBLEMS in this directory for a list of various problems
sometimes encountered, and what to do about them. PROBLEMS is also
_______________________________________________
XEmacs-Patches mailing list
XEmacs-Patches(a)xemacs.org
http://calypso.tux.org/cgi-bin/mailman/listinfo/xemacs-patches
- 1 participants
- 0 comments