[PATCH COMMIT] encrypt
20 years, 1 month
Simon Josefsson
Simon Josefsson
I added the file encrypt.el, from Gnus CVS, to the ecrypto module,
because mail-lib's netrc.el need it.
2004-11-29 Simon Josefsson <jas(a)extundo.com>
* encrypt.el: New file.
* Makefile (ELCS): Add encrypt.elc.
;;; encrypt.el --- file encryption routines
;; Copyright (C) 2002, 2003, 2004 Free Software Foundation, Inc.
;; Author: Teodor Zlatanov <tzz(a)lifelogs.com>
;; Created: 2003/01/24
;; Keywords: files
;; This file is part of GNU Emacs.
;; GNU Emacs is free software; you can redistribute it and/or modify
;; it under the terms of the GNU General Public License as published by
;; the Free Software Foundation; either version 2, or (at your option)
;; any later version.
;; GNU Emacs is distributed in the hope that it will be useful,
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
;; GNU General Public License for more details.
;; You should have received a copy of the GNU General Public License
;; along with GNU Emacs; see the file COPYING. If not, write to the
;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
;; Boston, MA 02111-1307, USA.
;;; Commentary:
;;; This module addresses data encryption. Page breaks are used for
;;; grouping declarations and documentation relating to each
;;; particular aspect.
;;; Code:
;; autoload password
(eval-and-compile
(autoload 'password-read "password"))
(defgroup encrypt nil
"File encryption configuration.")
(defcustom encrypt-password-cache-expiry 200
"Encryption password timeout.
When set, directly sets password-cache-expiry"
:type 'integer
:group 'encrypt
:set (lambda (symbol value)
(set symbol value)
(setq password-cache-expiry value)))
(defcustom encrypt-file-alist nil
"List of file names or regexes matched with encryptions.
Format example:
'((\"beta\"
(gpg \"AES\"))
(\"/home/tzz/alpha\"
(encrypt-xor \"Semi-Secret\")))"
:type '(repeat
(list :tag "Encryption entry"
(radio :tag "What to encrypt"
(file :tag "Filename")
(regexp :tag "Regular expression match"))
(radio :tag "How to encrypt it"
(list
:tag "GPG Encryption"
(const :tag "GPG Program" gpg)
(radio :tag "Choose a cipher"
(const :tag "3DES Encryption" "3DES")
(const :tag "CAST5 Encryption" "CAST5")
(const :tag "Blowfish Encryption" "BLOWFISH")
(const :tag "AES Encryption" "AES")
(const :tag "AES192 Encryption" "AES192")
(const :tag "AES256 Encryption" "AES256")
(const :tag "Twofish Encryption" "TWOFISH")
(string :tag "Cipher Name")))
(list
:tag "Built-in simple XOR"
(const :tag "XOR Encryption" encrypt-xor)
(string :tag "XOR Cipher Value (seed value)")))))
:group 'encrypt)
;; TODO: now, load gencrypt.el and if successful, modify the
;; custom-type of encrypt-file-alist to add the gencrypt.el options
;; (plist-get (symbol-plist 'encrypt-file-alist) 'custom-type)
;; then use plist-put
(defcustom encrypt-gpg-path (executable-find "gpg")
"Path to the GPG program."
:type '(radio
(file :tag "Location of the GPG executable")
(const :tag "GPG is not installed" nil))
:group 'encrypt)
(defvar encrypt-temp-prefix "encrypt"
"Prefix for temporary filenames")
;;;###autoload
(defun encrypt-find-model (filename)
"Given a filename, find a encrypt-file-alist entry"
(dolist (entry encrypt-file-alist)
(let ((match (nth 0 entry))
(model (nth 1 entry)))
(when (or (eq match filename)
(string-match match filename))
(return model)))))
;;;###autoload
(defun encrypt-insert-file-contents (file &optional model)
"Decrypt FILE into the current buffer."
(interactive "fFile to insert: ")
(let* ((model (or model (encrypt-find-model file)))
(method (nth 0 model))
(cipher (nth 1 model))
(password-key (format "encrypt-password-%s-%s %s"
(symbol-name method) cipher file))
(passphrase
(password-read-and-add
(format "%s password for cipher %s? "
(symbol-name method) cipher)
password-key))
(buffer-file-coding-system 'binary)
(coding-system-for-read 'binary)
outdata)
;; note we only insert-file-contents if the method is known to be valid
(cond
((eq method 'gpg)
(insert-file-contents file)
(setq outdata (encrypt-gpg-decode-buffer passphrase cipher)))
((eq method 'encrypt-xor)
(insert-file-contents file)
(setq outdata (encrypt-xor-decode-buffer passphrase cipher))))
(if outdata
(progn
(gnus-message 9 "%s was decrypted with %s (cipher %s)"
file (symbol-name method) cipher)
(delete-region (point-min) (point-max))
(goto-char (point-min))
(insert outdata))
;; the decryption failed, alas
(password-cache-remove password-key)
(gnus-error 5 "%s was NOT decrypted with %s (cipher %s)"
file (symbol-name method) cipher))))
(defun encrypt-get-file-contents (file &optional model)
"Decrypt FILE and return the contents."
(interactive "fFile to decrypt: ")
(with-temp-buffer
(encrypt-insert-file-contents file model)
(buffer-string)))
(defun encrypt-put-file-contents (file data &optional model)
"Encrypt the DATA to FILE, then continue normally."
(with-temp-buffer
(insert data)
(encrypt-write-file-contents file model)))
(defun encrypt-write-file-contents (file &optional model)
"Encrypt the current buffer to FILE, then continue normally."
(interactive "fFile to write: ")
(let* ((model (or model (encrypt-find-model file)))
(method (nth 0 model))
(cipher (nth 1 model))
(password-key (format "encrypt-password-%s-%s %s"
(symbol-name method) cipher file))
(passphrase
(password-read
(format "%s password for cipher %s? "
(symbol-name method) cipher)
password-key))
outdata)
(cond
((eq method 'gpg)
(setq outdata (encrypt-gpg-encode-buffer passphrase cipher)))
((eq method 'encrypt-xor)
(setq outdata (encrypt-xor-encode-buffer passphrase cipher))))
(if outdata
(progn
(gnus-message 9 "%s was encrypted with %s (cipher %s)"
file (symbol-name method) cipher)
(delete-region (point-min) (point-max))
(goto-char (point-min))
(insert outdata)
;; do not confirm overwrites
(write-file file nil))
;; the decryption failed, alas
(password-cache-remove password-key)
(gnus-error 5 "%s was NOT encrypted with %s (cipher %s)"
file (symbol-name method) cipher))))
(defun encrypt-xor-encode-buffer (passphrase cipher)
(encrypt-xor-process-buffer passphrase cipher t))
(defun encrypt-xor-decode-buffer (passphrase cipher)
(encrypt-xor-process-buffer passphrase cipher nil))
(defun encrypt-xor-process-buffer (passphrase
cipher
&optional encode)
"Given PASSPHRASE, xor-encode or decode the contents of the current buffer."
(let* ((bs (buffer-substring-no-properties (point-min) (point-max)))
;; passphrase-sum is a simple additive checksum of the
;; passphrase and the cipher
(passphrase-sum
(when (stringp passphrase)
(apply '+ (append cipher passphrase nil))))
new-list)
(with-temp-buffer
(if encode
(progn
(dolist (x (append bs nil))
(setq new-list (cons (logxor x passphrase-sum) new-list)))
(dolist (x new-list)
(insert (format "%d " x))))
(progn
(setq new-list (reverse (split-string bs)))
(dolist (x new-list)
(setq x (string-to-int x))
(insert (format "%c" (logxor x passphrase-sum))))))
(buffer-substring-no-properties (point-min) (point-max)))))
(defun encrypt-gpg-encode-buffer (passphrase cipher)
(encrypt-gpg-process-buffer passphrase cipher t))
(defun encrypt-gpg-decode-buffer (passphrase cipher)
(encrypt-gpg-process-buffer passphrase cipher nil))
(defun encrypt-gpg-process-buffer (passphrase
cipher
&optional encode)
"With PASSPHRASE, use GPG to encode or decode the current buffer."
(let* ((program encrypt-gpg-path)
(input (buffer-substring-no-properties (point-min) (point-max)))
(temp-maker (if (fboundp 'make-temp-file)
'make-temp-file
'make-temp-name))
(temp-file (funcall temp-maker encrypt-temp-prefix))
(default-enable-multibyte-characters nil)
(args `("--cipher-algo" ,cipher
"--status-fd" "2"
"--logger-fd" "2"
"--passphrase-fd" "0"
"--no-tty"))
exit-status exit-data)
(when encode
(setq args
(append args
'("--symmetric"
"--armor"))))
(if program
(with-temp-buffer
(when passphrase
(insert passphrase "\n"))
(insert input)
(setq exit-status
(apply #'call-process-region (point-min) (point-max) program
t `(t ,temp-file) nil args))
(if (equal exit-status 0)
(setq exit-data
(buffer-substring-no-properties (point-min) (point-max)))
(with-temp-buffer
(when (file-exists-p temp-file)
(insert-file-contents temp-file))
(gnus-error 5 (format "%s exited abnormally: '%s' [%s]"
program exit-status (buffer-string)))))
(delete-file temp-file))
(gnus-error 5 "GPG is not installed."))
exit-data))
(provide 'encrypt)
;;; encrypt.el ends here
;; arch-tag: d907e4f1-71b5-42b1-a180-fc7b84ff0648
- 1 participants
- 0 comments
[PATCH COMMIT] mail-lib
20 years, 1 month
Simon Josefsson
Simon Josefsson
2004-11-29 Simon Josefsson <jas(a)extundo.com>
* netrc.el: Use encrypt.el from ecrypto, instead of gnus-encrypt.
Sync with Gnus CVS.
--- netrc.el 29 Nov 2004 22:57:05 +0100 1.2
+++ netrc.el 29 Nov 2004 22:57:14 +0100
＠＠ -34,10 +34,10 ＠＠
;;; .netrc and .authinfo rc parsing
;;;
-;; autoload gnus-encrypt
+;; autoload encrypt
(eval-and-compile
- (autoload 'gnus-encrypt-find-model "gnus-encrypt")
- (autoload 'gnus-encrypt-insert-file-contents "gnus-encrypt"))
+ (autoload 'encrypt-find-model "encrypt")
+ (autoload 'encrypt-insert-file-contents "encrypt"))
(defgroup netrc nil
"Netrc configuration.")
＠＠ -53,11 +53,11 ＠＠
(let ((tokens '("machine" "default" "login"
"password" "account" "macdef" "force"
"port"))
- (encryption-model (gnus-encrypt-find-model file))
+ (encryption-model (encrypt-find-model file))
alist elem result pair)
(if encryption-model
- (gnus-encrypt-insert-file-contents file encryption-model)
+ (encrypt-insert-file-contents file encryption-model)
(insert-file-contents file))
(goto-char (point-min))
＠＠ -131,6 +131,26 ＠＠
(pop result))
(car result))))
+(defun netrc-machine-user-or-password (mode authinfo-file-or-list machines ports defaults)
+ "Get the user name or password according to MODE from AUTHINFO-FILE-OR-LIST.
+Matches a machine from MACHINES and a port from PORTS, giving
+default ports DEFAULTS to `netrc-machine'.
+
+MODE can be \"login\" or \"password\", suitable for passing to
+`netrc-get'."
+ (let ((authinfo-list (if (stringp authinfo-file-or-list)
+ (netrc-parse authinfo-file-or-list)
+ authinfo-file-or-list))
+ (ports (or ports '(nil)))
+ (defaults (or defaults '(nil)))
+ info)
+ (dolist (machine machines)
+ (dolist (default defaults)
+ (dolist (port ports)
+ (let ((alist (netrc-machine authinfo-list machine port default)))
+ (setq info (or (netrc-get alist mode) info))))))
+ info))
+
(defun netrc-get (alist type)
"Return the value of token TYPE from ALIST."
(cdr (assoc type alist)))
- 1 participants
- 0 comments
[C] xlib/xwem 2.0 rc2 import
20 years, 1 month
Zajcev Evgeny
Zajcev Evgeny
xlib and xwem packages has been updated to 2.0rc2 - current version.
--
lg
- 1 participants
- 0 comments
[S pkg] general-docs: fontconfig (Xft-related) documentation
20 years, 1 month
Stephen J. Turnbull
Stephen J. Turnbull
SUPERSEDES PACKAGES general-docs
Hey, at this pace I'll be in the megapatch class by Christmas!
The questions in the original patch about the organization of this
package (xemacs/packages vs along license lines, etc) still stand.
Index: xemacs-packages/general-docs/ChangeLog
===================================================================
RCS file: /Users/steve/Software/Repositories/cvs.xemacs.org/XEmacs/packages/xemacs-packages/general-docs/ChangeLog,v
retrieving revision 1.9
diff -u -r1.9 ChangeLog
--- xemacs-packages/general-docs/ChangeLog 2003/10/31 16:52:56 1.9
+++ xemacs-packages/general-docs/ChangeLog 2004/11/26 15:30:08
＠＠ -1,3 +1,66 ＠＠
+2004-11-27 Stephen J. Turnbull <stephen(a)xemacs.org>
+
+ * texi/xemacs/fontconfig.texi (Constants): New node.
+ (The fontconfig API):
+ (Data Types):
+ Adjust node pointers for new node Constants.
+ (Font Properties): Move table to Constants.
+
+ (FcLangSet): New node.
+ (Functions):
+ (FcObjectType):
+ (Querying Fonts and Their Properties):
+ Update node pointers for new node FcLangSet.
+
+ (Querying Fonts and Their Properties):
+ Clarify description of FcFontList.
+
+ (FcPattern): Use mnemonic id instead of n in prototypes of
+ FcPatternGetTYPE functions.
+
+ (Overview): Specify the version of fontconfig described.
+
+ (FcFontSet):
+ (FcValue):
+ Add entries for debug print functions.
+
+ (Data Types): Document FcMatchKind, FcLangResult, FcSetName, FcEndian.
+
+ (FcObjectType): Get rid of extraneous semicolon.
+
+2004-11-22 Stephen J. Turnbull <stephen(a)xemacs.org>
+
+ * texi/xemacs/fontconfig.texi (FcObjectType):
+ (Querying Fonts and Their Properties):
+ (Initialization):
+ Split FcObjectType into FcObjectType and Querying Fonts and Their
+ Properties. Reorganize functions in Querying. Move descriptions
+ of FcConfigFilename, FcConfigCreate, FcConfigDestroy,
+ FcConfigSetCurrent, FcConfigGetCurrent, FcConfigUptoDate,
+ FcConfigBuildFonts, FcConfigGetConfigDirs, FcConfigGetFontDirs,
+ FcConfigGetConfigFiles, FcConfigGetCache, FcConfigGetFonts,
+ FcConfigGetBlanks, FcConfigGetRescanInverval,
+ FcConfigSetRescanInverval, FcConfigAppFontAddFile,
+ FcConfigAppFontAddDir, and FcConfigAppFontClear into Initialization.
+ (FcObjectType):
+ (Functions):
+ (Initialization):
+ (Top):
+ Update pointers for Querying Fonts and Their Properties.
+
+ (Querying Fonts and Their Properties):
+ (FcObjectSet):
+ Fix typos.
+
+ (Functions):
+ (Top):
+ Fix capitalization and whitespace of menus.
+
+2004-11-21 Stephen J. Turnbull <stephen(a)xemacs.org>
+
+ * texi/xemacs/fontconfig.texi: Add file.
+ * Makefile (EXPLICIT_DOCS): Add fontconfig.texi.
+
2003-10-31 Norbert Koch <viteno(a)xemacs.org>
* Makefile (VERSION): XEmacs package 1.01 released.
Index: xemacs-packages/general-docs/Makefile
===================================================================
RCS file: /Users/steve/Software/Repositories/cvs.xemacs.org/XEmacs/packages/xemacs-packages/general-docs/Makefile,v
retrieving revision 1.9
diff -u -r1.9 Makefile
--- xemacs-packages/general-docs/Makefile 2003/10/31 16:52:56 1.9
+++ xemacs-packages/general-docs/Makefile 2004/11/26 07:03:03
＠＠ -27,5 +27,6 ＠＠
# We'll need something like this.
#EXPLICIT_DOCS = texi/*.texi texi/xemacs/*.texi texi/packages/*.texi
+EXPLICIT_DOCS = texi/xemacs/fontconfig.texi
include ../../XEmacs.rules
Index: xemacs-packages/general-docs/texi/xemacs/fontconfig.texi
===================================================================
RCS file: fontconfig.texi
diff -N fontconfig.texi
--- /dev/null Mon Nov 29 17:56:41 2004
+++ xemacs-packages/general-docs/texi/xemacs/fontconfig.texi Mon Nov 29 17:55:19 2004
＠＠ -0,0 +1,2007 ＠＠
+\input texinfo.tex
+＠c %**start of header
+＠setfilename ../../info/fontconfig.info
+＠settitle Fontconfig: Font configuration and customization library
+
+＠set synched-to-pkg-version 1.0
+＠set synched-to-doc-versions Package: ＠value{synched-to-package-version}
+＠set last-released-month-year October 2003
+＠set last-released-date 20 October 2003
+
+＠footnotestyle separate
+＠paragraphindent 2
+＠c %**end of header
+
+＠dircategory Permissively licensed documentation
+＠direntry
+* fontconfig:: Managing font metainformation.
+＠end direntry
+
+＠setchapternewpage odd
+
+＠shorttitlepage Fontconfig
+
+＠titlepage
+＠title Fontconfig
+＠subtitle Font configuration and customization library
+＠subtitle A Rendering-Engine-Independent Library
+＠subtitle for Managing Font Metainformation
+
+＠author Keith Packard
+＠author Stephen J. Turnbull
+
+＠end titlepage
+
+＠ifinfo
+＠node Top, Copying, (dir), (dir)
+＠top Fontconfig
+
+This file documents fontconfig, a rendering-engine-independent library
+for managing font metainformation (＠emph{i.e.}, everything but the glyph
+data themselves). It is ＠emph{not} part of XEmacs.
+
+Copyright © 2002 Keith Packard, member of The XFree86 Project, Inc.
+Copyright © 2003 Stephen J. Turnbull, member of the XEmacs Project
+
+In the following notice, the term "Authors" refers to the copyright
+holders listed above, and "Documentation" refers to this version of the
+documentation supplied by Keith Packard, as adapted to Texinfo by
+Stephen J. Turnbull. The fontconfig library itself and the original
+documentation are covered by a similar license.
+
+Permission to use, copy, modify, distribute, and sell this Documentation
+for any purpose is hereby granted without fee, provided that the above
+copyright notice appear in all copies and that both that copyright
+notice and this permission notice appear in copies of the Documentation,
+and that the names of the Authors not be used in advertising or
+publicity pertaining to distribution of the Documentation without
+specific, written prior permission. The Authors make no representations
+about the suitability of this Documentation for any purpose. It is
+provided "as is" without express or implied warranty.
+
+THE AUTHORS DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS DOCUMENTATION,
+INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
+EVENT SHALL THE AUTHORS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
+CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
+DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
+TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS DOCUMENTATION.
+
+＠c I believe that this document can legally be distributed under the
+＠c above permission. rms's opinion is that there is nothing left of
+＠c `texinfo.tex' after processing this document, and therefore nothing
+＠c forces this document to be distributed under GPL.
+
+＠c The original permissively licensed document may be obtained in
+＠c distributions of the fontconfig library available from the CVS
+＠c repository of the XFree86 Project in module xc/extra/fontconfig.
+
+＠end ifinfo
+
+＠menu
+* Copying::
+* Overview::
+* The fontconfig API::
+* Configuration File Format::
+* Files::
+* Authors::
+
+＠detailmenu
+ --- The Detailed Node Listing ---
+
+Overview
+
+* Font Configuration::
+* Font Properties::
+* Font Matching::
+* Font List Matching::
+* Font Names::
+* LANG Tags::
+
+The fontconfig API
+
+* Data Types::
+* Functions::
+
+Functions
+
+* FcMatrix::
+* FcCharSet::
+* FcValue::
+* FcPattern::
+* FcFontSet::
+* FcObjectSet::
+* FcObjectType::
+* Querying Fonts and Their Properties::
+* Initialization::
+* FcAtomic::
+* FreeType-Specific Functions::
+* XML-Specific Functions::
+* File and Directory Routines::
+* FcStrSet and FcStrList::
+* String Utilities::
+
+Configuration File Format
+
+* Example System Configuration File::
+* Example User Configuration File::
+
+＠end detailmenu
+＠end menu
+
+＠node Copying, Overview, Top, Top
+＠chapter Copying
+
+The fontconfig library and the accompanying documentation are covered by
+the following copyright notice and license, except for this Texinfo
+version which has additional authors but is otherwise substantially the
+same.
+
+Copyright © 2002 Keith Packard, member of The XFree86 Project, Inc.
+
+Permission to use, copy, modify, distribute, and sell this software and its
+documentation for any purpose is hereby granted without fee, provided that
+the above copyright notice appear in all copies and that both that
+copyright notice and this permission notice appear in supporting
+documentation, and that the name of Keith Packard not be used in
+advertising or publicity pertaining to distribution of the software without
+specific, written prior permission. Keith Packard makes no
+representations about the suitability of this software for any purpose. It
+is provided "as is" without express or implied warranty.
+
+KEITH PACKARD DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
+INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
+EVENT SHALL KEITH PACKARD BE LIABLE FOR ANY SPECIAL, INDIRECT OR
+CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
+DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
+TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+
+＠node Overview, The fontconfig API, Copying, Top
+＠chapter Overview
+
+＠c DESCRIPTION
+Fontconfig is a library designed to provide system-wide font
+configuration, customization and application access.
+
+This manual describes fontconfig version 1.0.2.
+
+＠c FUNCTIONAL OVERVIEW
+Fontconfig contains two essential modules, the configuration module which
+builds an internal configuration from XML files and the matching module
+which accepts font patterns and returns the nearest matching font.
+
+＠menu
+* Font Configuration::
+* Font Properties::
+* Font Matching::
+* Font List Matching::
+* Font Names::
+* LANG Tags::
+＠end menu
+
+＠node Font Configuration, Font Properties, Overview, Overview
+＠section Font Configuration
+
+The configuration module consists of the FcConfig datatype, libexpat and
+FcConfigParse which walks over an XML tree and amends a configuration with
+data found within. From an external perspective, configuration of the
+library consists of generating a valid XML tree and feeding that to
+FcConfigParse. The only other mechanism provided to applications for
+changing the running configuration is to add fonts and directories to the
+list of application-provided font files.
+
+The intent is to make font configurations relatively static, and shared by
+as many applications as possible. It is hoped that this will lead to more
+stable font selection when passing names from one application to another.
+XML was chosen as a configuration file format because it provides a format
+which is easy for external agents to edit while retaining the correct
+structure and syntax.
+
+Font configuration is separate from font matching; applications needing to
+do their own matching can access the available fonts from the library and
+perform private matching. The intent is to permit applications to pick and
+choose appropriate functionality from the library instead of forcing them to
+choose between this library and a private configuration mechanism. The hope
+is that this will ensure that configuration of fonts for all applications
+can be centralized in one place. Centralizing font configuration will make
+simplify and regularize font installation and customization.
+
+＠node Font Properties, Font Matching, Font Configuration, Overview
+＠section Font Properties
+
+While font patterns may contain essentially any properties, there are some
+well known properties with associated types. Fontconfig uses some of these
+properties for font matching and font completion. Others are provided as a
+convenience for the applications rendering mechanism. Some symbolic
+constants are provided for common values or enumerated types.
+＠xref{Constants}, for the list of standard properties and values.
+
+
+＠node Font Matching, Font List Matching, Font Properties, Overview
+＠section Font Matching
+
+Fontconfig performs matching by measuring the distance from a provided
+pattern to all of the available fonts in the system. The closest matching
+font is selected. This ensures that a font will always be returned, but
+doesn't ensure that it is anything like the requested pattern.
+
+Font matching starts with an application constructed pattern. The desired
+attributes of the resulting font are collected together in an FcPattern
+object. Each property of the pattern can contain one or more values; these
+are listed in priority order; matches earlier in the list are considered
+"closer" than matches later in the list.
+
+The initial pattern is modified by applying the list of editing instructions
+specific to patterns found in the configuration; each consists of a match
+predicate and a set of editing operations. They are executed in the order
+they appeared in the configuration. Each match causes the associated
+sequence of editing operations to be applied.
+
+After the pattern has been edited, a sequence of default substitutions are
+performed to canonicalize the set of available properties; this avoids the
+need for the lower layers to constantly provide default values for various
+font properties during rendering.
+
+The canonical font pattern is finally matched against all available fonts.
+The distance from the pattern to the font is measured for each of several
+properties: foundry, charset, family, lang, spacing, pixelsize, style,
+slant, weight, antialias, rasterizer and outline. This list is in priority
+order---results of comparing earlier elements of this list weigh more
+heavily than later elements.
+
+There is one special case to this rule; family names are split into two
+bindings; strong and weak. Strong family names are given greater precedence
+in the match than lang elements while weak family names are given lower
+precedence than lang elements. This permits the document language to drive
+font selection when any document specified font is unavailable.
+
+The pattern representing that font is augmented to include any properties
+found in the pattern but not found in the font itself; this permits the
+application to pass rendering instructions or any other data through the
+matching system. Finally, the list of editing instructions specific to
+fonts found in the configuration are applied to the pattern. This modified
+pattern is returned to the application.
+
+The return value contains sufficient information to locate and rasterize the
+font, including the file name, pixel size and other rendering data. As
+none of the information involved pertains to the FreeType library,
+applications are free to use any rasterization engine or even to take
+the identified font file and access it directly.
+
+The match/edit sequences in the configuration are performed in two passes
+because there are essentially two different operations necessary -- the
+first is to modify how fonts are selected; aliasing families and adding
+suitable defaults. The second is to modify how the selected fonts are
+rasterized. Those must apply to the selected font, not the original pattern
+as false matches will often occur.
+
+＠node Font List Matching, Font Names, Font Matching, Overview
+＠section Font List Matching
+
+While many applications want to locate a single font best matching their
+search criteria, other applications need to build a set of fonts which can
+be used to present any Unicode data. Fontconfig provides an API to generate
+a list sorted by the nearness of each font to the pattern. Every font in
+the system is considered, the best matching fonts are placed first. The
+application then can select whether the remaining fonts are unconditionally
+included in the list, or whether they are included only if they cover
+portions of Unicode not covered by any of the preceeding fonts.
+
+The list resulting from this match is represented by references to the
+original font patterns and so consumes very little memory. Using a list
+entry involves creating a pattern which combines the information from the
+font with the information from the original pattern and executing the font
+substitutions.
+
+＠node Font Names, LANG Tags, Font List Matching, Overview
+＠section Font Names
+
+Fontconfig provides a textual representation for patterns that the library
+can both accept and generate. The representation is in three parts, first a
+list of family names, second a list of point sizes and finally a list of
+additional properties:
+
+＠example
+ <families>-<point sizes>:<name1>=<values1>:<name2>=<values2>...
+＠end example
+
+Values in a list are separated with commas. A hyphen or comma in a family
+name must be escaped with a backslash. The name needn't include either
+families or point sizes; they can be elided. If the family name only is
+given, the hyphen may be omitted. If there are no additional properties,
+no trailing colon should be used. In addition, there are
+symbolic constants that simultaneously indicate both a name and a value.
+Here are some examples:
+
+＠example
+Times-12 12 point Times Roman
+Times-12:bold 12 point Times Bold
+Courier:italic Courier Italic in the default size
+Monospace:matrix=1 .1 0 1 The users preferred monospace font
+ with artificial obliquing
+Mikachan\-PB-16 12 point Mikachan-PB
+＠end example
+
+＠node LANG Tags, , Font Names, Overview
+＠section LANG Tags
+
+Each font in the database contains a list of languages it supports. This is
+computed by comparing the Unicode coverage of the font with the orthography
+of each language. Languages are tagged using an RFC-3066 compatible naming
+and occur in two parts -- the ISO639 language tag followed a hyphen and then
+by the ISO 3166 country code. The hyphen and country code may be elided.
+
+Fontconfig has orthographies for several languages built into the library.
+No provision has been made for adding new ones aside from rebuilding the
+library. It currently supports 122 of the 139 languages named in ISO 639-1,
+141 of the languages with two-letter codes from ISO 639-2 and another 30
+languages with only three-letter codes.
+
+＠node The fontconfig API, Configuration File Format, Overview, Top
+＠chapter The fontconfig API
+
+＠example
+#include <fontconfig/fontconfig.h>
+#include <fontconfig/fcfreetype.h>
+＠end example
+
+＠menu
+* Constants::
+* Data Types::
+* Functions::
+＠end menu
+
+＠node Constants, Data Types, The fontconfig API, The fontconfig API
+
+While fontconfig is designed to be extensible, it provides a comprehensive
+set of standard properties and values for fonts.
+
+The following table gives the list of standard font properties. The property
+name is represented as a string. In C code a C preprocessor symbol may be
+used to help with typo detection.
+
+＠example
+Property CPP symbol Type Description
+
+family FC_FAMILY String Font family name
+style FC_STYLE String Font style. Overrides weight and slant
+slant FC_SLANT Int Italic, oblique or roman
+weight FC_WEIGHT Int Light, medium, demibold, bold or black
+size FC_SIZE Double Point size
+aspect FC_ASPECT Double Stretch glyphs horizontally, then hint
+pixelsize FC_PIXEL_SIZE Double Pixel size
+spacing FC_SPACING Int Proportional, monospace or charcell
+foundry FC_FOUNDRY String Font foundry name
+antialias FC_ANTIALIAS Bool Should glyphs be antialiased?
+hinting FC_HINTING Bool Should the rasterizer use hinting?
+verticallayout FC_VERTICAL_LAYOUT Bool Use vertical layout
+autohint FC_AUTOHINT Bool Use autohinter instead of normal hinter
+globaladvance FC_GLOBAL_ADVANCE Bool Use font global advance data
+file FC_FILE String The filename holding the font
+index FC_INDEX Int The index of the font within the file
+ftface FC_FT_FACE FT_Face Use the specified FreeType face object
+rasterizer FC_RASTERIZER String Which rasterizer is in use
+outline FC_OUTLINE Bool Whether the glyphs are outlines
+scalable FC_SCALABLE Bool Whether glyphs can be scaled
+scale FC_SCALE Double Point->pixel conversion scale factor
+dpi FC_DPI Double Target dots per inch
+rgba FC_RGBA Int unknown, rgb, bgr, vrgb, vbgr, none
+ - subpixel geometry
+source FC_SOURCE String X11, freetype
+minspace FC_MINSPACE Bool Eliminate leading from line spacing
+charset FC_CHARSET CharSet Unicode chars encoded by the font
+lang FC_LANG String List of RFC-3066-style languages
+ this font supports
+fontversion FC_FONTVERSION Int From 'head' table
+＠end example
+
+C code can check the fontconfig version number with the numerical
+preprocessor constants ＠code{FC_MAJOR}, ＠code{FC_MINOR}, and
+＠code{FC_REVISION}, or use the combined constant ＠code{FC_VERSION}, defined
+as ＠code{FC_MAJOR*10000 + FC_MINOR*100 + FC_REVISION}.
+
+The cache version (format of ＠file{font.cache-1}?) is given by
+＠code{FC_CACHE_VERSION}, and is a string, not an integer. The cache file
+names are defined as ＠code{FC_DIR_CACHE_FILE} and ＠code{FC_USER_CACHE_FILE}.
+
+The Boolean constants are ＠code{FcFalse} (0) and ＠code{FcTrue} (1).
+
+Properties used to control the rasterizer, their preprocessor constants, and
+their types, include:
+
+＠example
+charwidth FC_CHAR_WIDTH Int
+charheight FC_CHAR_HEIGHT Int
+matrix FC_MATRIX FcMatrix
+＠end example
+
+Preprocessor constants are defined for common standard font weights. All are
+Ints.
+
+＠example
+FC_WEIGHT_LIGHT 0
+FC_WEIGHT_MEDIUM 100
+FC_WEIGHT_DEMIBOLD 180
+FC_WEIGHT_BOLD 200
+FC_WEIGHT_BLACK 210
+＠end example
+
+Preprocessor constants are defined for common standard slants. All are Ints.
+
+＠example
+FC_SLANT_ROMAN 0
+FC_SLANT_ITALIC 100
+FC_SLANT_OBLIQUE 110
+＠end example
+
+Preprocessor constants are defined for the three spacing types. All are
+Ints, but should be treated as symbolic constants.
+
+＠example
+FC_PROPORTIONAL 0
+FC_MONO 100
+FC_CHARCELL 110
+＠end example
+
+Preprocessor constants are defined for the subpixel orders. All are
+Ints, but should be treated as symbolic constants.
+
+＠example
+FC_RGBA_UNKNOWN 0
+FC_RGBA_RGB 1
+FC_RGBA_BGR 2
+FC_RGBA_VRGB 3
+FC_RGBA_VBGR 4
+FC_RGBA_NONE 5
+＠end example
+
+
+＠node Data Types, Functions, Constants, The fontconfig API
+＠section Data Types
+
+＠table ＠samp
+＠item FcChar8
+＠itemx FcChar16
+＠itemx FcChar32
+＠itemx FcBool
+These are primitive data types; the FcChar* types hold precisely the number
+of bits stated (if supported by the C implementation). FcBool holds
+one of two CPP symbols: FcFalse or FcTrue.
+
+＠item FcMatrix
+An FcMatrix holds an affine transformation, usually used to reshape glyphs.
+A small set of matrix operations are provided to manipulate these.
+
+＠example
+ typedef struct _FcMatrix ＠{
+ double xx, xy, yx, yy;
+ ＠} FcMatrix;
+＠end example
+
+＠item FcCharSet
+An FcCharSet is an abstract type that holds the set of encoded unicode chars
+in a font. Operations to build and compare these sets are provided.
+
+＠item FcType
+Tags the kind of data stored in an FcValue.
+
+＠item FcValue
+An FcValue object holds a single value with one of a number of different
+types. The 'type' tag indicates which member is valid.
+
+＠example
+ typedef struct _FcValue ＠{
+ FcType type;
+ union ＠{
+ const FcChar8 *s;
+ int i;
+ FcBool b;
+ double d;
+ const FcMatrix *m;
+ const FcCharSet *c;
+ void *f;
+ const FcPattern *p;
+ const FcLangSet *l;
+ ＠} u;
+ ＠} FcValue;
+＠end example
+
+＠example
+ type Union member Datatype
+
+ FcTypeVoid (none) (none)
+ FcTypeInteger i int
+ FcTypeDouble d double
+ FcTypeString s TcChar8 *
+ FcTypeBool b b
+ FcTypeMatrix m FcMatrix *
+ FcTypeCharSet c FcCharSet *
+ FcTypeFTFace f void *
+ p FcPattern *
+ FcTypeLangSet l FcLangSet *
+＠end example
+
+＠item FcPattern
+holds a set of names with associated value lists; each name refers to a
+property of a font. FcPatterns are used as inputs to the matching code as
+well as holding information about specific fonts. Each property can hold
+one or more values; conventionally all of the same type, although the
+interface doesn't demand that.
+
+＠item FcFontSet
+
+＠example
+ typedef struct _FcFontSet ＠{
+ int nfont;
+ int sfont;
+ FcPattern **fonts;
+ ＠} FcFontSet;
+＠end example
+
+An FcFontSet contains a list of FcPatterns. Internally fontconfig uses this
+data structure to hold sets of fonts. Externally, fontconfig returns the
+results of listing fonts in this format. 'nfont' holds the number of
+patterns in the 'fonts' array; 'sfont' is used to indicate the size of that
+array.
+
+＠item FcStrSet
+＠itemx FcStrList
+FcStrSet holds a list of strings that can be appended to and enumerated.
+Its unique characteristic is that the enumeration works even while strings
+are appended during enumeration. FcStrList is used during enumeration to
+safely and correctly walk the list of strings even while that list is edited
+in the middle of enumeration.
+
+＠item FcObjectSet
+
+＠example
+ typedef struct _FcObjectSet ＠{
+ int nobject;
+ int sobject;
+ const char **objects;
+ ＠} FcObjectSet;
+＠end example
+holds a set of names and is used to specify which fields from fonts are
+placed in the the list of returned patterns when listing fonts.
+
+＠item FcObjectType
+
+＠example
+ typedef struct _FcObjectType ＠{
+ const char *object;
+ FcType type;
+ ＠} FcObjectType;
+＠end example
+marks the type of a pattern element generated when parsing font names.
+Applications can add new object types so that font names may contain the new
+elements.
+
+＠item FcConstant
+
+＠example
+ typedef struct _FcConstant ＠{
+ const FcChar8 *name;
+ const char *object;
+ int value;
+ ＠} FcConstant;
+＠end example
+Provides for symbolic constants for new pattern elements. When 'name' is
+seen in a font name, an 'object' element is created with value 'value'.
+
+＠item FcBlanks
+holds a list of Unicode chars which are expected to be blank; unexpectedly
+blank chars are assumed to be invalid and are elided from the charset
+associated with the font.
+
+＠item FcFileCache
+holds the per-user cache information for use while loading the font
+database. This is built automatically for the current configuration when
+that is loaded. Applications must always pass '0' when one is requested.
+
+＠item FcConfig
+holds a complete configuration of the library; there is one default
+configuration, other can be constructed from XML data structures. All
+public entry points that need global data can take an optional FcConfig*
+argument; passing 0 uses the default configuration. FcConfig objects hold two
+sets of fonts, the first contains those specified by the configuration, the
+second set holds those added by the application at run-time. Interfaces
+that need to reference a particulat set use one of the FcSetName enumerated
+values.
+
+＠item FcSetName
+Specifies one of the two sets of fonts available in a configuration;
+FcSetSystem for those fonts specified in the configuration and
+FcSetApplication which holds fonts provided by the application.
+
+＠item FcResult
+Used as a return type for functions manipulating FcPattern objects.
+
+＠example
+Result code Meaning
+FcResultMatch Object exists with the specified ID
+FcResultNoMatch Object doesn't exist at all
+FcResultTypeMismatch Object exists, but the type doesn't match
+FcResultNoId Object exists, but has fewer values than specified
+＠end example
+
+＠item FcAtomic
+Used for locking access to config files. Provides a safe way to update
+configuration files.
+
+＠item FcMatchKind
+An enumeration containing ＠code{FcMatchPattern} and ＠code{FcMatchFont}.
+
+＠item FcLangResult
+An enumeration containing ＠code{FcLangEqual}, ＠code{FcLangDifferentCountry},
+and ＠code{FcLangDifferentLang}. Presumably ＠code{FcLangDifferentLang}
+implies ＠code{FcLangDifferentCountry}.
+
+＠item FcSetName
+An enumeration containing ＠code{FcSetSystem} and ＠code{FcSetApplication}.
+
+＠item FcEndian
+An enumeration containing ＠code{FcEndianBig} and ＠code{FcEndianLittle}.
+＠end table
+
+＠node Functions, , Data Types, The fontconfig API
+＠section Functions
+
+＠menu
+* FcMatrix::
+* FcCharSet::
+* FcValue::
+* FcPattern::
+* FcFontSet::
+* FcObjectSet::
+* FcObjectType::
+* FcLangSet::
+* Querying Fonts and Their Properties::
+* Initialization::
+* FcAtomic::
+* FreeType-Specific Functions::
+* XML-Specific Functions::
+* File and Directory Routines::
+* FcStrSet and FcStrList::
+* String Utilities::
+＠end menu
+
+＠node FcMatrix, FcCharSet, Functions, Functions
+＠subsection FcMatrix
+
+FcMatrix structures hold an affine transformation in matrix form.
+
+＠example
+#define FcMatrixInit(m) ((m)->xx = (m)->yy = 1, (m)->xy = (m)->yx = 0)
+＠end example
+Initializes a matrix to the identify transformation.
+
+＠deftypefun {FcMatrix *} FcMatrixCopy (const FcMatrix *＠var{mat})
+
+Allocates a new FcMatrix and copies 'mat' into it.
+＠end deftypefun
+
+＠deftypefun FcBool FcMatrixEqual (const FcMatrix *＠var{mat1}, const FcMatrix *var{mat2})
+
+Returns FcTrue if 'mat1' and 'mat2' are equal, else FcFalse.
+＠end deftypefun
+
+＠deftypefun void FcMatrixMultiply (FcMatrix *＠var{result}, const FcMatrix *＠var{a}, const FcMatrix *var{b})
+
+Multiplies 'a' and 'b' together, placing the result in 'result'. 'result'
+may refer to the sam matrix as either 'a' or 'b'.
+＠end deftypefun
+
+＠deftypefun void FcMatrixRotate (FcMatrix *m, double c, double s)
+
+If 'c' is cos(angle) and 's' is sin(angle), FcMatrixRotate rotates the
+matrix by 'angle'.
+＠end deftypefun
+
+＠deftypefun void FcMatrixScale (FcMatrix *m, double sx, double sy)
+
+Scales 'm' by 'sx' in the horizontal dimension and 'sy' in the
+vertical dimension.
+＠end deftypefun
+
+＠deftypefun void FcMatrixShear (FcMatrix *m, double sh, double sv)
+Shears 'm' by 'sh' in the horizontal direction and 'sv' in the
+vertical direction.
+＠end deftypefun
+
+＠node FcCharSet, FcValue, FcMatrix, Functions
+＠subsection FcCharSet
+
+An FcCharSet is a boolean array indicating a set of unicode chars. Those
+associated with a font are marked constant and cannot be edited.
+FcCharSets may be reference counted internally to reduce memory consumption;
+this may be visible to applications as the result of FcCharSetCopy may
+return its argument, and that CharSet may remain unmodifiable.
+
+＠deftypefun {FcCharSet *} FcCharSetCreate (void)
+
+Creates an empty FcCharSet object.
+＠end deftypefun
+
+＠deftypefun void FcCharSetDestroy (FcCharSet *fcs)
+
+Frees an FcCharSet object.
+＠end deftypefun
+
+＠deftypefun FcBool FcCharSetAddChar (FcCharSet *fcs, FcChar32 ucs4)
+
+Adds a single unicode char to the set, returning FcFalse on
+failure, either as a result of a constant set or from running out of memory.
+＠end deftypefun
+
+＠deftypefun {FcCharSet *} FcCharSetCopy (FcCharSet *src)
+
+Makes a copy of 'src'; note that this may not actually do anything more than
+increment the reference count on 'src'.
+＠end deftypefun
+
+＠deftypefun FcBool FcCharSetEqual (const FcCharSet *a, const FcCharSet *b)
+
+Returns whether 'a' and 'b' contain the same set of unicode chars.
+＠end deftypefun
+
+＠deftypefun {FcCharSet *} FcCharSetIntersect (const FcCharSet *a, const FcCharSet *b)
+
+Returns a set including only those chars found in both 'a' and 'b'.
+＠end deftypefun
+
+＠deftypefun {FcCharSet *} FcCharSetUnion (const FcCharSet *a, const FcCharSet *b);
+
+Returns a set including only those chars found in either 'a' or 'b'.
+＠end deftypefun
+
+＠deftypefun {FcCharSet *} FcCharSetSubtract (const FcCharSet *a, const FcCharSet *b)
+
+Returns a set including only those chars found in 'a' but not 'b'.
+＠end deftypefun
+
+＠deftypefun FcBool FcCharSetHasChar (const FcCharSet *fcs, FcChar32 ucs4)
+
+Returns whether 'fcs' contains the char 'ucs4'.
+＠end deftypefun
+
+＠deftypefun FcChar32 FcCharSetCount (const FcCharSet *a)
+
+Returns the total number of unicode chars in 'a'.
+＠end deftypefun
+
+＠deftypefun FcChar32 FcCharSetIntersectCount (const FcCharSet *a, const FcCharSet *b)
+
+Returns the number of chars that are in both 'a' and 'b'.
+＠end deftypefun
+
+＠deftypefun FcChar32 FcCharSetSubtractCount (const FcCharSet *a, const FcCharSet *b)
+
+Returns the number of chars that are in 'a' but not in 'b'.
+＠end deftypefun
+
+＠deftypefun FcBool FcCharSetIsSubset (const FcCharSet *a, const FcCharSet *b)
+
+Returns whether 'a' is a subset of 'b'.
+＠end deftypefun
+
+＠deftypefun FcChar32 FcCharSetFirstPage (const FcCharSet *a, FcChar32 [FC_CHARSET_MAP_SIZE], FcChar32 *next)
+
+Builds an array of bits marking the first page of Unicode coverage of 'a'.
+Returns the base of the array. 'next' contains the next page in the font.
+＠end deftypefun
+
+＠deftypefun FcChar32 FcCharSetNextPage (const FcCharSet *a, FcChar32 [FC_CHARSET_MAP_SIZE], FcChar32 *next)
+
+Builds an array of bits marking the Unicode coverage of 'a' for page '*next'.
+Returns the base of the array. 'next' contains the next page in the font.
+＠end deftypefun
+
+＠node FcValue, FcPattern, FcCharSet, Functions
+＠subsection FcValue
+
+FcValue is a structure containing a type tag and a union of all possible
+data types. The tag is an enum of type FcType and is intended to provide
+a measure of run-time typechecking, although that depends on careful
+programming.
+
+＠deftypefun void FcValueDestroy (FcValue v)
+
+Frees any memory referenced by `v'. Values of type FcTypeString,
+FcTypeMatrix and FcTypeCharSet reference memory, the other types do not.
+＠end deftypefun
+
+＠deftypefun FcValue FcValueSave (FcValue v)
+
+Returns a copy of `v' duplicating any object referenced by it so that `v'
+may be safely destroyed without harming the new value.
+＠end deftypefun
+
+＠deftypefun void FcValuePrint (const FcValue v)
+
+Prints an easily readable version of the value to stdout. There is
+no provision for reparsing data in this format, it's just for diagnostics
+and debugging.
+＠end deftypefun
+
+
+＠node FcPattern, FcFontSet, FcValue, Functions
+＠subsection FcPattern
+
+An FcPattern is an opaque type that holds both patterns to match against the
+available fonts, as well as the information about each font.
+
+＠deftypefun {FcPattern *} FcPatternCreate (void)
+
+Creates a pattern with no properties; used to build patterns from scratch.
+＠end deftypefun
+
+＠deftypefun void FcPatternDestroy (FcPattern *p)
+
+Destroys a pattern, in the process destroying all related values.
+＠end deftypefun
+
+＠deftypefun FcBool FcPatternEqual (const FcPattern *pa, const FcPattern *pb);
+
+Returns whether 'pa' and 'pb' are exactly alike.
+＠end deftypefun
+
+＠deftypefun FcBool FcPatternEqualSubset (const FcPattern *pa, const FcPattern *pb, const FcObjectSet *os)
+
+Returns whether 'pa' and 'pb' have exactly the same values for all of the
+objects in 'os'.
+＠end deftypefun
+
+＠deftypefun FcChar32 FcPatternHash (const FcPattern *p)
+
+Returns a 32-bit number which is the same for any two patterns which are
+exactly alike.
+＠end deftypefun
+
+＠deftypefun FcBool FcPatternAdd (FcPattern *p, const char *object, FcValue value, FcBool append)
+
+Adds a single value to the list of values associated with the property named
+`object'. If `append' is FcTrue, the value is added at the end of any
+existing list, otherwise it is inserted at the begining. `value' is saved
+(with FcValueSave) when inserted into the pattern so that the library
+retains no reference to any application-supplied data structure.
+＠end deftypefun
+
+＠deftypefun FcBool FcPatternAddWeak (FcPattern *p, const char *object, FcValue value, FcBool append)
+
+FcPatternAddWeak is essentially the same as FcPatternAdd except that any
+values added to the list have binding 'weak' instead of 'strong'.
+＠end deftypefun
+
+＠deftypefun FcBool FcPatternAddInteger (FcPattern *p, const char *object, int i)
+＠deftypefunx FcBool FcPatternAddDouble (FcPattern *p, const char *object, double d)
+＠deftypefunx FcBool FcPatternAddString (FcPattern *p, const char *object, const char *s)
+＠deftypefunx FcBool FcPatternAddMatrix (FcPattern *p, const char *object, const FcMatrix *s)
+＠deftypefunx FcBool FcPatternAddCharSet (FcPattern *p, const char *object, const FcCharSet *c)
+＠deftypefunx FcBool FcPatternAddBool (FcPattern *p, const char *object, FcBool b)
+
+These are all convenience functions that insert objects of the specified
+type into the pattern. Use these in preference to FcPatternAdd as they
+will provide compile-time typechecking. These all append values to
+any existing list of values.
+＠end deftypefun
+
+＠deftypefun FcResult FcPatternGet (FcPattern *p, const char *object, int id, FcValue *v)
+
+Returns in `v' the `id'th value associated with the property `object'.
+The value returned is not a copy, but rather refers to the data stored
+within the pattern directly. Applications must not free this value.
+＠end deftypefun
+
+＠deftypefun FcResult FcPatternGetInteger (FcPattern *p, const char *object, int id, int *i);
+＠deftypefunx FcResult FcPatternGetDouble (FcPattern *p, const char *object, int id, double *d);
+＠deftypefunx FcResult FcPatternGetString (FcPattern *p, const char *object, int id, char **const s);
+＠deftypefunx FcResult FcPatternGetMatrix (FcPattern *p, const char *object, int id, FcMatrix **s);
+＠deftypefunx FcResult FcPatternGetCharSet (FcPattern *p, const char *object, int id, FcCharSet **c);
+＠deftypefunx FcResult FcPatternGetBool (FcPattern *p, const char *object, int id, FcBool *b);
+
+These are convenience functions that call FcPatternGet and verify that the
+returned data is of the expected type. They return FcResultTypeMismatch if
+this is not the case. Note that these (like FcPatternGet) do not make a
+copy of any data structure referenced by the return value. Use these
+in preference to FcPatternGet to provide compile-time typechecking.
+＠end deftypefun
+
+＠deftypefun {FcPattern *} FcPatternBuild (FcPattern *orig, ...);
+＠deftypefunx FcPattern *FcPatternVaBuild (FcPattern *orig, va_list va)
+
+Builds a pattern using a list of objects, types and values. Each
+value to be entered in the pattern is specified with three arguments:
+＠enumerate
+＠item
+Object name, a string describing the property to be added.
+＠item
+Object type, one of the FcType enumerated values
+＠item
+Value, not an FcValue, but the raw type as passed to any of the
+FcPatternAdd<type> functions. Must match the type of the second
+argument.
+＠end enumerate
+
+The argument list is terminated by a null object name, no object type nor
+value need be passed for this. The values are added to `pattern', if
+`pattern' is null, a new pattern is created. In either case, the pattern is
+returned. Example:
+
+＠example
+pattern = FcPatternBuild (0, FC_FAMILY, FtTypeString, "Times", (char *) 0);
+＠end example
+
+FcPatternVaBuild is used when the arguments are already in the form of a
+varargs value.
+＠end deftypefun
+
+＠deftypefun FcBool FcPatternDel (FcPattern *p, const char *object)
+
+Deletes all values associated with the property `object', returning
+whether the property existed or not.
+＠end deftypefun
+
+＠deftypefun void FcPatternPrint (const FcPattern *p)
+
+Prints an easily readable version of the pattern to stdout. There is
+no provision for reparsing data in this format, it's just for diagnostics
+and debugging.
+＠end deftypefun
+
+＠deftypefun void FcDefaultSubstitute (FcPattern *pattern)
+
+Supplies default values for underspecified font patterns:
+＠itemize
+＠item
+Patterns without a specified style or weight are set to Medium
+＠item
+Patterns without a specified style or slant are set to Roman
+＠item
+Patterns without a specified pixel size are given one computed from
+any specified point size (default 12), dpi (default 75) and scale (default
+1).
+＠end itemize
+＠end deftypefun
+
+＠deftypefun {FcPattern *} FcNameParse (const char *name)
+
+Converts 'name' from the standard text format described above into a pattern.
+＠end deftypefun
+
+＠deftypefun FcChar8 *FcNameUnparse (FcPattern *pat)
+
+Converts the given pattern into the standard text format described above.
+The return value is not static, but instead refers to newly allocated memory
+which should be freed by the caller.
+＠end deftypefun
+
+＠node FcFontSet, FcObjectSet, FcPattern, Functions
+＠subsection FcFontSet
+
+An FcFontSet simply holds a list of patterns; these are used to return the
+results of listing available fonts.
+
+＠deftypefun FcFontSet *FcFontSetCreate (void)
+
+Creates an empty font set.
+＠end deftypefun
+
+＠deftypefun void FcFontSetDestroy (FcFontSet *s);
+
+Destroys a font set. Note that this destroys any referenced patterns as
+well.
+＠end deftypefun
+
+＠deftypefun FcBool FcFontSetAdd (FcFontSet *s, FcPattern *font)
+
+Adds a pattern to a font set. Note that the pattern is not copied before
+being inserted into the set.
+＠end deftypefun
+
+＠deftypefun void FcFontSetPrint (const FcFontSet *s)
+
+Prints an easily readable version of the font set to stdout. There is
+no provision for reparsing data in this format, it's just for diagnostics
+and debugging.
+＠end deftypefun
+
+
+＠node FcObjectSet, FcObjectType, FcFontSet, Functions
+＠subsection FcObjectSet
+
+An FcObjectSet holds a list of pattern property names; it is used to
+indicate which properties are to be returned in the patterns from
+FcFontList.
+
+＠deftypefun FcObjectSet *FcObjectSetCreate (void)
+
+Creates an empty set.
+＠end deftypefun
+
+＠deftypefun FcBool FcObjectSetAdd (FcObjectSet *os, const char *object)
+
+Adds a property name to the set.
+＠end deftypefun
+
+＠deftypefun void FcObjectSetDestroy (FcObjectSet *os)
+
+Destroys an object set.
+＠end deftypefun
+
+＠deftypefun FcObjectSet *FcObjectSetBuild (const char *first, ...)
+＠deftypefunx FcObjectSet *FcObjectSetVaBuild (const char *first, va_list va)
+
+These build an object set from a null-terminated list of property names.
+＠end deftypefun
+
+＠node FcObjectType, Querying Fonts and Their Properties, FcObjectSet, Functions
+＠subsection FcObjectType
+
+Provides for application-specified font name object types so that new
+pattern elements can be generated from font names.
+
+＠deftypefun FcBool FcNameRegisterObjectTypes (const FcObjectType *types, int ntype)
+
+Register 'ntype' new object types.
+＠end deftypefun
+
+＠deftypefun FcBool FcNameUnregisterObjectTypes (const FcObjectType *types, int ntype)
+
+Unregister 'ntype' object types.
+＠end deftypefun
+
+＠deftypefun const FcObjectType *FcNameGetObjectType (const char *object)
+
+Return the object type for the pattern element named 'object'.
+＠end deftypefun
+
+FcConstant
+
+Provides for application-specified symbolic constants for font names.
+
+＠deftypefun FcBool FcNameRegisterConstants (const FcConstant *consts, int nconsts)
+
+Register 'nconsts' new symbolic constants.
+＠end deftypefun
+
+＠deftypefun FcBool FcNameUnregisterConstants (const FcConstant *consts, int nconsts)
+
+Unregister 'nconsts' symbolic constants.
+＠end deftypefun
+
+＠deftypefun const FcConstant *FcNameGetConstant (FcChar8 *string)
+
+Return the FcConstant structure related to symbolic constant 'string'.
+＠end deftypefun
+
+＠deftypefun FcBool FcNameConstant (FcChar8 *string, int *result)
+
+Returns whether a symbolic constant with name 'string' is registered,
+placing the value of the constant in 'result' if present.
+＠end deftypefun
+
+
+＠node FcLangSet, Querying Fonts and Their Properties, FcObjectType, Functions
+＠subsection FcLangSet
+
+An ＠code{FcLangSet} holds a set of RFC 3066 language tags, ＠ref{LANG tags}.
+This module provides functions to determine whether a given language is
+fully supported by a font. Partial support can be determined using the
+font's character set, ＠ref{FcCharSet}.
+
+＠deftypefun FcLangSet *FcLangSetCreate (void);
+
+Create an empty ＠code{FcLangSet}.
+＠end deftypefun
+
+＠deftypefun void FcLangSetDestroy (FcLangSet *ls);
+
+Destroy a ＠code{FcLangSet}, freeing any associated storage.
+＠end deftypefun
+
+＠deftypefun FcLangSet *FcLangSetCopy (const FcLangSet *ls);
+
+Copy ＠var{ls} to a newly allocated ＠code{FcLangSet}.
+＠end deftypefun
+
+＠deftypefun FcBool FcLangSetAdd (FcLangSet *ls, const FcChar8 *lang);
+
+Add ＠var{lang} to ＠code{FcLangSet} ＠var{ls}.
+＠end deftypefun
+
+＠deftypefun FcLangResult FcLangSetHasLang (const FcLangSet *ls, const FcChar8 *lang);
+
+Check whether ＠var{lang} is a member of ＠code{FcLangSet} ＠var{ls}. Note that
+the return value is a ＠code{FcLangResult}, not a Boolean.
+＠end deftypefun
+
+＠deftypefun FcLangResult FcLangSetCompare (const FcLangSet *lsa, const FcLangSet *lsb);
+
+#### Document me.
+＠end deftypefun
+
+＠deftypefun FcBool FcLangSetEqual (const FcLangSet *lsa, const FcLangSet *lsb);
+
+Check whether the ＠code{FcLangSet}s ＠var{lsa} and ＠var{lsb} contain the same
+members.
+＠end deftypefun
+
+＠deftypefun FcChar32 FcLangSetHash (const FcLangSet *ls);
+
+Return a hash value; two ＠code{FcLangSet}s which hash to different values
+cannot contain the same members.
+＠end deftypefun
+
+
+＠node Querying Fonts and Their Properties, Initialization, FcLangSet, Functions
+＠subsection Querying Fonts and Their Properties
+
+An FcBlanks object holds a list of Unicode chars which are expected to
+be blank when drawn. When scanning new fonts, any glyphs which are
+empty and not in this list will be assumed to be broken and not placed in
+the FcCharSet associated with the font. This provides a significantly more
+accurate CharSet for applications.
+
+＠deftypefun FcBlanks *FcBlanksCreate (void)
+
+Creates an empty FcBlanks object.
+＠end deftypefun
+
+＠deftypefun void FcBlanksDestroy (FcBlanks *b)
+
+Destroys an FcBlanks object, freeing any associated memory.
+＠end deftypefun
+
+＠deftypefun FcBool FcBlanksAdd (FcBlanks *b, FcChar32 ucs4)
+
+Adds a single character to an FcBlanks object, returning FcFalse
+if this process ran out of memory.
+＠end deftypefun
+
+＠deftypefun FcBool FcBlanksIsMember (FcBlanks *b, FcChar32 ucs4)
+
+Returns whether the specified FcBlanks object contains the indicated Unicode
+value.
+＠end deftypefun
+
+The site or user may specify substitutions for certain font patterns,
+for convenience or to get more accurate results for the local
+installation or preferences. These functions execute the substitution
+based on a specified configuration.
+
+＠deftypefun FcBool FcConfigSubstituteWithPat (FcConfig *config, FcPattern *p, FcPattern *p_pat FcMatchKind kind)
+
+Performs the sequence of pattern modification operations, if 'kind' is
+FcMatchPattern, then those tagged as pattern operations are applied, else
+if 'kind' is FcMatchFont, those tagged as font operations are applied and
+p_pat is used for <test> elements with target=pattern.
+＠end deftypefun
+
+＠deftypefun FcBool FcConfigSubstitute (FcConfig *config, FcPattern *p, FcMatchKind kind)
+
+Calls FcConfigSubstituteWithPat setting p_pat to NULL.
+＠end deftypefun
+
+The following functions return fonts that match a certain pattern.
+＠code{FcFontRenderPrepare} and ＠code{FcFontMatch} always return a single
+best match. ＠code{FcFontList} returns the list of fonts that match a a
+given pattern on a certain set of properties. ＠code{FcFontSort} returns
+the entire list of fonts, sorted in order of match quality, possibly
+filtering out fonts that do not provide additional characters beyond
+those provided by preferred fonts.
+
+＠deftypefun {FcPattern *} FcFontRenderPrepare (FcConfig *config, FcPattern *pat, FcPattern *font)
+
+Creates a new pattern consisting of elements of 'font' not appearing
+in 'pat', elements of 'pat' not appearing in 'font' and the best matching
+value from 'pat' for elements appearing in both. The result is passed to
+FcConfigSubstitute with 'kind' FcMatchFont and then returned.
+＠end deftypefun
+
+＠deftypefun {FcPattern *} FcFontMatch (FcConfig *config, FcPattern *p, FcResult *result)
+
+Returns the font in 'config' most close matching 'p'. This function
+should be called only after FcConfigSubstitute and FcDefaultSubstitute have
+been called for 'p'; otherwise the results will not be correct.
+＠end deftypefun
+
+＠deftypefun FcFontSet *FcFontList (FcConfig *config, FcPattern *p, FcObjectSet *os)
+
+Selects fonts matching 'p', creates patterns containing only the objects in
+'os' from those fonts, and returns the set of unique such patterns.
+
+The FcFontSet returned by FcFontList is destroyed by calling FcFontSetDestroy.
+＠end deftypefun
+
+＠deftypefun FcFontSet *FcFontSort (FcConfig *config, FcPattern *p, FcBool trim, FcCharSet **csp, FcResult *result)
+
+Returns the list of all fonts sorted by closeness to 'p'. If 'trim' is
+FcTrue, elements in the list which don't include Unicode coverage not
+provided by earlier elements in the list are elided. The union of
+Unicode coverage of all of the fonts is returned in 'csp', if 'csp' is
+not NULL. This function should be called only after FcConfigSubstitute
+and FcDefaultSubstitute have been called for 'p'; otherwise the results
+will not be correct.
+
+The returned FcFontSet references FcPattern structures which may be shared
+by the return value from multiple FcFontSort calls, applications must not
+modify these patterns. Instead, they should be passed, along with 'p' to
+FcFontRenderPrepare which combines them into a complete pattern.
+
+The FcFontSet returned by FcFontSort is destroyed by calling FcFontSetDestroy.
+＠end deftypefun
+
+
+＠node Initialization, FcAtomic, Querying Fonts and Their Properties, Functions
+＠subsection Initialization
+
+An FcConfig object holds the internal representation of a configuration.
+There is a default configuration which applications may use by passing 0 to
+any function using the data within an FcConfig.
+
+＠deftypefun FcConfig *FcConfigCreate (void)
+
+Creates an empty configuration.
+＠end deftypefun
+
+＠deftypefun void FcConfigDestroy (FcConfig *config)
+
+Destroys a configuration and any data associated with it. Note that calling
+this function with the return from FcConfigGetCurrent will place the library
+in an indeterminate state.
+＠end deftypefun
+
+＠deftypefun FcBool FcConfigSetCurrent (FcConfig *config)
+
+Sets the current default configuration to 'config'. Implicitly calls
+FcConfigBuildFonts if necessary, returning FcFalse if that call fails.
+＠end deftypefun
+
+＠deftypefun FcConfig *FcConfigGetCurrent (void)
+
+Returns the current default configuration.
+＠end deftypefun
+
+＠deftypefun FcBool FcConfigUptoDate (FcConfig *config)
+
+Checks all of the files related to 'config' and returns whether the
+in-memory version is in sync with the disk version.
+＠end deftypefun
+
+＠deftypefun FcBool FcConfigBuildFonts (FcConfig *config)
+
+Builds the set of available fonts for the given configuration. Note that
+any changes to the configuration after this call have indeterminate effects.
+Returns FcFalse if this operation runs out of memory.
+＠end deftypefun
+
+＠deftypefun FcStrList *FcConfigGetConfigDirs (FcConfig *config)
+
+Returns the list of font directories specified in the configuration files
+for 'config'. Does not include any subdirectories.
+＠end deftypefun
+
+＠deftypefun FcStrList *FcConfigGetFontDirs (FcConfig *config)
+
+Returns the list of font directories in 'config'. This includes the
+configured font directories along with any directories below those in the
+filesystem.
+＠end deftypefun
+
+＠deftypefun FcStrList *FcConfigGetConfigFiles (FcConfig *config)
+
+Returns the list of known configuration files used to generate 'config'.
+Note that this will not include any configuration done with FcConfigParse.
+＠end deftypefun
+
+＠deftypefun char *FcConfigGetCache (FcConfig *config)
+
+Returns the name of the file used to store per-user font information.
+＠end deftypefun
+
+＠deftypefun FcFontSet *FcConfigGetFonts (FcConfig *config, FcSetName set)
+
+Returns one of the two sets of fonts from the configuration as specified
+by 'set'.
+＠end deftypefun
+
+＠deftypefun FcBlanks *FcConfigGetBlanks (FcConfig *config)
+
+Returns the FcBlanks object associated with the given configuration, if no
+blanks were present in the configuration, this function will return 0.
+＠end deftypefun
+
+＠deftypefun int FcConfigGetRescanInverval (FcConfig *config)
+
+Returns the interval between automatic checks of the configuration (in
+seconds) specified in 'config'. The configuration is checked during
+a call to FcFontList when this interval has passed since the last check.
+＠end deftypefun
+
+＠deftypefun FcBool FcConfigSetRescanInverval (FcConfig *config, int rescanInterval)
+
+Sets the rescan interval; returns FcFalse if an error occurred.
+＠end deftypefun
+
+＠deftypefun FcBool FcConfigAppFontAddFile (FcConfig *config, const char *file)
+
+Adds an application-specific font to the configuration.
+＠end deftypefun
+
+＠deftypefun FcBool FcConfigAppFontAddDir (FcConfig *config, const char *dir)
+
+Scans the specified directory for fonts, adding each one found to the
+application-specific set of fonts.
+＠end deftypefun
+
+＠deftypefun void FcConfigAppFontClear (FcConfig *config)
+
+Clears the set of application-specific fonts.
+＠end deftypefun
+
+These functions provide some control over how the default configuration of
+the library is initialized. (This configuration is normally implicitly
+initialized.)
+
+＠deftypefun char *FcConfigFilename (const char *name)
+
+Given the specified external entity name, return the associated filename.
+This provides applications a way to convert various configuration file
+references into filename form.
+
+A null or empty 'name' indicates that the default configuration file should
+be used; which file this references can be overridden with the
+FC_CONFIG_FILE environment variable. Next, if the name starts with '~', it
+refers to a file in the current users home directory. Otherwise if the name
+doesn't start with '/', it refers to a file in the default configuration
+directory; the built-in default directory can be overridden with the
+FC_CONFIG_DIR environment variable.
+＠end deftypefun
+
+＠deftypefun FcConfig *FcInitLoadConfig (void)
+
+Loads the default configuration file and returns the resulting configuration.
+Does not load any font information.
+＠end deftypefun
+
+＠deftypefun FcConfig *FcInitLoadConfigAndFonts (void)
+
+Loads the default configuration file and builds information about the
+available fonts. Returns the resulting configuration.
+＠end deftypefun
+
+＠deftypefun FcBool FcInit (void)
+
+Loads the default configuration file and the fonts referenced therein and
+sets the default configuration to that result. Returns whether this
+process succeeded or not. If the default configuration has already
+been loaded, this routine does nothing and returns FcTrue.
+＠end deftypefun
+
+＠deftypefun int FcGetVersion (void)
+
+Returns the version number of the library.
+＠end deftypefun
+
+＠deftypefun FcBool FcInitReinitialize (void)
+
+Forces the default configuration file to be reloaded and resets the default
+configuration.
+＠end deftypefun
+
+＠deftypefun FcBool FcInitBringUptoDate (void)
+
+Checks the rescan interval in the default configuration, checking the
+configuration if the interval has passed and reloading the configuration
+when any changes are detected.
+＠end deftypefun
+
+
+＠node FcAtomic, FreeType-Specific Functions, Initialization, Functions
+＠subsection FcAtomic
+
+These functions provide a safe way to update config files, allowing ongoing
+reading of the old config file while locked for writing and ensuring that a
+consistent and complete version of the config file is always available.
+
+＠deftypefun FcAtomic * FcAtomicCreate (const FcChar8 *file)
+
+Creates a data structure containing data needed to control access to 'file'.
+Writing is done to a separate file. Once that file is complete, the original
+configuration file is atomically replaced so that reading process always see
+a consistent and complete file without the need to lock for reading.
+＠end deftypefun
+
+＠deftypefun FcBool FcAtomicLock (FcAtomic *atomic)
+
+Attempts to lock the file referenced by 'atomic'. Returns FcFalse if the
+file is locked by another process, else returns FcTrue and leaves the file
+locked.
+＠end deftypefun
+
+＠deftypefun FcChar8 *FcAtomicNewFile (FcAtomic *atomic)
+
+Returns the filename for writing a new version of the file referenced
+by 'atomic'.
+＠end deftypefun
+
+＠deftypefun FcChar8 *FcAtomicOrigFile (FcAtomic *atomic)
+
+Returns the file refernced by 'atomic'.
+＠end deftypefun
+
+＠deftypefun FcBool FcAtomicReplaceOrig (FcAtomic *atomic)
+
+Replaces the original file referenced by 'atomic' with the new file.
+＠end deftypefun
+
+＠deftypefun void FcAtomicDeleteNew (FcAtomic *atomic)
+
+Deletes the new file.
+＠end deftypefun
+
+＠deftypefun void FcAtomicUnlock (FcAtomic *atomic)
+
+Unlocks the file.
+＠end deftypefun
+
+＠deftypefun void FcAtomicDestroy (FcAtomic *atomic)
+
+Destroys 'atomic'.
+＠end deftypefun
+
+＠node FreeType-Specific Functions, XML-Specific Functions, FcAtomic, Functions
+＠subsection FreeType-Specific Functions
+
+＠example
+#include <fontconfig/fcfreetype.h>
+＠end example
+
+While the fontconfig library doesn't insist that FreeType be used as the
+rasterization mechanism for fonts, it does provide some convenience
+functions.
+
+＠deftypefun FT_UInt FcFreeTypeCharIndex (FT_Face face, FcChar32 ucs4)
+
+Maps a Unicode char to a glyph index. This function uses information from
+several possible underlying encoding tables to work around broken fonts.
+As a result, this function isn't designed to be used in performance
+sensitive areas; results from this function are intended to be cached by
+higher level functions.
+＠end deftypefun
+
+＠deftypefun {FcCharSet *} FcFreeTypeCharSet (FT_Face face, FcBlanks *blanks) Scans a
+
+FreeType face and returns the set of encoded Unicode chars. This scans
+several encoding tables to build as complete a list as possible.
+If 'blanks' is not 0, the glyphs in the font are examined and any blank glyphs
+not in 'blanks' are not placed in the returned FcCharSet.
+＠end deftypefun
+
+＠deftypefun {FcPattern *} FcFreeTypeQuery (const char *file, int id, FcBlanks *blanks, int *count)
+
+Constructs a pattern representing the 'id'th font in 'file'. The number
+of fonts in 'file' is returned in 'count'.
+＠end deftypefun
+
+＠node XML-Specific Functions, File and Directory Routines, FreeType-Specific Functions, Functions
+＠subsection XML-Specific Functions
+
+＠deftypefun FcBool FcConfigParseAndLoad (FcConfig *config, const FcChar8 *file, FcBool complain)
+
+Walks the configuration in 'file' and constructs the internal representation
+in 'config'. Any include files referenced from within 'file' will be loaded
+with FcConfigLoad and also parsed. If 'complain' is FcFalse, no warning
+will be displayed if 'file' does not exist.
+＠end deftypefun
+
+＠node File and Directory Routines, FcStrSet and FcStrList, XML-Specific Functions, Functions
+＠subsection File and Directory Routines
+
+＠deftypefun FcBool FcFileScan (FcFontSet *set, FcStrSet *dirs, FcFileCache *cache, FcBlanks *blanks, const char *file, FcBool force)
+
+Scans a single file and adds all fonts found to 'set'. If 'force' is FcTrue,
+then the file is scanned even if associated information is found in 'cache'.
+If 'file' is a directory, it is added to 'dirs'.
+＠end deftypefun
+
+＠deftypefun FcBool FcDirScan (FcFontSet *set, FcStrSet *dirs, FcFileCache *cache, FcBlanks *blanks, const char *dir, FcBool force)
+
+Scans an entire directory and adds all fonts found to 'set'. If 'force' is
+FcTrue, then the directory and all files within it are scanned even if
+information is present in the per-directory cache file or 'cache'. Any
+subdirectories found are added to 'dirs'.
+＠end deftypefun
+
+＠deftypefun FcBool FcDirSave (FcFontSet *set, FcStrSet *dirs, const char *dir)
+
+Creates the per-directory cache file for 'dir' and populates it with the
+fonts in 'set' and subdirectories in 'dirs'.
+＠end deftypefun
+
+＠deftypefun FcBool FcDirCacheValid (const FcChar8 *cache_file)
+
+Returns FcTrue if 'cache_file' is no older than the directory containing it,
+else FcFalse.
+＠end deftypefun
+
+＠node FcStrSet and FcStrList, String Utilities, File and Directory Routines, Functions
+＠subsection FcStrSet and FcStrList
+
+A data structure for enumerating strings, used to list directories while
+scanning the configuration as directories are added while scanning.
+
+＠deftypefun FcStrSet *FcStrSetCreate (void)
+
+Create an empty set.
+＠end deftypefun
+
+＠deftypefun FcBool FcStrSetMember (FcStrSet *set, const FcChar8 *s)
+
+Returns whether 's' is a member of 'set'.
+＠end deftypefun
+
+＠deftypefun FcBool FcStrSetAdd (FcStrSet *set, const FcChar8 *s)
+
+Adds a copy of 's' to 'set'.
+＠end deftypefun
+
+＠deftypefun FcBool FcStrSetAddFilename (FcStrSet *set, const FcChar8 *s)
+
+Adds a copy 's' to 'set', The copy is created with FcStrCopyFilename
+so that leading '~' values are replaced with the value of the HOME
+environment variable.
+＠end deftypefun
+
+＠deftypefun FcBool FcStrSetDel (FcStrSet *set, const FcChar8 *s)
+
+Removes 's' from 'set', returning FcTrue if 's' was a member else FcFalse.
+＠end deftypefun
+
+＠deftypefun void FcStrSetDestroy (FcStrSet *set)
+
+Destroys 'set'.
+＠end deftypefun
+
+＠deftypefun FcStrList *FcStrListCreate (FcStrSet *set)
+
+Creates an enumerator to list the strings in 'set'.
+＠end deftypefun
+
+＠deftypefun FcChar8 *FcStrListNext (FcStrList *list)
+
+Returns the next string in 'set'.
+＠end deftypefun
+
+＠deftypefun void FcStrListDone (FcStrList *list)
+
+Destroys the enumerator 'list'.
+＠end deftypefun
+
+＠node String Utilities, , FcStrSet and FcStrList, Functions
+＠subsection String Utilities
+
+＠deftypefun int FcUtf8ToUcs4 (FcChar8 *src, FcChar32 *dst, int len)
+
+Converts the next Unicode char from 'src' into 'dst' and returns the number
+of bytes containing the char. 'src' must be at least 'len' bytes long.
+＠end deftypefun
+
+＠deftypefun int FcUcs4ToUtf8 (FcChar32 src, FcChar8 dst[FC_UTF8_MAX_LEN])
+
+Converts the Unicode char from 'src' into 'dst' and returns the
+number of bytes needed to encode the char.
+＠end deftypefun
+
+＠deftypefun FcBool FcUtf8Len (FcChar8 *src, int len, int *nchar, int *wchar)
+
+Counts the number of Unicode chars in 'len' bytes of 'src'. Places that
+count in 'nchar'. 'wchar' contains 1, 2 or 4 depending on the number of
+bytes needed to hold the largest unicode char counted. The return value
+indicates whether 'src' is a well-formed UTF8 string.
+＠end deftypefun
+
+＠deftypefun int FcUtf16ToUcs4 (FcChar8 *src, FcEndian endian, FcChar32 *dst, int len)
+
+Converts the next Unicode char from 'src' into 'dst' and returns the
+number of bytes containing the char. 'src' must be at least 'len' bytes
+long. Bytes of 'src' are combined into 16-bit units according to 'endian'.
+＠end deftypefun
+
+＠deftypefun FcBool FcUtf16Len (FcChar8 *src, FcEndian endian, int len, int *nchar, int *wchar)
+
+Counts the number of Unicode chars in 'len' bytes of 'src'. Bytes of 'src'
+are combined into 16-bit units according to 'endian'. Places that
+count in 'nchar'. 'wchar' contains 1, 2 or 4 depending on the number of
+bytes needed to hold the largest unicode char counted. The return value
+indicates whether 'string' is a well-formed UTF16 string.
+＠end deftypefun
+
+＠deftypefun FcChar8 *FcStrCopy (const FcChar8 *s)
+
+Allocates memory, copies 's' and returns the resulting buffer. Yes, this
+is 'strdup', but that function isn't available on every platform.
+＠end deftypefun
+
+＠deftypefun FcChar8 *FcStrCopyFilename (const FcChar8 *s)
+
+Just like FcStrCopy except that it converts any leading '~' characters
+in 's' to the value of the HOME environment variable.
+＠end deftypefun
+
+＠deftypefun int FcStrCmpIgnoreCase (const char *s1, const char *s2)
+
+Returns the usual <0, 0, >0 result of comparing 's1' and 's2'. This test
+is case-insensitive in the ASCII range and will operate properly with UTF8
+encoded strings, although it does not check for well formed strings.
+＠end deftypefun
+
+＠deftypefun FcChar8 *FcStrDirname (const FcChar8 *file)
+
+Returns the directory containing 'file'.
+＠end deftypefun
+
+＠deftypefun FcChar8 *FcStrBasename (const FcChar8 *file)
+
+Returns the filename of 'file' stripped of any leading directory names.
+＠end deftypefun
+
+＠node Configuration File Format, Files, The fontconfig API, Top
+＠chapter Configuration File Format
+
+Configuration files for fontconfig are stored in XML format; this
+format makes external configuration tools easier to write and ensures that
+they will generate syntactically correct configuration files. As XML
+files are plain text, they can also be manipulated by the expert user using
+a text editor.
+
+The fontconfig document type definition resides in the external entity
+(a)samp{fonts.dtd}; this is normally stored in the default font configuration
+directory (＠file{/etc/fonts}). Each configuration file should contain the
+following structure:
+
+＠example
+ <?xml version="1.0"?>
+ <!DOCTYPE fontconfig SYSTEM "fonts.dtd">
+ <fontconfig>
+ ...
+ </fontconfig>
+＠end example
+
+＠table ＠samp
+＠item <fontconfig>
+This is the top level element for a font configuration and can contain
+＠samp{<dir>}, ＠samp{<cache>}, ＠samp{<include>}, ＠samp{<match>} and ＠samp{<alias>} elements in any order.
+
+＠item <dir>
+This element contains a directory name which will be scanned for font files
+to include in the set of available fonts. The scan does not recurse into
+subdirectories.
+
+＠item <cache>
+This element contains a file name for the per-user cache of font
+information. If it starts with '~', it refers to a file in the users
+home directory. This file is used to hold information about fonts that
+isn't present in the per-directory cache files. It is automatically
+maintained by the fontconfig library. The default for this file
+is ``~/.fonts.cache-<version>'', where <version> is the font configuration
+file version number (currently 1).
+
+＠item <include ignore_missing="no">
+This element contains the name of an additional configuration file. When
+the XML datatype is traversed by FcConfigParse, the contents of the file
+will also be incorporated into the configuration by passing the filename to
+FcConfigLoadAndParse. If 'ignore_missing' is set to "yes" instead of the
+default "no", a missing file will elicit no warning message from the library.
+
+＠item <config>
+This element provides a place to consolidate additional configuration
+information. ＠samp{<config>} can contain ＠samp{<blank>} and ＠samp{<rescan>} elements in any
+order.
+
+＠item <blank>
+Fonts often include "broken" glyphs which appear in the encoding but are
+drawn as blanks on the screen. Within the ＠samp{<blank>} element, place each
+Unicode characters which is supposed to be blank in an ＠samp{<int>} element.
+Characters outside of this set which are drawn as blank will be elided from
+the set of characters supported by the font.
+
+＠item <rescan>
+The ＠samp{<rescan>} element holds an ＠samp{<int>} element which indicates the default
+interval between automatic checks for font configuration changes.
+Fontconfig will validate all of the configuration files and directories and
+automatically rebuild the internal datastructures when this interval passes.
+
+＠item <match target="pattern">
+This element holds first a (possibly empty) list of ＠samp{<test>} elements and then
+a (possibly empty) list of ＠samp{<edit>} elements. Patterns which match all of the
+tests are subjected to all the edits. If 'target' is set to "font" instead
+of the default "pattern", then this element applies to the font name
+resulting from a match rather than a font pattern to be matched.
+
+＠item <test qual="any" name="property" compare="eq">
+This element contains a single value which is compared with the pattern
+property "property" (substitute any of the property names seen
+above). 'compare' can be one of "eq", "not_eq", "less", "less_eq", "more", or
+"more_eq". 'qual' may either be the default, "any", in which case the match
+succeeds if any value associated with the property matches the test value, or
+"all", in which case all of the values associated with the property must
+match the test value.
+
+＠item <edit name="property" mode="assign" binding="weak">
+This element contains a list of expression elements (any of the value or
+operator elements). The expression elements are evaluated at run-time and
+modify the property "property". The modification depends on whether
+"property" was matched by one of the associated ＠samp{<test>} elements, if so, the
+modification may affect the first matched value. Any values inserted into
+the property are given the indicated binding. 'mode' is one of:
+
+＠example
+Mode Operation with match Operation without match
+
+"assign" Replace matching value Replace all values
+"assign_replace" Replace all values Replace all values
+"prepend" Insert before matching value Insert at head of list
+"prepend_first" Insert at head of list Insert at head of list
+"append" Append after matching value Append at end of list
+"append_last" Append at end of list Append at end of list
+＠end example
+
+＠item <int>
+＠itemx <double>
+＠itemx <string>
+＠itemx <bool>
+These elements hold a single value of the indicated type. ＠samp{<bool>} elements
+hold either true or false.
+
+＠item <matrix>
+
+This element holds the four ＠samp{<double>} elements of an affine transformation.
+
+＠item <name>
+Holds a property name. Evaluates to the first value from the property of
+the font, not the pattern.
+
+＠item <const>
+Holds the name of a constant; these are always integers and serve as
+symbolic names for common font values:
+
+＠example
+Constant Property CPP symbol
+
+light weight FC_WEIGHT_LIGHT
+medium weight FC_WEIGHT_MEDIUM
+demibold weight FC_WEIGHT_DEMIBOLD
+bold weight FC_WEIGHT_BOLD
+black weight FC_WEIGHT_BLACK
+roman slant FC_SLANT_ROMAN
+italic slant FC_SLANT_ITALIC
+oblique slant FC_SLANT_OBLIQUE
+proportional spacing FC_PROPORTIONAL
+mono spacing FC_MONO
+charcell spacing FC_CHARCELL
+unknown rgba FC_RGBA_UNKNOWN
+rgb rgba FC_RGBA_RGB
+bgr rgba FC_RGBA_BGR
+vrgb rgba FC_RGBA_VRGB
+vbgr rgba FC_RGBA_VBGR
+none rgba FC_RGBA_NONE
+＠end example
+
+＠item <or>
+＠itemx <and>
+＠itemx <plus>
+＠itemx <minus>
+＠itemx <times>
+＠itemx <divide>
+These elements perform the specified operation on a list of expression
+elements. ＠samp{<or>} and ＠samp{<and>} are boolean, not bitwise.
+
+＠item <eq>
+＠itemx <not_eq>
+＠itemx <less>
+＠itemx <less_eq>
+＠itemx <more>
+＠itemx <more_eq>
+These elements compare two values, producing a boolean result.
+
+＠item <not>
+Inverts the boolean sense of its one expression element
+
+＠item <if>
+This element takes three expression elements; if the value of the first is
+true, it produces the value of the second, otherwise it produces the value
+of the third.
+
+＠item <alias>
+Alias elements provide a shorthand notation for the set of common match
+operations needed to substitute one font family for another. They contain a
+＠samp{<family>} element followed by optional ＠samp{<prefer>}, ＠samp{<accept>} and ＠samp{<default>}
+elements. Fonts matching the ＠samp{<family>} element are edited to prepend the
+list of ＠samp{<prefer>}ed families before the matching ＠samp{<family>}, append the
+＠samp{<accept>}able families after the matching ＠samp{<family>} and append the ＠samp{<default>}
+families to the end of the family list.
+
+＠item <family>
+Holds a single font family name
+
+＠item <prefer>
+＠itemx <accept>
+＠itemx <default>
+These each hold a list of ＠samp{<family>} elements to be used by the ＠samp{<alias>}
+element.
+＠end table
+
+＠menu
+* Example System Configuration File::
+* Example User Configuration File::
+＠end menu
+
+＠node Example System Configuration File, Example User Configuration File, Configuration File Format, Configuration File Format
+＠section Example System Configuration File
+
+This is an example of a system-wide configuration file:
+
+＠example
+<?xml version="1.0"?>
+<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
+<!-- /etc/fonts/fonts.conf file to configure system font access -->
+<fontconfig>
+<!--
+ Find fonts in these directories
+-->
+<dir>/usr/X11R6/lib/X11/fonts/truetype</dir>
+<dir>/usr/X11R6/lib/X11/fonts/Type1</dir>
+
+<!--
+ Accept deprecated 'mono' alias, replacing it with 'monospace'
+-->
+<match target="pattern">
+ <test qual="any" name="family"><string>mono</string></test>
+ <edit name="family" mode="assign"><string>monospace</string></edit>
+</match>
+
+<!--
+ Names not including any well known alias are given 'sans'
+-->
+<match target="pattern">
+ <test qual="all" name="family" mode="not_eq">sans</test>
+ <test qual="all" name="family" mode="not_eq">serif</test>
+ <test qual="all" name="family" mode="not_eq">monospace</test>
+ <edit name="family" mode="append_last"><string>sans</string></edit>
+</match>
+
+<!--
+ Load per-user customization file, but don't complain
+ if it doesn't exist
+-->
+<include ignore_missing="yes">~/.fonts.conf</include>
+
+<!--
+ Alias well known font names to available TrueType fonts.
+ These substitute TrueType faces for similar Type1
+ faces to improve screen appearance.
+-->
+<alias>
+ <family>Times</family>
+ <prefer><family>Times New Roman</family></prefer>
+ <default><family>serif</family></default>
+</alias>
+<alias>
+ <family>Helvetica</family>
+ <prefer><family>Verdana</family></prefer>
+ <default><family>sans</family></default>
+</alias>
+<alias>
+ <family>Courier</family>
+ <prefer><family>Courier New</family></prefer>
+ <default><family>monospace</family></default>
+</alias>
+
+<!--
+ Provide required aliases for standard names
+ Do these after the users configuration file so that
+ any aliases there are used preferentially
+-->
+<alias>
+ <family>serif</family>
+ <prefer><family>Times New Roman</family></prefer>
+</alias>
+<alias>
+ <family>sans</family>
+ <prefer><family>Verdana</family></prefer>
+</alias>
+<alias>
+ <family>monospace</family>
+ <prefer><family>Andale Mono</family></prefer>
+</alias>
+</fontconfig>
+＠end example
+
+＠node Example User Configuration File, , Example System Configuration File, Configuration File Format
+＠section Example User Configuration File
+
+This is an example of a per-user configuration file that lives in
+(a)file{~/.fonts.conf}:
+
+＠example
+<?xml version="1.0"?>
+<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
+<!-- ~/.fonts.conf for per-user font configuration -->
+<fontconfig>
+
+<!--
+ Private font directory
+-->
+<dir>~/misc/fonts</dir>
+
+<!--
+ use rgb sub-pixel ordering to improve glyph appearance on
+ LCD screens. Changes affecting rendering, but not matching,
+ should always use target="font".
+-->
+<match target="font">
+ <edit name="rgba" mode="assign"><const>rgb</const></edit>
+</match>
+</fontconfig>
+＠end example
+
+＠node Files, Authors, Configuration File Format, Top
+＠chapter Files
+
+＠table ＠file
+＠item fonts.dtd
+is a DTD that describes the format of the configuration files.
+
+＠item fonts.conf
+is the default system-wide font configuration file. It
+contains configuration information for the fontconfig library
+consisting of directories to look at for font information as well as
+instructions on editing program specified font patterns before attempting to
+match the available fonts. It is in xml format, with DTD ＠file{fonts.dtd}.
+
+＠item local.conf
+is the conventional default location for local font configuration. It
+is sourced by the default system-wide fonts.conf file.
+Note that the normal 'make install' procedure for XFree86 is to
+replace any existing fonts.conf file with the new version. Place
+any local customizations in local.conf which this file references.
+It is in xml format, with DTD ＠file{fonts.dtd}.
+
+＠item ~/.fonts.conf
+is the conventional location for per-user font configuration, although the
+actual location is specified in the global fonts.conf file.
+It is in xml format, with DTD ＠file{fonts.dtd}.
+
+＠item fonts.cache-*
+is found in each font directory where fonts were found. This file is
+automatically maintained by fontconfig. It is a flat text table, and
+should be treated as opaque.
+
+＠item ~/.fonts.cache-*
+is the conventional repository of font information that isn't found in the
+per-directory caches. This file is automatically maintained by fontconfig.
+It is a flat text table, and should be treated as opaque.
+＠end table
+
+＠node Authors, , Files, Top
+＠chapter Authors
+
+＠table ＠strong
+＠item Keith Packard
+member of the XFree86 Project, Inc.
+
+＠item Stephen J. Turnbull
+member of the XEmacs Project
+＠end table
+
+＠bye
+
+＠c Local variables:
+＠c mode: texinfo
+＠c End:
+
+＠c arch-tag: 108A3E8B-1CE1-11D9-9957-000A959E994E
+
+＠c end of fontconfig.texi
--
Institute of Policy and Planning Sciences http://turnbull.sk.tsukuba.ac.jp
University of Tsukuba Tennodai 1-1-1 Tsukuba 305-8573 JAPAN
Ask not how you can "do" free software business;
ask what your business can "do for" free software.
- 1 participants
- 0 comments
Re: [Q] frame.el synch with Emacs 21.3
20 years, 1 month
Jerry James
Jerry James
"Stephen J. Turnbull" <stephen(a)xemacs.org> wrote:
> QUERY
>
> Sorry to dredge this up 8 months after the commit, but I just realized
> what was happening here due to a question on c.e.x. If we decide to
> pull this junk, I'll do the work.
Can you give me a pointer to the c.e.x. question? Google groups would
be great since I lost my Usenet feed in August.
> This stuff:
>
>>>>>> "Jerry" == Jerry James <james(a)xemacs.org> writes:
>
> Jerry> * frame.el: Synch with Emacs 21.3.
>
> Jerry> -;; FSFmacs has weird functions `set-default-font', `set-background-color',
> Jerry> -;; `set-foreground-color' here. They don't do sensible things like
> Jerry> -;; set faces; instead they set frame properties (??!!) and call
> Jerry> -;; useless functions such as `frame-update-faces' and
> Jerry> -;; `frame-update-face-colors'.
>
> Jerry> +;; XEmacs change: this function differs significantly from Emacs.
> Jerry> +(defun set-foreground-color (color-name)
>
> seems really questionable. We did without these functions for at
> least five or six years (the deprecation comment is in 21.1), the
> names suck very badly, the implementation is completely different,
> etc.
>
> Discussion?
Before you start pulling them, you'd better look around and see where
they are being used already. For example, set-foreground-color is used
in the ess package; do a grep on display-graphic-p in the packages.
I agree that this stuff is questionable. I put it in purely as an aid
to porting. I wouldn't mind at all moving it to fsf-compat and putting
big warning signs: "THERE BE DRAGONS HERE".
--
Jerry James
http://www.ittc.ku.edu/~james/
- 2 participants
- 1 comments
[Q] [PATCH] aliasing warning
20 years, 1 month
Jerry James
Jerry James
Ben Wing <ben(a)xemacs.org> wrote:
> * free-hook.c (check_free):
> Fix aliasing warning.
>
> Index: src/free-hook.c
> ===================================================================
> RCS file: /pack/xemacscvs/XEmacs/xemacs/src/free-hook.c,v
> retrieving revision 1.11
> diff -u -p -r1.11 free-hook.c
> --- src/free-hook.c 2004/09/20 19:19:45 1.11
> +++ src/free-hook.c 2004/11/18 02:18:19
> ＠＠ -131,7 +131,8 ＠＠ check_free (void *ptr)
> #endif
>
> EMACS_INT present = (EMACS_INT) gethash (ptr, pointer_table,
> - (const void **) &size);
> + (const void **)
> + (void *) &size);
>
> if (!present)
> {
Please do not commit this patch just yet. I am not surprised that it
stops gcc from issuing a warning, but I do not believe this is correct,
as in, "guarantees that compilers that do alias analysis will generate
correct code." On the other hand, I am not a language lawyer. Give me
a couple of days to try to get one to comment.
Thanks,
--
Jerry James
http://www.ittc.ku.edu/~james/
- 1 participants
- 0 comments
Re: [Q] [COMMIT] [PATCH] commit texinfo
20 years, 1 month
Jerry James
Jerry James
"Ben Wing" <ben(a)666.com> wrote:
>> The function whitespace-cleanup is defined in
>> text-modes/whitespace.el, but text-modes was not added to
>> REQUIRES in the Makefile. However, I wonder if this is
>> appropriate. At two other places in texinfmt.el, both in the
>> context of this patch, whitespace is removed like this:
>>
>> (while (re-search-forward "[ \t]+$" nil t)
>> (replace-match "" nil nil))
>>
>> Is that good enough? If so, we should do the same here
>> instead of creating a dependency on text-modes. If not, we
>> should change the other two places to call whitespace-cleanup also.
>
> I really don't know. The call to whitespace-cleanup comes from FSF, and I
> can't find any mention of it in their ChangeLogs.
Having looked at it for all of 30 seconds, it appears that the while
loop I mentioned is not appropriate at the place where
whitespace-cleanup is called. In that case, Ben, would you add
text-modes to REQUIRES in the texinfo Makefile?
Thanks,
--
Jerry James
http://www.ittc.ku.edu/~james/
- 1 participants
- 0 comments
[C] xemacsweb: Update of Languages/German/ from Stefan Kamphausen
20 years, 1 month
Adrian Aichner
Adrian Aichner
COMMIT
Thank you, Stefan!
Adrian
xemacsweb ChangeLog patch:
Diff command: cvs -q diff -U 0
Files affected: Languages/German/ChangeLog
Index: Languages/German/ChangeLog
===================================================================
RCS file: /pack/xemacscvs/XEmacs/xemacsweb/Languages/German/ChangeLog,v
retrieving revision 1.13
diff -u -U0 -r1.13 ChangeLog
--- Languages/German/ChangeLog 25 Nov 2004 21:16:40 -0000 1.13
+++ Languages/German/ChangeLog 27 Nov 2004 15:23:42 -0000
＠＠ -0,0 +1,4 ＠＠
+2004-11-27 Adrian Aichner <adrian(a)xemacs.org>
+
+ * index.content: Update from Stefan Kamphausen.
+
xemacsweb source patch:
Diff command: cvs -f -z3 -q diff -u -w -N
Files affected: Languages/German/index.content
Index: Languages/German/index.content
===================================================================
RCS file: /pack/xemacscvs/XEmacs/xemacsweb/Languages/German/index.content,v
retrieving revision 1.13
diff -u -w -r1.13 index.content
--- Languages/German/index.content 25 Nov 2004 21:16:40 -0000 1.13
+++ Languages/German/index.content 27 Nov 2004 15:22:51 -0000
＠＠ -9,15 +9,23 ＠＠
<h1>XEmacs - Auf Gut Deutsch</h1>
<p>
- Na, wenn Du es schon bis hierher geschafft hast, muß ich
- wohl keine große Überzeugungsarbeit mehr leisten: Du
- bist willens, in die Tiefen des XEmacs einzusteigen. Ich denke,
- das ist ein weiser Entschluss. Damit auch der deutschsprachige
- XEmacs User einen guten Einstieg findet, habe ich mir die
- Mühe gemacht, eine Einleitung zusammenzuschreiben (ob man das
- wohl tatsächlich zusammen schreibt? *g*).
+ Wer hier gelandet ist, steht vielleicht vor einem großen Schritt,
+ dem Schritt in die Welt des XEmacs. Ein "Texteditor" sagen
+ manche, eine "Religion" wieder andere. Auf jeden Fall eine
+ Entwicklungsplattform mit einer schier unglaublichen Menge an
+ Funktionalitäten und der Möglichkeit, mit einem eigenen
+ Lispdialekt eigene Erweiterungen und Anpassungen vorzunehmen.
+ </p>
+ <p>
+ Es existiert eine Vielzahl guter Dokumentationen und Einführungen,
+ die meisten davon jedoch in englischer Sprache. Für die Freunde
+ der deutschen Lesart und einer etwas lockeren Sprache gibt es ein
+ eigenes Dokument unter
+ </p>
+ <p align="center">
+ <a
+ href="http://www.skamphausen.de/xemacs">http://www.skamphausen.de/xemacs</a>
</p>
-
<p>
Jene Doku, auf die hier verwiesen wird, steht komplett unter der
<a href="http://www.gnu.org/copyleft/fdl.html">GNU
＠＠ -25,98 +33,29 ＠＠
steht, sie weiterzuverwenden etc....
</p>
- <h2>Inhalt</h2>
-
- <ul>
- <li>
- <a href="http://www.skamphausen.de/xemacs/index.html">XEmacs</a>
-
- <ol>
- <li><a href="http://www.skamphausen.de/xemacs/intro.html">Erstes
- Kapitel</a></li>
-
- <li><a
- href="http://www.skamphausen.de/xemacs/mechanismen.html">Mechanismen
- und Konzepte</a></li>
-
- <li><a href="http://www.skamphausen.de/xemacs/wishlist.html">Wishlist</a></li>
- </ol>
- </li>
-
- <li>
- <a href="http://www.skamphausen.de/xemacs/lisp/index.html">Lisp</a>
-
- <ol>
- <li><a
- href="http://www.skamphausen.de/xemacs/lisp/active-menu.html">Active
- Menu</a></li>
-
- <li><a
- href="http://www.skamphausen.de/xemacs/lisp/buffer-cycle.html"
- >Buffer Cycle</a></li>
-
- <li><a
- href="http://www.skamphausen.de/xemacs/lisp/timestamps.html">Timestamps</a></li>
-
- <li><a
- href="http://www.skamphausen.de/xemacs/lisp/togglesb.html">Toggle
- SB</a></li>
- </ol>
- </li>
-
- <li>
- <a href="http://www.skamphausen.de/xemacs/apps/index.html">XEmacs
- Anwendungen</a>
-
- <ol>
- <li><a
- href="http://www.skamphausen.de/xemacs/apps/auctex.html">AUCTeX</a></li>
-
- <li><a
- href="http://www.skamphausen.de/xemacs/apps/bravegnuworld.html">bravegnuworld-mode</a></li>
-
- <li><a href="http://www.skamphausen.de/xemacs/apps/ediff.html"
- >ediff</a></li>
-
- <li><a href="http://www.skamphausen.de/xemacs/apps/vm.html">VM</a></li>
- </ol>
- </li>
-
- <li>
- <a href="http://www.skamphausen.de/xemacs/config/index.html">XEmacs-Konfiguration</a>
-
- <ol>
- <li><a href="http://www.skamphausen.de/xemacs/config/customize.html">Konfiguration </a></li>
- <li><a href="http://www.skamphausen.de/xemacs/config/keys.html">Keybindings</a></li>
- <li><a href="http://www.skamphausen.de/xemacs/config/personal.html">Persönliche Einstellungen</a></li>
- <li><a href="http://www.skamphausen.de/xemacs/config/skeletons.html">Skeletons</a></li>
- <li><a href="http://www.skamphausen.de/xemacs/config/vm.html">VM</a></li>
- </ol>
- </li>
- </ul>
-
- <h2>Links zu anderen Seiten, die mir so begegnet sind</h2>
+ <h2>Links zu anderen deutschen Seiten zum Thema</h2>
<p>
<small>
- Aufgrund aktueller deutscher Rechtsprechung muss ich
- hier wohl ausdrücklich eine Verantwortung für die Inhalte
- jener Seiten ablehnen, da ich keinen Einfluss darauf habe,
- was die Autoren dort von sich geben. Zum Zeitpunkt des
- Verlinkens sah das jedenfalls alles sehr gut
- aus. (s. auch
- <a href="http://www.skamphausen.de/mission_statement.html">(Per)Mission Statement</a>)
- </small></p>
+ Aufgrund aktueller deutscher Rechtsprechung muss hier wohl
+ ausdrücklich eine Verantwortung für die Inhalte jener Seiten
+ abgelehnt werden, da diese Seiten ein ganz eigenes Dasein ohne
+ jegliche Verbindung zu dieser Seite hier führen. Damit
+ existiert von hier aus kein Einfluss darauf, was die Autoren
+ dort von sich geben. Zum Zeitpunkt des Verlinkens sah das
+ jedenfalls alles sehr gut aus.
+ </small>
+ </p>
<ul>
- <li>Eine andere übersichtliche Einführung in
+ <li>Eine andere übersichtliche Einführung in
AUCTeX findet sich auf <a href=
"http://bolug.uni-bonn.de/wissen/">http://bolug.uni-bonn.de/wissen/</a></li>
- <li>Ein anderer Einführungskurs <a href=
+ <li>Ein anderer Einführungskurs <a href=
"http://www-aix.gsi.de/~giese/UNIX-Kurs/Emacs.html">http://www-aix.gsi.de/...>
- <li>Ein sehr ausführlicher Einführungskurs der
+ <li>Ein sehr ausführlicher Einführungskurs der
mir einen sehr guten Eindruck macht und auf den GNU Emacs
abzielt:<br />
<a href=
＠＠ -125,7 +64,7 ＠＠
</li>
<li>Eine Sammlung von ELisp-Paketen, bei der bestimmt
- für jede was dabei ist:<br />
+ für jede was dabei ist:<br />
<a href=
"http://anc.ed.ac.uk/~stephen/emacs/ell.html">http://anc.ed.ac.uk/~stephen...>
＠＠ -138,52 +77,36 ＠＠
http://www.splode.com/users/friedman/software/emacs-lisp/</a></li>
</ul>
- <h2>Download</h2>
-
- <p>
- Das ganze Verzeichnis als ein Tarball (mit allen Abbildungen und
- weiteren Files):
- <a href="http://www.skamphausen.de/xemacs/xemacs-docs.tgz">xemacs-docs.tgz</a> (ca. 500kB)</p>
-
<h2>Dein Auftritt</h2>
<p>
- Ich habe versucht, diesen Seiten eine Struktur zu
- verpassen, dass sie leicht erweiterbar sind. Wenn DU einen
- Beitrag schreiben möchtest, schick mir doch einfach eine
- EMail und ich schicke dir ein XML-Skelett zurück, in dem
- du nur noch deinen Text tippen brauchst, oder aber schick mir
- eine EMail mit deinem (vorzugsweise HTML-) Dokument und ich
- kümmer micht darum. Vielleicht kennst du ja
- <code>PCL/CVS</code> oder die Verwendung des <code>gdb</code>
- im XEmacs so gut, dass du schnell einige Zeilen tippen
- kannst....
+ Dokumentation ist nur so gut wie ihre Autoren. Bis dato stammt
+ die genannte Dokumentation im Wesentlichen aus einer Feder. Wer
+ jedoch selber interessante Themen beisteuern kann
+ (z.B. Erfahrungen mit XEmacs auf anderen Plattformen), sollte nur
+ einen kleinen Text im ASCII- oder LaTeX-Format erstellen und rasch
+ an Stefan schicken, damit der ihn aufnehmen kann. Kontaktdetails
+ finden sich ebenfalls auf <a
+ href="http://www.skamphausen.de/xemacs">http://www.skamphausen.de/xemacs</a>.
</p>
- <h2>Help</h2>
+ <h2>Hilfe</h2>
<p>
- Falls Fragen auftauchen, schreibt ne Mail, vielleicht kann
- ich ja weiterhelfen. Falls jemand etwas verbessert oder
- Fehler findet (zB wäre es sehr schön, wenn es keine
- Handarbeit mehr geben würde, oder wenigstens weniger, um als
- User die Konfigurationsdateien zu benutzen), bitte
- auch mailen. Ansonsten viel Spaß damit!</p>
+ Die Einleitung versucht, Hilfe zur Selbsthilfe zu geben. Das mag
+ nicht immer genug sein. Stefan beantwortet aber EMail mit Fragen
+ normalerweise zügig und gerne :-).
+ </p>
- <h2>Weiteres</h2>
+ <h2>Epilog</h2>
<p>
- Autor: <em>Stefan Kamphausen</em></p>
-
+ Autor: <em>Stefan Kamphausen</em>
+ </p>
<p>
- Aktualität: Es mag vorkommen, dass Links von dieser
- Seite ins Leere laufen oder auf nicht mehr ganz aktuelle
- Versionen zeigen. In einem solchen Falle ist die
- aktuelle Dokumentation zu erreichen unter:</p>
-
- <p align="center">
- <a href="http://www.skamphausen.de/xemacs">http://www.skamphausen.de/xemacs</a></p>
-
+ Die Autoren der verlinkten Seiten tragen selber die Verantwortung
+ für die von ihnen bereitgestellten Inhalte.
+ </p>
<!-- Keep this comment at the end of the file
Local variables:
mode: xml
--
Adrian Aichner
mailto:adrian＠xemacs.org
http://www.xemacs.org/
- 1 participants
- 0 comments
Patcher 3.7 is released
20 years, 1 month
Didier Verna
Didier Verna
2004-11-27 Didier Verna <didier(a)lrde.epita.fr>
* Patcher 3.7 is released.
2004-11-15 Didier Verna <didier(a)xemacs.org>
* patcher.el (patcher-change-logs-loaded-by-us): Remove.
* patcher.el (patcher-change-logs): Turn into an alist.
* patcher.el (patcher-file-relative-name): Handle list as well as
string argument.
* patcher.el (patcher-files-string): Ditto.
* patcher.el (patcher-files-buffers): Ditto.
* patcher.el (patcher-diff-base): Handle `patcher-change-logs' as
an alist.
* patcher.el (patcher-generate-diff-1): Ditto.
* patcher.el (patcher-after-send): Ditto. Use it instead of
`patcher-change-logs-loaded-by-us'.
2004-11-15 Didier Verna <didier(a)xemacs.org>
From Ben Wing <ben(a)xemacs.org>
* patcher.el (patcher-generate-change-logs): Move point to the
beginning of the inserted entry so that it's sure to be visible.
Clean up code and use save-restriction.
* patcher.el (patcher-diff-base):
* patcher.el (patcher-after-send): Keep track of whether we loaded
a ChangeLog and hence can kill it.
2004-11-15 Didier Verna <didier(a)xemacs.org>
* patcher.el (patcher-mail-message): Remove (bogus) send-action
argument to message-mail call. It is handled by
message-exit-actions below.
--
Didier Verna, didier(a)lrde.epita.fr, http://www.lrde.epita.fr/~didier
EPITA / LRDE, 14-16 rue Voltaire Tel.+33 (1) 44 08 01 85
94276 Le Kremlin-Bicêtre, France Fax.+33 (1) 53 14 59 22 didier(a)xemacs.org
- 1 participants
- 0 comments
[C sjt-xft] fix a crash, minor cleanups
20 years, 1 month
Stephen J. Turnbull
Stephen J. Turnbull
COMMIT sjt-xft
Gr. Xft/fontconfig is typical X code: absolutely no argument
checking, but no documentation of what's acceptable, either.
Index: src/ChangeLog
===================================================================
RCS file: /Users/steve/Software/Repositories/cvs.xemacs.org/XEmacs/xemacs/src/ChangeLog,v
retrieving revision 1.758
diff -u -r1.758 ChangeLog
--- src/ChangeLog 2004/11/14 12:19:59 1.758
+++ src/ChangeLog 2004/11/27 02:38:38
＠＠ -1,3 +1,23 ＠＠
+2004-11-27 Stephen J. Turnbull <stephen(a)xemacs.org>
+
+ * xft-fonts.h: Declare debug_xft.
+
+ * objects-x.c (x_font_instance_truename):
+ Convert Xft* identifiers to Fc* versions.
+
+ (x_initialize_font_instance):
+ (x_find_charset_font):
+ Condition debugging on debug_xft. Get rid of unneeded "####
+ debug" markers. Change fprintf to stderr_out.
+
+ (x_find_charset_font): Restore missing argument to
+ DebugFcTypeOfValue. Remove nonworking debug cruft.
+
+ (FcResultToString):
+ (FcTypeOfValueToString):
+ (x_find_charset_font):
+ Change DebugFc* to Fc*ToString.
+
2004-11-12 Marcus Crestani <crestani(a)informatik.uni-tuebingen.de>
* Makefile.in.in: Fix pdump build for Cygwin.
Index: src/objects-x.c
===================================================================
RCS file: /Users/steve/Software/Repositories/cvs.xemacs.org/XEmacs/xemacs/src/objects-x.c,v
retrieving revision 1.26.2.1
diff -u -r1.26.2.1 objects-x.c
--- src/objects-x.c 2004/11/25 12:44:15 1.26.2.1
+++ src/objects-x.c 2004/11/27 02:36:53
＠＠ -212,8 +212,8 ＠＠
LISP_STRING_TO_EXTERNAL (f->name, extname, Qx_font_name_encoding);
- /* #### debug */
- stderr_out ("attempting to initialize font spec %s\n", extname);
+ if (debug_xft > 0)
+ stderr_out ("attempting to initialize font spec %s\n", extname);
/* #### serialize (optimize) these later... */
#ifdef USE_XFT
rf = xft_open_font_by_name (dpy, extname);
＠＠ -225,8 +225,8 ＠＠
/* #### should this refer to X and/or Xft? */
maybe_signal_error (Qgui_error, "Couldn't load font", f->name,
Qfont, errb);
- /* #### debug */
- stderr_out ("failed to initialize font spec %s\n", extname);
+ if (debug_xft > 0)
+ stderr_out ("failed to initialize font spec %s\n", extname);
return 0;
}
＠＠ -265,8 +265,8 ＠＠
f->height = rf->height;
/* #### is this right? See comment on proportional_p below. */
f->proportional_p = 1; /* we can't recognize monospaced fonts! */
- /* #### debug */
- stderr_out ("initialized Xft font %s\n", extname);
+ if (debug_xft > 0)
+ stderr_out ("initialized Xft font %s\n", extname);
}
else if (fs)
＠＠ -332,14 +332,15 ＠＠
f->proportional_p = (fs->min_bounds.width != fs->max_bounds.width ||
(x_handle_non_fully_specified_fonts &&
!fs->all_chars_exist));
- /* #### debug */
- stderr_out ("initialized Xft font %s\n", extname);
+ if (debug_xft > 0)
+ stderr_out ("initialized Xft font %s\n", extname);
}
- /* #### debug: check for weirdness */
+ /* #### check for weirdness */
if (f->height < f->width)
- stderr_out ("width of font %s is %d, larger than its height %d\n",
- extname, f->width, f->height);
+ if (debug_xft > 0)
+ stderr_out ("width of font %s is %d, larger than its height %d\n",
+ extname, f->width, f->height);
return 1;
}
＠＠ -689,27 +690,30 ＠＠
{
#ifdef USE_XFT
int core;
- XftPattern *pat = FONT_INSTANCE_X_XFTFONT (f)->pattern;
- XftResult res_xlfd = XftPatternGetString(pat, XFT_XLFD, 0, &xlfd);
- XftResult res_core = XftPatternGetBool(pat, XFT_CORE, 0, &core);
-
- if (res_xlfd == XftResultTypeMismatch || res_core == XftResultTypeMismatch)
+ FcPattern *pat = FONT_INSTANCE_X_XFTFONT (f)->pattern;
+ FcResult res_xlfd = FcPatternGetString (pat, XFT_XLFD, 0, &xlfd);
+ FcResult res_core = FcPatternGetBool (pat, XFT_CORE, 0, &core);
+
+ if (res_xlfd == FcResultTypeMismatch || res_core == FcResultTypeMismatch)
{
/* we've got an Xft font! */
- char temp[FCSTRLEN];
- int res = XftNameUnparse(pat, temp, FCSTRLEN-1);
- Lisp_Object name = (res ? make_string(temp, strlen(temp)) : Qnil);
+ FcChar8 *res = FcNameUnparse (pat);
+ Lisp_Object name = (res ? make_string (res, strlen (res)) : Qnil);
+ /* #### huh? device? Fc don' need no steekin' device! */
Lisp_Object real_pat = Ffc_font_real_pattern (name, f->device);
-
- res = XftNameUnparse(XFCPATTERN_PTR(real_pat), temp, FCSTRLEN-1);
- if (res)
+ free (res);
+
+ res = FcNameUnparse (XFCPATTERN_PTR(real_pat));
+ if (res)
{
- FONT_INSTANCE_TRUENAME (f) = make_string (temp, strlen(temp));
+ FONT_INSTANCE_TRUENAME (f) = make_string (res, strlen (res));
+ free (res);
return FONT_INSTANCE_TRUENAME (f);
}
else
{ /* Now we're f.... */
- maybe_signal_error (Qgui_error, "Couldn't determine font truename",
+ maybe_signal_error (Qgui_error,
+ "Couldn't determine font truename",
Qnil, Qfont, errb);
return Qnil;
}
＠＠ -912,7 +916,9 ＠＠
}
/* #### debug functions: find a better place for us */
-const char *DebugFcResult (FcResult r)
+const char *FcResultToString (FcResult r);
+const char *
+FcResultToString (FcResult r)
{
static char buffer[256];
switch (r)
＠＠ -931,7 +937,9 ＠＠
}
}
-const char *DebugFcTypeOfValue (FcValue v)
+const char *FcTypeOfValueToString (FcValue v);
+const char *
+FcTypeOfValueToString (FcValue v)
{
static char buffer[256];
switch (v.type)
＠＠ -985,61 +993,65 ＠＠
if (stage)
return Qnil;
- /* #### does Xft permit/require a different encoding?
- #### Xft or not, this is bogus: suppose the encoding is widechar? */
+ /* #### does Xft permit/require a different encoding? */
LISP_STRING_TO_EXTERNAL (font, patternext, Qx_font_name_encoding);
+ if (debug_xft > 0)
+ stderr_out ("confirming charset for font instance %s\n", patternext);
- /* #### debug */
- stderr_out ("confirming charset for font instance %s\n", patternext);
-
#ifdef USE_XFT
/* #### totally lazy, let's just get something out the door */
waste = FcInit ();
- /* #### debug */
- stderr_out ("%s fontconfig initialization\n",
- waste ? "Successful" : "Failed");
+ if (debug_xft > 1) /* I don't think this can fail */
+ stderr_out ("%s fontconfig initialization\n",
+ waste ? "Successful" : "Failed");
if (waste) /* #### should we init in xft_fonts_init()
and FcInitBringUpToDate() here? */
{
- FcChar8 *lang;
+ FcChar8 *lang = "en";
fcc = FcConfigGetCurrent ();
patternxft = FcNameParse (patternext);
/* #### Next four return FcBool, but what does the return mean? */
/* #### There's probably a way to do this with FcCharsets, but isn't
the language approach better in the long run? */
/* #### can we regression test this, or does it break too early? */
- stderr_out ("FcNameParse'ed name is %s\n", FcNameUnparse (patternxft));
+ if (debug_xft > 0)
+ stderr_out ("FcNameParse'ed name is %s\n",
+ FcNameUnparse (patternxft));
FcConfigSubstitute (fcc, patternxft, FcMatchFont);
- stderr_out ("FcConfigSubstitute'ed name is %s\n", FcNameUnparse (patternxft));
+ if (debug_xft > 0)
+ stderr_out ("FcConfigSubstitute'ed name is %s\n",
+ FcNameUnparse (patternxft));
FcDefaultSubstitute (patternxft);
- stderr_out ("FcDefaultSubstitute'ed name is %s\n", FcNameUnparse (patternxft));
+ if (debug_xft > 0)
+ stderr_out ("FcDefaultSubstitute'ed name is %s\n",
+ FcNameUnparse (patternxft));
if (EQ (charset, Fget_charset (intern ("katakana-jisx0201")))
|| EQ (charset, Fget_charset (intern ("japanese-jisx0208")))
|| EQ (charset, Fget_charset (intern ("japanese-jisx0212"))))
{
- /* #### debug */
- stderr_out ("checking if %s handles Japanese\n", patternext);
+ if (debug_xft > 0)
+ stderr_out ("checking if %s handles Japanese\n", patternext);
lang = "ja";
}
else if (EQ (charset, Fget_charset (intern ("ascii"))))
{
- /* #### debug */
- stderr_out ("checking if %s handles English\n", patternext);
+ if (debug_xft > 0)
+ stderr_out ("checking if %s handles English\n", patternext);
lang = "en";
}
-#if 0
- {
- /* #### debug stuff */
- /* NOTE: This will return IDENTICALLY ZERO most of the time because
- most fonts support multiple languages, but this is an exact test */
- FcObjectSet *fcos = FcObjectSetBuild (FC_FAMILY, FC_LANG, NULL);
- FcFontSet *fcfs = FcFontList (NULL, patternxft, fcos);
- stderr_out ("There are %d matches\n", fcfs->nfont);
- /* #### is *fcfs a memory leak? */
- FcObjectSetDestroy (fcos);
- }
-#endif
+ else
+ {
+ /* #### is this the right way to make a warning? */
+ warn_when_safe_lispobj (intern ("xft"), Qwarning,
+ list2 (build_string ("unknown charset"),
+ charset));
+ /* default to "en" */
+ }
+
patternxft = FcFontMatch (fcc, patternxft, &fcresult);
+ /* #### stderr_out crashed in the next block; why?
+ probably because FcTypeOfValueToString below didn't get
+ an argument!! Fixed now, but watch for crashes. */
{
int i = 0;
FcValue v;
＠＠ -1050,9 +1062,8 ＠＠
if (v.type == FcTypeLangSet && /* #### excessive paranoia */
FcLangSetHasLang (v.u.l, lang) != FcLangDifferentLang)
{
- /* #### debug */
- /* stderr_out crashed here; why? */
- fprintf (stderr, "Xft font %s supports %s\n", patternext, lang);
+ if (debug_xft > 0)
+ stderr_out ("Xft font %s supports %s\n", patternext, lang);
/* heuristic to give reasonable names */
FcPatternDel (patternxft, FC_CHARSET);
FcPatternDel (patternxft, FC_LANG);
＠＠ -1061,13 +1072,15 ＠＠
/* #### this is wrong, we should pass to X? */
else
{
- fprintf (stderr, "Unexpected type of lang value (%s)\n",
- DebugFcTypeOfValue);
+ if (debug_xft > 0)
+ stderr_out ("Unexpected type of lang value (%s)\n",
+ FcTypeOfValueToString (v));
return Qnil;
}
}
- fprintf (stderr, "Unexpected result getting lang (%s)\n",
- DebugFcResult (r));
+ if (debug_xft > 0)
+ stderr_out ("Unexpected result getting lang (%s)\n",
+ FcResultToString (r));
}
}
#endif
＠＠ -1076,8 +1089,8 ＠＠
patternext, MAX_FONT_COUNT, &count);
/* #### This code seems awfully bogus -- mrb */
/* #### fontconfig does it better -- sjt */
- /* #### debug */
- stderr_out ("shit happend, try X11 charset match for %s\n", patternext);
+ if (debug_xft > 0)
+ stderr_out ("shit happens, try X11 charset match for %s\n", patternext);
for (i = 0; i < count; i ++)
{
const Ibyte *intname;
Index: src/xft-fonts.h
===================================================================
RCS file: /Users/steve/Software/Repositories/cvs.xemacs.org/XEmacs/xemacs/src/Attic/xft-fonts.h,v
retrieving revision 1.1.2.1
diff -u -r1.1.2.1 xft-fonts.h
--- src/xft-fonts.h 2004/11/25 12:44:18 1.1.2.1
+++ src/xft-fonts.h 2004/11/26 13:17:58
＠＠ -44,6 +44,8 ＠＠
#include "../lwlib/lwlib-fonts.h"
#include "../lwlib/lwlib-colors.h"
+extern int debug_xft;
+
/* #### new in xft reloaded #3; where is this used? */
XftColor xft_get_color (Display *dpy, Colormap cmap, Lisp_Object c, int dim);
--
Institute of Policy and Planning Sciences http://turnbull.sk.tsukuba.ac.jp
University of Tsukuba Tennodai 1-1-1 Tsukuba 305-8573 JAPAN
Ask not how you can "do" free software business;
ask what your business can "do for" free software.
- 1 participants
- 0 comments