Thu Apr 15 03:13:54 PDT 2004

Committed by: eich

Update of /cvs/xorg/xc/extras/fontconfig/doc
In directory pdx:/home/eich/tstbuild/xc/extras/fontconfig/doc

Added Files:
      Tag: XORG-CURRENT
	FcAtomicCreate.3 FcAtomicDeleteNew.3 FcAtomicDestroy.3 
	FcAtomicLock.3 FcAtomicNewFile.3 FcAtomicOrigFile.3 
	FcAtomicReplaceOrig.3 FcAtomicUnlock.3 FcBlanksAdd.3 
	FcBlanksCreate.3 FcBlanksDestroy.3 FcBlanksIsMember.3 
	FcCharSetAddChar.3 FcCharSetCopy.3 FcCharSetCount.3 
	FcCharSetCreate.3 FcCharSetDestroy.3 FcCharSetEqual.3 
	FcCharSetFirstPage.3 FcCharSetHasChar.3 FcCharSetIntersect.3 
	FcCharSetIntersectCount.3 FcCharSetIsSubset.3 
	FcCharSetNextPage.3 FcCharSetSubtract.3 
	FcCharSetSubtractCount.3 FcCharSetUnion.3 
	FcConfigAppFontAddDir.3 FcConfigAppFontAddFile.3 
	FcConfigAppFontClear.3 FcConfigBuildFonts.3 FcConfigCreate.3 
	FcConfigDestroy.3 FcConfigFilename.3 FcConfigGetBlanks.3 
	FcConfigGetCache.3 FcConfigGetConfigDirs.3 
	FcConfigGetConfigFiles.3 FcConfigGetCurrent.3 
	FcConfigGetFontDirs.3 FcConfigGetFonts.3 
	FcConfigGetRescanInverval.3 FcConfigParseAndLoad.3 
	FcConfigSetCurrent.3 FcConfigSetRescanInverval.3 
	FcConfigSubstitute.3 FcConfigSubstituteWithPat.3 
	FcConfigUptoDate.3 FcDefaultSubstitute.3 FcDirCacheValid.3 
	FcDirSave.3 FcDirScan.3 FcFileScan.3 FcFontList.3 
	FcFontMatch.3 FcFontRenderPrepare.3 FcFontSetAdd.3 
	FcFontSetCreate.3 FcFontSetDestroy.3 FcFontSort.3 
	FcFreeTypeCharIndex.3 FcFreeTypeCharSet.3 FcFreeTypeQuery.3 
	FcGetVersion.3 FcInit.3 FcInitBringUptoDate.3 
	FcInitLoadConfig.3 FcInitLoadConfigAndFonts.3 
	FcInitReinitialize.3 FcMatrixCopy.3 FcMatrixEqual.3 
	FcMatrixInit.3 FcMatrixMultiply.3 FcMatrixRotate.3 
	FcMatrixScale.3 FcMatrixShear.3 FcNameConstant.3 
	FcNameGetConstant.3 FcNameGetObjectType.3 FcNameParse.3 
	FcNameRegisterConstants.3 FcNameRegisterObjectTypes.3 
	FcNameUnparse.3 FcNameUnregisterConstants.3 
	FcNameUnregisterObjectTypes.3 FcObjectSetAdd.3 
	FcObjectSetBuild.3 FcObjectSetCreate.3 FcObjectSetDestroy.3 
	FcPatternAdd-Type.3 FcPatternAdd.3 FcPatternAddWeak.3 
	FcPatternBuild.3 FcPatternCreate.3 FcPatternDel.3 
	FcPatternDestroy.3 FcPatternEqual.3 FcPatternEqualSubset.3 
	FcPatternGet-Type.3 FcPatternGet.3 FcPatternHash.3 
	FcPatternPrint.3 FcStrBasename.3 FcStrCmpIgnoreCase.3 
	FcStrCopy.3 FcStrCopyFilename.3 FcStrDirname.3 
	FcStrListCreate.3 FcStrListDone.3 FcStrListNext.3 
	FcStrSetAdd.3 FcStrSetAddFilename.3 FcStrSetCreate.3 
	FcStrSetDel.3 FcStrSetDestroy.3 FcStrSetMember.3 
	FcUcs4ToUtf8.3 FcUtf16Len.3 FcUtf16ToUcs4.3 FcUtf8Len.3 
	FcUtf8ToUcs4.3 FcValueDestroy.3 FcValueSave.3 Makefile.am 
	Makefile.in edit-sgml.c fcatomic.fncs fcblanks.fncs 
	fccharset.fncs fcconfig.fncs fcconstant.fncs fcfile.fncs 
	fcfontset.fncs fcfreetype.fncs fcinit.fncs fcmatrix.fncs 
	fcobjectset.fncs fcobjecttype.fncs fcpattern.fncs 
	fcstring.fncs fcstrset.fncs fcvalue.fncs fontconfig-devel.sgml 
	fontconfig-devel.txt fontconfig-user.html fontconfig-user.sgml 
	fontconfig-user.txt fonts-conf.5 func.sgml version.sgml.in 
Log Message:
2004-04-15  Egbert Eich  <eich at freedesktop.org>
        Merged changes from RELEASE-1 branch

--- NEW FILE: FcAtomicCreate.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcAtomicCreate" "3" "10 March 2004" "" ""

.SH NAME
FcAtomicCreate \- create an FcAtomic object
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcAtomic * FcAtomicCreate (const FcChar8   *\fIfile\fB);
\fR
.SH "DESCRIPTION"
.PP
Creates a data structure containing data needed to control access to \fIfile\fR.
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.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcAtomicDeleteNew.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcAtomicDeleteNew" "3" "10 March 2004" "" ""

.SH NAME
FcAtomicDeleteNew \- delete new file
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
void FcAtomicDeleteNew (FcAtomic *\fIatomic\fB);
\fR
.SH "DESCRIPTION"
.PP
Deletes the new file.  Used in error recovery to back out changes.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcAtomicDestroy.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcAtomicDestroy" "3" "10 March 2004" "" ""

.SH NAME
FcAtomicDestroy \- destroy an FcAtomic object
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
void FcAtomicDestroy (FcAtomic *\fIatomic\fB);
\fR
.SH "DESCRIPTION"
.PP
Destroys \fIatomic\fR.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcAtomicLock.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcAtomicLock" "3" "10 March 2004" "" ""

.SH NAME
FcAtomicLock \- lock a file
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcAtomicLock (FcAtomic *\fIatomic\fB);
\fR
.SH "DESCRIPTION"
.PP
Attempts to lock the file referenced by \fIatomic\fR.  Returns FcFalse if the
file is locked by another process, else returns FcTrue and leaves the file
locked.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcAtomicNewFile.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcAtomicNewFile" "3" "10 March 2004" "" ""

.SH NAME
FcAtomicNewFile \- return new temporary file name
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcChar8 * FcAtomicNewFile (FcAtomic *\fIatomic\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the filename for writing a new version of the file referenced
by \fIatomic\fR.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcAtomicOrigFile.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcAtomicOrigFile" "3" "10 March 2004" "" ""

.SH NAME
FcAtomicOrigFile \- return original file name
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcChar8 * FcAtomicOrigFile (FcAtomic *\fIatomic\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the file refernced by \fIatomic\fR.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcAtomicReplaceOrig.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcAtomicReplaceOrig" "3" "10 March 2004" "" ""

.SH NAME
FcAtomicReplaceOrig \- replace original with new
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcAtomicReplaceOrig (FcAtomic *\fIatomic\fB);
\fR
.SH "DESCRIPTION"
.PP
Replaces the original file referenced by \fIatomic\fR with the new file.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcAtomicUnlock.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcAtomicUnlock" "3" "10 March 2004" "" ""

.SH NAME
FcAtomicUnlock \- unlock a file
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
void FcAtomicUnlock (FcAtomic *\fIatomic\fB);
\fR
.SH "DESCRIPTION"
.PP
Unlocks the file.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcBlanksAdd.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcBlanksAdd" "3" "10 March 2004" "" ""

.SH NAME
FcBlanksAdd \- Add a character to an FcBlanks
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcBlanksAdd (FcBlanks *\fIb\fB, FcChar32\fIucs4\fB);
\fR
.SH "DESCRIPTION"
.PP
Adds a single character to an FcBlanks object, returning FcFalse
if this process ran out of memory.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcBlanksCreate.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcBlanksCreate" "3" "10 March 2004" "" ""

.SH NAME
FcBlanksCreate \- Create an FcBlanks
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBlanks * FcBlanksCreate (void\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
Creates an empty FcBlanks object.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcBlanksDestroy.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcBlanksDestroy" "3" "10 March 2004" "" ""

.SH NAME
FcBlanksDestroy \- Destroy and FcBlanks
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
void FcBlanksDestroy (FcBlanks *\fIb\fB);
\fR
.SH "DESCRIPTION"
.PP
Destroys an FcBlanks object, freeing any associated memory.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcBlanksIsMember.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcBlanksIsMember" "3" "10 March 2004" "" ""

.SH NAME
FcBlanksIsMember \- Query membership in an FcBlanks
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcBlanksIsMember (FcBlanks *\fIb\fB, FcChar32\fIucs4\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns whether the specified FcBlanks object contains the indicated Unicode
value.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcCharSetAddChar.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcCharSetAddChar" "3" "10 March 2004" "" ""

.SH NAME
FcCharSetAddChar \- Add a character to a charset
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcCharSetAddChar (FcCharSet *\fIfcs\fB, FcChar32\fIucs4\fB);
\fR
.SH "DESCRIPTION"
.PP
\fBFcCharSetAddChar\fR 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.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcCharSetCopy.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcCharSetCopy" "3" "10 March 2004" "" ""

.SH NAME
FcCharSetCopy \- Copy a charset
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcCharSet * FcCharSetCopy (FcCharSet *\fIsrc\fB);
\fR
.SH "DESCRIPTION"
.PP
Makes a copy of \fIsrc\fR; note that this may not actually do anything more
than increment the reference count on \fIsrc\fR.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcCharSetCount.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcCharSetCount" "3" "10 March 2004" "" ""

.SH NAME
FcCharSetCount \- Count entries in a charset
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcChar32 FcCharSetCount (const FcCharSet *\fIa\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the total number of unicode chars in \fIa\fR.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcCharSetCreate.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcCharSetCreate" "3" "10 March 2004" "" ""

.SH NAME
FcCharSetCreate \- Create an empty character set
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcCharSet * FcCharSetCreate (void\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
\fBFcCharSetCreate\fR allocates and initializes a new empty
character set object.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcCharSetDestroy.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcCharSetDestroy" "3" "10 March 2004" "" ""

.SH NAME
FcCharSetDestroy \- Destroy a character set
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
void FcCharSetDestroy (FcCharSet *\fIfcs\fB);
\fR
.SH "DESCRIPTION"
.PP
\fBFcCharSetDestroy\fR decrements the reference count 
\fIfcs\fR.  If the reference count becomes zero, all
memory referenced is freed.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcCharSetEqual.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcCharSetEqual" "3" "10 March 2004" "" ""

.SH NAME
FcCharSetEqual \- Compare two charsets
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcCharSetEqual (const FcCharSet *\fIa\fB, const FcCharSet *\fIb\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns whether \fIa\fR and \fIb\fR
contain the same set of unicode chars.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcCharSetFirstPage.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcCharSetFirstPage" "3" "10 March 2004" "" ""

.SH NAME
FcCharSetFirstPage \- Start enumerating charset contents
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcChar32 FcCharSetFirstPage (const FcCharSet *\fIa\fB, FcChar32[FC_CHARSET_MAP_SIZE]\fImap\fB, FcChar32 *\fInext\fB);
\fR
.SH "DESCRIPTION"
.PP
Builds an array of bits marking the first page of Unicode coverage of
\fIa\fR. Returns the base of the array. \fInext\fR contains the next page in the
font.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcCharSetHasChar.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcCharSetHasChar" "3" "10 March 2004" "" ""

.SH NAME
FcCharSetHasChar \- Check a charset for a char
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcCharSetHasChar (const FcCharSet *\fIfcs\fB, FcChar32\fIucs4\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns whether \fIfcs\fR contains the char \fIucs4\fR.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcCharSetIntersect.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcCharSetIntersect" "3" "10 March 2004" "" ""

.SH NAME
FcCharSetIntersect \- Intersect charsets
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcCharSet * FcCharSetIntersect (const FcCharSet *\fIa\fB, const FcCharSet *\fIb\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns a set including only those chars found in both
\fIa\fR and \fIb\fR.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcCharSetIntersectCount.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcCharSetIntersectCount" "3" "10 March 2004" "" ""

.SH NAME
FcCharSetIntersectCount \- Intersect and count charsets
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcChar32 FcCharSetIntersectCount (const FcCharSet *\fIa\fB, const FcCharSet *\fIb\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the number of chars that are in both \fIa\fR and \fIb\fR.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcCharSetIsSubset.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcCharSetIsSubset" "3" "10 March 2004" "" ""

.SH NAME
FcCharSetIsSubset \- Test for charset inclusion
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcCharSetIsSubset (const FcCharSet *\fIa\fB, const FcCharSet *\fIb\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns whether \fIa\fR is a subset of \fIb\fR.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcCharSetNextPage.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcCharSetNextPage" "3" "10 March 2004" "" ""

.SH NAME
FcCharSetNextPage \- Continue enumerating charset contents
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcChar32 FcCharSetNextPage (const FcCharSet *\fIa\fB, FcChar32[FC_CHARSET_MAP_SIZE]\fImap\fB, FcChar32 *\fInext\fB);
\fR
.SH "DESCRIPTION"
.PP
Builds an array of bits marking the Unicode coverage of \fIa\fR for page
\fI*next\fR. Returns the base of the array. \fInext\fR contains the next page in
the font.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcCharSetSubtract.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcCharSetSubtract" "3" "10 March 2004" "" ""

.SH NAME
FcCharSetSubtract \- Subtract charsets
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcCharSet * FcCharSetSubtract (const FcCharSet *\fIa\fB, const FcCharSet *\fIb\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns a set including only those chars found in \fIa\fR but not \fIb\fR.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcCharSetSubtractCount.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcCharSetSubtractCount" "3" "10 March 2004" "" ""

.SH NAME
FcCharSetSubtractCount \- Subtract and count charsets
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcChar32 FcCharSetSubtractCount (const FcCharSet *\fIa\fB, const FcCharSet *\fIb\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the number of chars that are in \fIa\fR but not in \fIb\fR.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcCharSetUnion.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcCharSetUnion" "3" "10 March 2004" "" ""

.SH NAME
FcCharSetUnion \- Add charsets
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcCharSet * FcCharSetUnion (const FcCharSet *\fIa\fB, const FcCharSet *\fIb\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns a set including only those chars found in either \fIa\fR or \fIb\fR.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcConfigAppFontAddDir.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcConfigAppFontAddDir" "3" "10 March 2004" "" ""

.SH NAME
FcConfigAppFontAddDir \- Add fonts from directory to font database
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcConfigAppFontAddDir (FcConfig *\fIconfig\fB, const char *\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
Scans the specified directory for fonts, adding each one found to the
application-specific set of fonts.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcConfigAppFontAddFile.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcConfigAppFontAddFile" "3" "10 March 2004" "" ""

.SH NAME
FcConfigAppFontAddFile \- Add font file to font database
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcConfigAppFontAddFile (FcConfig *\fIconfig\fB, const char *\fIfile\fB);
\fR
.SH "DESCRIPTION"
.PP
Adds an application-specific font to the configuration.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcConfigAppFontClear.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcConfigAppFontClear" "3" "10 March 2004" "" ""

.SH NAME
FcConfigAppFontClear \- Remove all app fonts from font database
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
void FcConfigAppFontClear (FcConfig *\fIconfig\fB);
\fR
.SH "DESCRIPTION"
.PP
Clears the set of application-specific fonts.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcConfigBuildFonts.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcConfigBuildFonts" "3" "10 March 2004" "" ""

.SH NAME
FcConfigBuildFonts \- Build font database
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcConfigBuildFonts (FcConfig *\fIconfig\fB);
\fR
.SH "DESCRIPTION"
.PP
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.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcConfigCreate.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcConfigCreate" "3" "10 March 2004" "" ""

.SH NAME
FcConfigCreate \- Create a configuration
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcConfig * FcConfigCreate (void\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
Creates an empty configuration.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcConfigDestroy.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcConfigDestroy" "3" "10 March 2004" "" ""

.SH NAME
FcConfigDestroy \- Destroy a configuration
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
void FcConfigDestroy (FcConfig *\fIconfig\fB);
\fR
.SH "DESCRIPTION"
.PP
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.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcConfigFilename.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcConfigFilename" "3" "10 March 2004" "" ""

.SH NAME
FcConfigFilename \- Find a config file
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
char * FcConfigFilename (const char *\fIname\fB);
\fR
.SH "DESCRIPTION"
.PP
Given the specified external entity name, return the associated filename.
This provides applications a way to convert various configuration file
references into filename form.
.PP
A null or empty \fIname\fR 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 \fI~\fR, 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.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcConfigGetBlanks.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcConfigGetBlanks" "3" "10 March 2004" "" ""

.SH NAME
FcConfigGetBlanks \- Get config blanks
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBlanks * FcConfigGetBlanks (FcConfig *\fIconfig\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the FcBlanks object associated with the given configuration, if no
blanks were present in the configuration, this function will return 0.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcConfigGetCache.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcConfigGetCache" "3" "10 March 2004" "" ""

.SH NAME
FcConfigGetCache \- Get cache filename
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
char * FcConfigGetCache (FcConfig *\fIconfig\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the name of the file used to store per-user font information.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcConfigGetConfigDirs.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcConfigGetConfigDirs" "3" "10 March 2004" "" ""

.SH NAME
FcConfigGetConfigDirs \- Get config directories
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcStrList * FcConfigGetConfigDirs (FcConfig *\fIconfig\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the list of font directories specified in the configuration files
for \fIconfig\fR.  Does not include any subdirectories.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcConfigGetConfigFiles.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcConfigGetConfigFiles" "3" "10 March 2004" "" ""

.SH NAME
FcConfigGetConfigFiles \- Get config files
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcStrList * FcConfigGetConfigFiles (FcConfig *\fIconfig\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the list of known configuration files used to generate \fIconfig\fR.
Note that this will not include any configuration done with FcConfigParse.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcConfigGetCurrent.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcConfigGetCurrent" "3" "10 March 2004" "" ""

.SH NAME
FcConfigGetCurrent \- Return current configuration
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcConfig * FcConfigGetCurrent (void\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the current default configuration.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcConfigGetFontDirs.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcConfigGetFontDirs" "3" "10 March 2004" "" ""

.SH NAME
FcConfigGetFontDirs \- Get font directories
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcStrList * FcConfigGetFontDirs (FcConfig *\fIconfig\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the list of font directories in \fIconfig\fR. This includes the
configured font directories along with any directories below those in the
filesystem.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcConfigGetFonts.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcConfigGetFonts" "3" "10 March 2004" "" ""

.SH NAME
FcConfigGetFonts \- Get config font set
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcFontSet * FcConfigGetFonts (FcConfig *\fIconfig\fB, FcSetName\fIset\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns one of the two sets of fonts from the configuration as specified
by \fIset\fR.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcConfigGetRescanInverval.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcConfigGetRescanInverval" "3" "10 March 2004" "" ""

.SH NAME
FcConfigGetRescanInverval \- Get config rescan interval
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
int FcConfigGetRescanInverval (FcConfig *\fIconfig\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the interval between automatic checks of the configuration (in
seconds) specified in \fIconfig\fR.  The configuration is checked during
a call to FcFontList when this interval has passed since the last check.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcConfigParseAndLoad.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcConfigParseAndLoad" "3" "10 March 2004" "" ""

.SH NAME
FcConfigParseAndLoad \- load a configuration file
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcConfigParseAndLoad (FcConfig *\fIconfig\fB, const FcChar8 *\fIfile\fB);
\fR
.SH "DESCRIPTION"
.PP
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.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcConfigSetCurrent.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcConfigSetCurrent" "3" "10 March 2004" "" ""

.SH NAME
FcConfigSetCurrent \- Set configuration as default
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcConfigSetCurrent (FcConfig *\fIconfig\fB);
\fR
.SH "DESCRIPTION"
.PP
Sets the current default configuration to \fIconfig\fR.  Implicitly calls
FcConfigBuildFonts if necessary, returning FcFalse if that call fails.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcConfigSetRescanInverval.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcConfigSetRescanInverval" "3" "10 March 2004" "" ""

.SH NAME
FcConfigSetRescanInverval \- Set config rescan interval
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcConfigSetRescanInverval (FcConfig *\fIconfig\fB, int\fIrescanInterval\fB);
\fR
.SH "DESCRIPTION"
.PP
Sets the rescan interval; returns FcFalse if an error occurred.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcConfigSubstitute.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcConfigSubstitute" "3" "10 March 2004" "" ""

.SH NAME
FcConfigSubstitute \- Execute substitutions
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcConfigSubstitute (FcConfig *\fIconfig\fB, FcPattern *\fIp\fB, FcMatchKind\fIkind\fB);
\fR
.SH "DESCRIPTION"
.PP
Calls FcConfigSubstituteWithPat setting p_pat to NULL.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcConfigSubstituteWithPat.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcConfigSubstituteWithPat" "3" "10 March 2004" "" ""

.SH NAME
FcConfigSubstituteWithPat \- Execute substitutions
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcConfigSubstituteWithPat (FcConfig *\fIconfig\fB, FcPattern *\fIp\fB, FcPattern *\fIp_pat\fB, FcMatchKind\fIkind\fB);
\fR
.SH "DESCRIPTION"
.PP
Performs the sequence of pattern modification operations, if \fIkind\fR is
FcMatchPattern, then those tagged as pattern operations are applied, else
if \fIkind\fR is FcMatchFont, those tagged as font operations are applied and
p_pat is used for <test> elements with target=pattern.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcConfigUptoDate.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcConfigUptoDate" "3" "10 March 2004" "" ""

.SH NAME
FcConfigUptoDate \- Check timestamps on config files
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcConfigUptoDate (FcConfig *\fIconfig\fB);
\fR
.SH "DESCRIPTION"
.PP
Checks all of the files related to \fIconfig\fR and returns whether the
in-memory version is in sync with the disk version.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcDefaultSubstitute.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcDefaultSubstitute" "3" "10 March 2004" "" ""

.SH NAME
FcDefaultSubstitute \- Perform default substitutions in a pattern
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
void FcDefaultSubstitute (FcPattern *\fIpattern\fB);
\fR
.SH "DESCRIPTION"
.PP
Supplies default values for underspecified font patterns:
.TP 0.2i
\(bu
Patterns without a specified style or weight are set to Medium
.TP 0.2i
\(bu
Patterns without a specified style or slant are set to Roman
.TP 0.2i
\(bu
Patterns without a specified pixel size are given one computed from any
specified point size (default 12), dpi (default 75) and scale (default 1).
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcDirCacheValid.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcDirCacheValid" "3" "10 March 2004" "" ""

.SH NAME
FcDirCacheValid \- check directory cache timestamp
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcDirCacheValid (const FcChar8 *\fIcache_file\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns FcTrue if \fIcache_file\fR is no older than the
directory containing it, else FcFalse.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcDirSave.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcDirSave" "3" "10 March 2004" "" ""

.SH NAME
FcDirSave \- save a directory cache
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcDirSave (FcFontSet *\fIset\fB, FcStrSet *\fIdirs\fB, const char *\fIdir\fB);
\fR
.SH "DESCRIPTION"
.PP
Creates the per-directory cache file for \fIdir\fR and
populates it with the fonts in \fIset\fR and subdirectories
in \fIdirs\fR.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcDirScan.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcDirScan" "3" "10 March 2004" "" ""

.SH NAME
FcDirScan \- scan a font directory
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcDirScan (FcFontSet *\fIset\fB, FcStrSet *\fIdirs\fB, FcFileCache *\fIcache\fB, FcBlanks *\fIblanks\fB, const char *\fIdir\fB, FcBool\fIforce\fB);
\fR
.SH "DESCRIPTION"
.PP
Scans an entire directory and adds all fonts found to
\fIset\fR.  If \fIforce\fR is FcTrue, then
the directory and all files within it are scanned even if information is
present in the per-directory cache file or \fIcache\fR.  Any
subdirectories found are added to \fIdirs\fR.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcFileScan.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcFileScan" "3" "10 March 2004" "" ""

.SH NAME
FcFileScan \- scan a font file
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcFileScan (FcFontSet *\fIset\fB, FcStrSet *\fIdirs\fB, FcFileCache *\fIcache\fB, FcBlanks *\fIblanks\fB, const char *\fIfile\fB, FcBool\fIforce\fB);
\fR
.SH "DESCRIPTION"
.PP
Scans a single file and adds all fonts found to \fIset\fR.
If \fIforce\fR is FcTrue, then the file is scanned even if
associated information is found in \fIcache\fR.  If
\fIfile\fR is a directory, it is added to
\fIdirs\fR.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcFontList.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcFontList" "3" "10 March 2004" "" ""

.SH NAME
FcFontList \- List fonts
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcFontSet * FcFontList (FcConfig *\fIconfig\fB, FcPattern *\fIp\fB, FcObjectSet *\fIos\fB);
\fR
.SH "DESCRIPTION"
.PP
Selects fonts matching \fIp\fR, creates patterns from those fonts containing
only the objects in \fIos\fR and returns the set of unique such patterns.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcFontMatch.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcFontMatch" "3" "10 March 2004" "" ""

.SH NAME
FcFontMatch \- Return best font
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcPattern * FcFontMatch (FcConfig *\fIconfig\fB, FcPattern *\fIp\fB, FcResult *\fIresult\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the font in \fIconfig\fR most close matching \fIp\fR.  This function
should be called only after FcConfigSubstitute and FcDefaultSubstitute have
been called for \fIp\fR; otherwise the results will not be correct.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcFontRenderPrepare.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcFontRenderPrepare" "3" "10 March 2004" "" ""

.SH NAME
FcFontRenderPrepare \- Prepare pattern for loading font file
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcPattern * FcFontRenderPrepare (FcConfig *\fIconfig\fB, FcPattern *\fIpat\fB, FcPattern *\fIfont\fB);
\fR
.SH "DESCRIPTION"
.PP
Creates a new pattern consisting of elements of \fIfont\fR not appearing
in \fIpat\fR, elements of \fIpat\fR not appearing in \fIfont\fR and the best matching
value from \fIpat\fR for elements appearing in both.  The result is passed to
FcConfigSubstitute with \fIkind\fR FcMatchFont and then returned.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcFontSetAdd.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcFontSetAdd" "3" "10 March 2004" "" ""

.SH NAME
FcFontSetAdd \- Add to a font set
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcFontSetAdd (FcFontSet *\fIs\fB, FcPattern *\fIfont\fB);
\fR
.SH "DESCRIPTION"
.PP
Adds a pattern to a font set.  Note that the pattern is not copied before
being inserted into the set.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcFontSetCreate.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcFontSetCreate" "3" "10 March 2004" "" ""

.SH NAME
FcFontSetCreate \- Create a font set
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcFontSet * FcFontSetCreate (void\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
Creates an empty font set.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcFontSetDestroy.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcFontSetDestroy" "3" "10 March 2004" "" ""

.SH NAME
FcFontSetDestroy \- Destroy a font set
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
void FcFontSetDestroy (FcFontSet *\fIs\fB);
\fR
.SH "DESCRIPTION"
.PP
Destroys a font set.  Note that this destroys any referenced patterns as
well.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcFontSort.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcFontSort" "3" "10 March 2004" "" ""

.SH NAME
FcFontSort \- Return list of matching fonts
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcFontSet * FcFontSort (FcConfig *\fIconfig\fB, FcPattern *\fIp\fB, FcBool\fItrim\fB, FcCharSet **\fIcsp\fB, FcResult *\fIresult\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the list of fonts sorted by closeness to \fIp\fR.  If \fItrim\fR 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 \fIcsp\fR, if \fIcsp\fR is not NULL.  This function
should be called only after FcConfigSubstitute and FcDefaultSubstitute have
been called for \fIp\fR; otherwise the results will not be correct.
.PP
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 \fIp\fR to
FcFontRenderPrepare which combines them into a complete pattern.
.PP
The FcFontSet returned by FcFontSort is destroyed by caling FcFontSetDestroy.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcFreeTypeCharIndex.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcFreeTypeCharIndex" "3" "10 March 2004" "" ""

.SH NAME
FcFreeTypeCharIndex \- map Unicode to glyph id
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
#include <fcfreetype.h>
.sp
FT_UInt FcFreeTypeCharIndex (FT_Face\fIface\fB, FcChar32\fIucs4\fB);
\fR
.SH "DESCRIPTION"
.PP
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.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcFreeTypeCharSet.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcFreeTypeCharSet" "3" "10 March 2004" "" ""

.SH NAME
FcFreeTypeCharSet \- compute unicode coverage
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
#include <fcfreetype.h>
.sp
FcCharSet * FcFreeTypeCharSet (FT_Face\fIface\fB, FcBlanks *\fIblanks\fB);
\fR
.SH "DESCRIPTION"
.PP
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.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcFreeTypeQuery.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcFreeTypeQuery" "3" "10 March 2004" "" ""

.SH NAME
FcFreeTypeQuery \- compute font file pattern
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
#include <fcfreetype.h>
.sp
FcPattern * FcFreeTypeQuery (const char *\fIfile\fB, int\fIid\fB, FcBlanks *\fIblanks\fB, int *\fIcount\fB);
\fR
.SH "DESCRIPTION"
.PP
Constructs a pattern representing the 'id'th font in 'file'.  The number
of fonts in 'file' is returned in 'count'.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcGetVersion.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcGetVersion" "3" "10 March 2004" "" ""

.SH NAME
FcGetVersion \- library version number
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
int FcGetVersion (void\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the version number of the library.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcInit.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcInit" "3" "10 March 2004" "" ""

.SH NAME
FcInit \- initialize fontconfig library
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcInit (void\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
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.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcInitBringUptoDate.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcInitBringUptoDate" "3" "10 March 2004" "" ""

.SH NAME
FcInitBringUptoDate \- reload configuration files if needed
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcInitBringUptoDate (void\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
Checks the rescan interval in the default configuration, checking the
configuration if the interval has passed and reloading the configuration if
when any changes are detected.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcInitLoadConfig.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcInitLoadConfig" "3" "10 March 2004" "" ""

.SH NAME
FcInitLoadConfig \- load configuration
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcConfig * FcInitLoadConfig (void\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
Loads the default configuration file and returns the resulting configuration.
Does not load any font information.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcInitLoadConfigAndFonts.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcInitLoadConfigAndFonts" "3" "10 March 2004" "" ""

.SH NAME
FcInitLoadConfigAndFonts \- load configuration and font data
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcConfig * FcInitLoadConfigAndFonts (void\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
Loads the default configuration file and builds information about the
available fonts.  Returns the resulting configuration.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcInitReinitialize.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcInitReinitialize" "3" "10 March 2004" "" ""

.SH NAME
FcInitReinitialize \- re-initialize library
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcInitReinitialize (void\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
Forces the default configuration file to be reloaded and resets the default
configuration.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcMatrixCopy.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcMatrixCopy" "3" "10 March 2004" "" ""

.SH NAME
FcMatrixCopy \- Copy a matrix
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
void FcMatrixCopy (const FcMatrix *\fImatrix\fB);
\fR
.SH "DESCRIPTION"
.PP
\fBFcMatrixCopy\fR allocates a new FcMatrix
and copies \fImat\fR into it.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcMatrixEqual.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcMatrixEqual" "3" "10 March 2004" "" ""

.SH NAME
FcMatrixEqual \- Compare two matrices
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
void FcMatrixEqual (const FcMatrix *\fImatrix1\fB, const FcMatrix *\fImatrix2\fB);
\fR
.SH "DESCRIPTION"
.PP
\fBFcMatrixEqual\fR compares \fImatrix1\fR
and \fImatrix2\fR returning FcTrue when they are equal and
FcFalse when they are not.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcMatrixInit.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcMatrixInit" "3" "10 March 2004" "" ""

.SH NAME
FcMatrixInit \- initialize an FcMatrix structure
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
void FcMatrixInit (FcMatrix *\fImatrix\fB);
\fR
.SH "DESCRIPTION"
.PP
\fBFcMatrixInit\fR initializes \fImatrix\fR
to the identity matrix.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcMatrixMultiply.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcMatrixMultiply" "3" "10 March 2004" "" ""

.SH NAME
FcMatrixMultiply \- Multiply matrices
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
void FcMatrixMultiply (FcMatrix *\fIresult\fB, const FcMatrix *\fImatrix1\fB, const FcMatrix *\fImatrix2\fB);
\fR
.SH "DESCRIPTION"
.PP
\fBFcMatrixMultiply\fR multiplies
\fImatrix1\fR and \fImatrix2\fR storing
the result in \fIresult\fR.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcMatrixRotate.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcMatrixRotate" "3" "10 March 2004" "" ""

.SH NAME
FcMatrixRotate \- Rotate a matrix
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
void FcMatrixRotate (FcMatrix *\fImatrix\fB, double\fIcos\fB, double\fIsin\fB);
\fR
.SH "DESCRIPTION"
.PP
\fBFcMatrixRotate\fR rotates \fImatrix\fR
by the angle who's sine is \fIsin\fR and cosine is
\fIcos\fR.  This is done by multiplying by the
matrix:

.nf
  cos -sin
  sin  cos
.fi
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcMatrixScale.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcMatrixScale" "3" "10 March 2004" "" ""

.SH NAME
FcMatrixScale \- Scale a matrix
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
void FcMatrixScale (FcMatrix *\fImatrix\fB, double\fIsx\fB, double\fIdy\fB);
\fR
.SH "DESCRIPTION"
.PP
\fBFcMatrixScale\fR multiplies \fImatrix\fR
x values by \fIsx\fR and y values by
\fIsy\fR.  This is done by multiplying by
the matrix:

.nf
   sx  0
   0   sy
.fi
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcMatrixShear.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcMatrixShear" "3" "10 March 2004" "" ""

.SH NAME
FcMatrixShear \- Shear a matrix
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
void FcMatrixShear (FcMatrix *\fImatrix\fB, double\fIsh\fB, double\fIsv\fB);
\fR
.SH "DESCRIPTION"
.PP
\fBFcMatrixShare\fR shears \fImatrix\fR
horizontally by \fIsh\fR and vertically by
\fIsv\fR.  This is done by multiplying by
the matrix:

.nf
  1  sh
  sv  1
.fi
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcNameConstant.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcNameConstant" "3" "10 March 2004" "" ""

.SH NAME
FcNameConstant \- Get the value for a symbolic constant
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcNameConstant (FcChar8 *\fIstring\fB, int *\fIresult\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns whether a symbolic constant with name \fIstring\fR is registered,
placing the value of the constant in \fIresult\fR if present.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcNameGetConstant.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcNameGetConstant" "3" "10 March 2004" "" ""

.SH NAME
FcNameGetConstant \- Lookup symbolic constant
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
const FcConstant * FcNameGetConstant (FcChar8 *\fIstring\fB);
\fR
.SH "DESCRIPTION"
.PP
Return the FcConstant structure related to symbolic constant \fIstring\fR.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcNameGetObjectType.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcNameGetObjectType" "3" "10 March 2004" "" ""

.SH NAME
FcNameGetObjectType \- Lookup an object type
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
const FcObjectType * FcNameGetObjectType (const char *\fIobject\fB);
\fR
.SH "DESCRIPTION"
.PP
Return the object type for the pattern element named \fIobject\fR.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcNameParse.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcNameParse" "3" "10 March 2004" "" ""

.SH NAME
FcNameParse \- Parse a pattern string
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcPattern * FcNameParse (const char *\fIname\fB);
\fR
.SH "DESCRIPTION"
.PP
Converts \fIname\fR from the standard text format described above into a pattern.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcNameRegisterConstants.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcNameRegisterConstants" "3" "10 March 2004" "" ""

.SH NAME
FcNameRegisterConstants \- Register symbolic constants
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcNameRegisterConstants (const FcConstant *\fIconsts\fB, int\fInconsts\fB);
\fR
.SH "DESCRIPTION"
.PP
Register \fInconsts\fR new symbolic constants.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcNameRegisterObjectTypes.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcNameRegisterObjectTypes" "3" "10 March 2004" "" ""

.SH NAME
FcNameRegisterObjectTypes \- Register object types
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcNameRegisterObjectTypes (const FcObjectType *\fItypes\fB, int\fIntype\fB);
\fR
.SH "DESCRIPTION"
.PP
Register \fIntype\fR new object types.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcNameUnparse.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcNameUnparse" "3" "10 March 2004" "" ""

.SH NAME
FcNameUnparse \- Convert a pattern back into a string that can be parsed
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcChar8 * FcNameUnparse (FcPattern *\fIpat\fB);
\fR
.SH "DESCRIPTION"
.PP
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.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcNameUnregisterConstants.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcNameUnregisterConstants" "3" "10 March 2004" "" ""

.SH NAME
FcNameUnregisterConstants \- Unregister symbolic constants
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcNameUnregisterConstants (const FcConstant *\fIconsts\fB, int\fInconsts\fB);
\fR
.SH "DESCRIPTION"
.PP
Unregister \fInconsts\fR symbolic constants.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcNameUnregisterObjectTypes.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcNameUnregisterObjectTypes" "3" "10 March 2004" "" ""

.SH NAME
FcNameUnregisterObjectTypes \- Unregister object types
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcNameUnregisterObjectTypes (const FcObjectType *\fItypes\fB, int\fIntype\fB);
\fR
.SH "DESCRIPTION"
.PP
Unregister \fIntype\fR object types.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcObjectSetAdd.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcObjectSetAdd" "3" "10 March 2004" "" ""

.SH NAME
FcObjectSetAdd \- Add to an object set
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcObjectSetAdd (FcObjectSet *\fIos\fB, const char *\fIobject\fB);
\fR
.SH "DESCRIPTION"
.PP
Adds a proprety name to the set.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcObjectSetBuild.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcObjectSetBuild" "3" "10 March 2004" "" ""

.SH NAME
FcObjectSetBuild, FcObjectSetVaBuild \- Build object set from args
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcObjectSet * FcObjectSetBuild (const char *\fIfirst\fB, ...\fI\fB);
.sp
FcObjectSet * FcObjectSetVaBuild (const char *\fIfirst\fB, va_list\fIva\fB);
\fR
.SH "DESCRIPTION"
.PP
These build an object set from a null-terminated list of property names.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcObjectSetCreate.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcObjectSetCreate" "3" "10 March 2004" "" ""

.SH NAME
FcObjectSetCreate \- Create an object set
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcObjectSet * FcObjectSetCreate (void\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
Creates an empty set.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcObjectSetDestroy.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcObjectSetDestroy" "3" "10 March 2004" "" ""

.SH NAME
FcObjectSetDestroy \- Destroy an object set
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
void FcObjectSetDestroy (FcObjectSet *\fIos\fB);
\fR
.SH "DESCRIPTION"
.PP
Destroys an object set.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcPatternAdd-Type.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcPatternAdd-Type" "3" "10 March 2004" "" ""

.SH NAME
FcPatternAddInteger, FcPatternAddDouble, FcPatternAddString, FcPatternAddMatrix, FcPatternAddCharSet, FcPatternAddBool \- Add a typed value to a pattern
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcPatternAddInteger (FcPattern *\fIp\fB, const char *\fIobject\fB, int\fIi\fB);
.sp
FcBool FcPatternAddDouble (FcPattern *\fIp\fB, const char *\fIobject\fB, double\fId\fB);
.sp
FcBool FcPatternAddString (FcPattern *\fIp\fB, const char *\fIobject\fB, const char *\fIs\fB);
.sp
FcBool FcPatternAddMatrix (FcPattern *\fIp\fB, const char *\fIobject\fB, const FcMatrix *\fIm\fB);
.sp
FcBool FcPatternAddCharSet (FcPattern *\fIp\fB, const char *\fIobject\fB, const FcCharSet *\fIc\fB);
.sp
FcBool FcPatternAddBool (FcPattern *\fIp\fB, const char *\fIobject\fB, FcBool\fIb\fB);
\fR
.SH "DESCRIPTION"
.PP
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.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcPatternAdd.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcPatternAdd" "3" "10 March 2004" "" ""

.SH NAME
FcPatternAdd \- Add a value to a pattern
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcPatternAdd (FcPattern *\fIp\fB, const char *\fIobject\fB, FcValue\fIvalue\fB, FcBool\fIappend\fB);
\fR
.SH "DESCRIPTION"
.PP
Adds a single value to the list of values associated with the property named
`object\fI.  If `append\fR 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.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcPatternAddWeak.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcPatternAddWeak" "3" "10 March 2004" "" ""

.SH NAME
FcPatternAddWeak \- Add a value to a pattern with weak binding
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcPatternAddWeak (FcPattern *\fIp\fB, const char *\fIobject\fB, FcValue\fIvalue\fB, FcBool\fIappend\fB);
\fR
.SH "DESCRIPTION"
.PP
FcPatternAddWeak is essentially the same as FcPatternAdd except that any
values added to the list have binding \fIweak\fR instead of \fIstrong\fR.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcPatternBuild.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcPatternBuild" "3" "10 March 2004" "" ""

.SH NAME
FcPatternBuild, FcPatternVaBuild \- Create patterns from arguments
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcPattern * FcPatternBuild (FcPattern *\fIorig\fB, ...\fI\fB);
.sp
FcPattern * FcPatternVaBuild (FcPattern *\fIorig\fB, va_list\fIva\fB);
\fR
.SH "DESCRIPTION"
.PP
Builds a pattern using a list of objects, types and values.  Each
value to be entered in the pattern is specified with three arguments:
.TP 3
1. 
Object name, a string describing the property to be added.
.TP 3
2. 
Object type, one of the FcType enumerated values
.TP 3
3. 
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.
.PP
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

.nf
pattern = FcPatternBuild (0, FC_FAMILY, FtTypeString, "Times", (char *) 0);
.fi
.PP
FcPatternVaBuild is used when the arguments are already in the form of a
varargs value.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcPatternCreate.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcPatternCreate" "3" "10 March 2004" "" ""

.SH NAME
FcPatternCreate \- Create a pattern
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcPattern * FcPatternCreate (void\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
Creates a pattern with no properties; used to build patterns from scratch.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcPatternDel.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcPatternDel" "3" "10 March 2004" "" ""

.SH NAME
FcPatternDel \- Delete a property from a pattern
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcPatternDel (FcPattern *\fIp\fB, const char *\fIobject\fB);
\fR
.SH "DESCRIPTION"
.PP
Deletes all values associated with the property `object', returning 
whether the property existed or not.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcPatternDestroy.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcPatternDestroy" "3" "10 March 2004" "" ""

.SH NAME
FcPatternDestroy \- Destroy a pattern
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
void FcPatternDestroy (FcPattern *\fIp\fB);
\fR
.SH "DESCRIPTION"
.PP
Destroys a pattern, in the process destroying all related values.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcPatternEqual.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcPatternEqual" "3" "10 March 2004" "" ""

.SH NAME
FcPatternEqual \- Compare patterns
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcPatternEqual (const FcPattern *\fIpa\fB, const FcPattern *\fIpb\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns whether \fIpa\fR and \fIpb\fR are exactly alike.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcPatternEqualSubset.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcPatternEqualSubset" "3" "10 March 2004" "" ""

.SH NAME
FcPatternEqualSubset \- Compare portions of patterns
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcPatternEqualSubset (const FcPattern *\fIpa\fB, const FcPattern *\fIpb\fB, const FcObjectSet *\fIos\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns whether \fIpa\fR and \fIpb\fR have exactly the same values for all of the
objects in \fIos\fR.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcPatternGet-Type.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcPatternGet-Type" "3" "10 March 2004" "" ""

.SH NAME
FcPatternGetInteger, FcPatternGetDouble, FcPatternGetString, FcPatternGetMatrix, FcPatternGetCharSet, FcPatternGetBool \- Return a typed value from a pattern
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcResult FcPatternGetInteger (FcPattern *\fIp\fB, const char *\fIobject\fB, int\fIn\fB, int *\fIi\fB);
.sp
FcResult FcPatternGetDouble (FcPattern *\fIp\fB, const char *\fIobject\fB, int\fIn\fB, double *\fId\fB);
.sp
FcResult FcPatternGetString (FcPattern *\fIp\fB, const char *\fIobject\fB, int\fIn\fB, char **const\fIs\fB);
.sp
FcResult FcPatternGetMatrix (FcPattern *\fIp\fB, const char *\fIobject\fB, int\fIn\fB, FcMatrix **\fIs\fB);
.sp
FcResult FcPatternGetCharSet (FcPattern *\fIp\fB, const char *\fIobject\fB, int\fIn\fB, FcCharSet **\fIc\fB);
.sp
FcResult FcPatternGetBool (FcPattern *\fIp\fB, const char *\fIobject\fB, int\fIn\fB, FcBool *\fIb\fB);
\fR
.SH "DESCRIPTION"
.PP
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.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcPatternGet.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcPatternGet" "3" "10 March 2004" "" ""

.SH NAME
FcPatternGet \- Return a value from a pattern
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcResult FcPatternGet (FcPattern *\fIp\fB, const char *\fIobject\fB, int\fIid\fB, FcValue *\fIv\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns in `v\fI the `id\fRth 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.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcPatternHash.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcPatternHash" "3" "10 March 2004" "" ""

.SH NAME
FcPatternHash \- Compute a pattern hash value
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcChar32 FcPatternHash (const FcPattern *\fIp\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns a 32-bit number which is the same for any two patterns which are
equal.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcPatternPrint.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcPatternPrint" "3" "10 March 2004" "" ""

.SH NAME
FcPatternPrint \- Print a pattern for debugging
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
void FcPatternPrint (const FcPattern *\fIp\fB);
\fR
.SH "DESCRIPTION"
.PP
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.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcStrBasename.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcStrBasename" "3" "10 March 2004" "" ""

.SH NAME
FcStrBasename \- last component of filename
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcChar8 * FcStrBasename (const FcChar8 *\fIfile\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the filename of \fIfile\fR stripped of any leading
directory names.  This is returned in newly allocated storage which should
be freed when no longer needed.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcStrCmpIgnoreCase.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcStrCmpIgnoreCase" "3" "10 March 2004" "" ""

.SH NAME
FcStrCmpIgnoreCase \- compare UTF-8 strings ignoring ASCII case
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
int FcStrCmpIgnoreCase (const char *\fIs1\fB, const char *\fIs2\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the usual <0, 0, >0 result of comparing
\fIs1\fR and \fIs2\fR.  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.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcStrCopy.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcStrCopy" "3" "10 March 2004" "" ""

.SH NAME
FcStrCopy \- duplicate a string
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcChar8 * FcStrCopy (const FcChar8 *\fIs\fB);
\fR
.SH "DESCRIPTION"
.PP
Allocates memory, copies \fIs\fR and returns the resulting
buffer.  Yes, this is \fBstrdup\fR, but that function isn't
available on every platform.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcStrCopyFilename.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcStrCopyFilename" "3" "10 March 2004" "" ""

.SH NAME
FcStrCopyFilename \- copy a string, expanding '~'
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcChar8 * FcStrCopyFilename (const FcChar8 *\fIs\fB);
\fR
.SH "DESCRIPTION"
.PP
Just like FcStrCopy except that it converts any leading '~' characters in
\fIs\fR to the value of the HOME environment variable.
Returns NULL if '~' is present in \fIs\fR and HOME is unset.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcStrDirname.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcStrDirname" "3" "10 March 2004" "" ""

.SH NAME
FcStrDirname \- directory part of filename
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcChar8 * FcStrDirname (const FcChar8 *\fIfile\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the directory containing \fIfile\fR.  This
is returned in newly allocated storage which should be freed when no longer
needed.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcStrListCreate.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcStrListCreate" "3" "10 March 2004" "" ""

.SH NAME
FcStrListCreate \- create a string iterator
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcStrList * FcStrListCreate (FcStrSet *\fIset\fB);
\fR
.SH "DESCRIPTION"
.PP
Creates an iterator to list the strings in \fIset\fR.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcStrListDone.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcStrListDone" "3" "10 March 2004" "" ""

.SH NAME
FcStrListDone \- destroy a string iterator
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
void FcStrListDone (FcStrList *\fIlist\fB);
\fR
.SH "DESCRIPTION"
.PP
Destroys the enumerator \fIlist\fR.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcStrListNext.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcStrListNext" "3" "10 March 2004" "" ""

.SH NAME
FcStrListNext \- get next string in iteration
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcChar8 * FcStrListNext (FcStrList *\fIlist\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns the next string in \fIset\fR.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcStrSetAdd.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcStrSetAdd" "3" "10 March 2004" "" ""

.SH NAME
FcStrSetAdd \- add to a string set
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcStrSetAdd (FcStrSet *\fIset\fB, const FcChar8 *\fIs\fB);
\fR
.SH "DESCRIPTION"
.PP
Adds a copy of \fIs\fR to \fIset\fR.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcStrSetAddFilename.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcStrSetAddFilename" "3" "10 March 2004" "" ""

.SH NAME
FcStrSetAddFilename \- add a filename to a string set
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcStrSetAddFilename (FcStrSet *\fIset\fB, const FcChar8 *\fIs\fB);
\fR
.SH "DESCRIPTION"
.PP
Adds a copy \fIs\fR to \fIset\fR, The copy
is created with FcStrCopyFilename so that leading '~' values are replaced
with the value of the HOME environment variable.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcStrSetCreate.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcStrSetCreate" "3" "10 March 2004" "" ""

.SH NAME
FcStrSetCreate \- create a string set
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcStrSet * FcStrSetCreate (void\fI\fB);
\fR
.SH "DESCRIPTION"
.PP
Create an empty set.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcStrSetDel.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcStrSetDel" "3" "10 March 2004" "" ""

.SH NAME
FcStrSetDel \- delete from a string set
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcStrSetDel (FcStrSet *\fIset\fB, const FcChar8 *\fIs\fB);
\fR
.SH "DESCRIPTION"
.PP
Removes \fIs\fR from \fIset\fR, returning
FcTrue if \fIs\fR was a member else FcFalse.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcStrSetDestroy.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcStrSetDestroy" "3" "10 March 2004" "" ""

.SH NAME
FcStrSetDestroy \- destroy a string set
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
void FcStrSetDestroy (FcStrSet *\fIset\fB);
\fR
.SH "DESCRIPTION"
.PP
Destroys \fIset\fR.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcStrSetMember.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcStrSetMember" "3" "10 March 2004" "" ""

.SH NAME
FcStrSetMember \- check set for membership
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcStrSetMember (FcStrSet *\fIset\fB, const FcChar8 *\fIs\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns whether \fIs\fR is a member of
\fIset\fR.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcUcs4ToUtf8.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcUcs4ToUtf8" "3" "10 March 2004" "" ""

.SH NAME
FcUcs4ToUtf8 \- convert UCS4 to UTF-8
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
int FcUcs4ToUtf8 (FcChar32\fIsrc\fB, FcChar8\fIdst[FC_UTF8_MAX_LEN]\fB);
\fR
.SH "DESCRIPTION"
.PP
Converts the Unicode char from \fIsrc\fR into
\fIdst\fR and returns the number of bytes needed to encode
the char.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcUtf16Len.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcUtf16Len" "3" "10 March 2004" "" ""

.SH NAME
FcUtf16Len \- count UTF-16 encoded chars
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcUtf16Len (FcChar8 *\fIsrc\fB, FcEndian\fIendian\fB, int\fIlen\fB, int *\fInchar\fB, int *\fIwchar\fB);
\fR
.SH "DESCRIPTION"
.PP
Counts the number of Unicode chars in \fIlen\fR bytes of
\fIsrc\fR.  Bytes of \fIsrc\fR are
combined into 16-bit units according to \fIendian\fR.
Places that count in \fInchar\fR.
\fIwchar\fR contains 1, 2 or 4 depending on the number of
bytes needed to hold the largest unicode char counted.  The return value
indicates whether \fIstring\fR is a well-formed UTF16
string.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcUtf16ToUcs4.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcUtf16ToUcs4" "3" "10 March 2004" "" ""

.SH NAME
FcUtf16ToUcs4 \- convert UTF-16 to UCS4
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
int FcUtf16ToUcs4 (FcChar8 *\fIsrc\fB, FcEndian\fIendian\fB, FcChar32 *\fIdst\fB, int\fIlen\fB);
\fR
.SH "DESCRIPTION"
.PP
Converts the next Unicode char from \fIsrc\fR into
\fIdst\fR and returns the number of bytes containing the
char. \fIsrc\fR must be at least \fIlen\fR
bytes long.  Bytes of \fIsrc\fR are combined into 16-bit
units according to \fIendian\fR.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcUtf8Len.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcUtf8Len" "3" "10 March 2004" "" ""

.SH NAME
FcUtf8Len \- count UTF-8 encoded chars
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcBool FcUtf8Len (FcChar8 *\fIsrc\fB, int\fIlen\fB, int *\fInchar\fB, int *\fIwchar\fB);
\fR
.SH "DESCRIPTION"
.PP
Counts the number of Unicode chars in \fIlen\fR bytes of
\fIsrc\fR.  Places that count in
\fInchar\fR.  \fIwchar\fR contains 1, 2 or
4 depending on the number of bytes needed to hold the largest unicode char
counted.  The return value indicates whether \fIsrc\fR is a
well-formed UTF8 string.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcUtf8ToUcs4.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcUtf8ToUcs4" "3" "10 March 2004" "" ""

.SH NAME
FcUtf8ToUcs4 \- convert UTF-8 to UCS4
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
int FcUtf8ToUcs4 (FcChar8 *\fIsrc\fB, FcChar32 *\fIdst\fB, int\fIlen\fB);
\fR
.SH "DESCRIPTION"
.PP
Converts the next Unicode char from \fIsrc\fR into
\fIdst\fR and returns the number of bytes containing the
char.  \fIsrc\fR nust be at least
\fIlen\fR bytes long.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcValueDestroy.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcValueDestroy" "3" "10 March 2004" "" ""

.SH NAME
FcValueDestroy \- Free a value
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
void FcValueDestroy (FcValue\fIv\fB);
\fR
.SH "DESCRIPTION"
.PP
Frees any memory referenced by \fIv\fR.  Values of type FcTypeString,
FcTypeMatrix and FcTypeCharSet reference memory, the other types do not.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: FcValueSave.3 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FcValueSave" "3" "10 March 2004" "" ""

.SH NAME
FcValueSave \- Copy a value
.SH SYNOPSIS
.sp
\fB#include <fontconfig.h>
.sp
FcValue FcValueSave (FcValue\fIv\fB);
\fR
.SH "DESCRIPTION"
.PP
Returns a copy of \fIv\fR duplicating any object referenced by it so that \fIv\fR
may be safely destroyed without harming the new value.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: Makefile.am ---
DOC_SRC = $(srcdir)
DOC_MODULE = fontconfig
DOC2HTML = docbook2html
DOC2TXT = docbook2txt
DOC2MAN = docbook2man

TXT = fontconfig-user.txt fontconfig-devel.txt
HTML_FILES = fontconfig-user.html
HTML_DIRS = fontconfig-devel
SGML = fontconfig-user.sgml fontconfig-devel.sgml
FNCS_TMPL = ${DOC_SRC}/func.sgml

DOC_FUNCS_FNCS=\
	fcatomic.fncs \
	fcblanks.fncs \
	fccharset.fncs \
	fcconfig.fncs \
	fcconstant.fncs \
	fcfile.fncs \
	fcfontset.fncs \
	fcfreetype.fncs \
	fcinit.fncs \
	fcmatrix.fncs \
	fcobjectset.fncs \
	fcobjecttype.fncs \
	fcpattern.fncs \
	fcstring.fncs \
	fcstrset.fncs \
	fcvalue.fncs

DOC_FUNCS_SGML=\
	fcatomic.sgml \
	fcblanks.sgml \
	fccharset.sgml \
	fcconfig.sgml \
	fcconstant.sgml \
	fcfile.sgml \
	fcfontset.sgml \
	fcfreetype.sgml \
	fcinit.sgml \
	fcmatrix.sgml \
	fcobjectset.sgml \
	fcobjecttype.sgml \
	fcpattern.sgml \
	fcstring.sgml \
	fcstrset.sgml \
	fcvalue.sgml

man_MANS=fonts-conf.5 \
FcAtomicCreate.3 FcAtomicDeleteNew.3 FcAtomicDestroy.3 FcAtomicLock.3 \
FcAtomicNewFile.3 FcAtomicOrigFile.3 FcAtomicReplaceOrig.3 FcAtomicUnlock.3 \
FcBlanksAdd.3 FcBlanksCreate.3 FcBlanksDestroy.3 FcBlanksIsMember.3 \
FcCharSetAddChar.3 FcCharSetCopy.3 FcCharSetCount.3 FcCharSetCreate.3 \
FcCharSetDestroy.3 FcCharSetEqual.3 FcCharSetFirstPage.3 FcCharSetHasChar.3 \
FcCharSetIntersect.3 FcCharSetIntersectCount.3 FcCharSetIsSubset.3 \
FcCharSetNextPage.3 FcCharSetSubtract.3 FcCharSetSubtractCount.3 \
FcCharSetUnion.3 FcConfigAppFontAddDir.3 FcConfigAppFontAddFile.3 \
FcConfigAppFontClear.3 FcConfigBuildFonts.3 FcConfigCreate.3 \
FcConfigDestroy.3 FcConfigFilename.3 FcConfigGetBlanks.3 FcConfigGetCache.3 \
FcConfigGetConfigDirs.3 FcConfigGetConfigFiles.3 FcConfigGetCurrent.3 \
FcConfigGetFontDirs.3 FcConfigGetFonts.3 FcConfigGetRescanInverval.3 \
FcConfigParseAndLoad.3 FcConfigSetCurrent.3 FcConfigSetRescanInverval.3 \
FcConfigSubstitute.3 FcConfigSubstituteWithPat.3 FcConfigUptoDate.3 \
FcDefaultSubstitute.3 FcDirCacheValid.3 FcDirSave.3 FcDirScan.3 FcFileScan.3 \
FcFontList.3 FcFontMatch.3 FcFontRenderPrepare.3 FcFontSetAdd.3 \
FcFontSetCreate.3 FcFontSetDestroy.3 FcFontSort.3 FcFreeTypeCharIndex.3 \
FcFreeTypeCharSet.3 FcFreeTypeQuery.3 FcGetVersion.3 FcInit.3 \
FcInitBringUptoDate.3 FcInitLoadConfig.3 FcInitLoadConfigAndFonts.3 \
FcInitReinitialize.3 FcMatrixCopy.3 FcMatrixEqual.3 FcMatrixInit.3 \
FcMatrixMultiply.3 FcMatrixRotate.3 FcMatrixScale.3 FcMatrixShear.3 \
FcNameConstant.3 FcNameGetConstant.3 FcNameGetObjectType.3 FcNameParse.3 \
FcNameRegisterConstants.3 FcNameRegisterObjectTypes.3 FcNameUnparse.3 \
FcNameUnregisterConstants.3 FcNameUnregisterObjectTypes.3 FcObjectSetAdd.3 \
FcObjectSetBuild.3 FcObjectSetCreate.3 FcObjectSetDestroy.3 \
FcPatternAdd-Type.3 FcPatternAdd.3 FcPatternAddWeak.3 FcPatternBuild.3 \
FcPatternCreate.3 FcPatternDel.3 FcPatternDestroy.3 FcPatternEqual.3 \
FcPatternEqualSubset.3 FcPatternGet-Type.3 FcPatternGet.3 FcPatternHash.3 \
FcPatternPrint.3 FcStrBasename.3 FcStrCmpIgnoreCase.3 FcStrCopy.3 \
FcStrCopyFilename.3 FcStrDirname.3 FcStrListCreate.3 FcStrListDone.3 \
FcStrListNext.3 FcStrSetAdd.3 FcStrSetAddFilename.3 FcStrSetCreate.3 \
FcStrSetDel.3 FcStrSetDestroy.3 FcStrSetMember.3 FcUcs4ToUtf8.3 FcUtf16Len.3 \
FcUtf16ToUcs4.3 FcUtf8Len.3 FcUtf8ToUcs4.3 FcValueDestroy.3 FcValueSave.3

noinst_PROGRAMS=edit-sgml
edit_sgml_SOURCES=edit-sgml.c

DOCDIR=@DOCDIR@

DOC_FILES=$(TXT) $(HTML_FILES)
DOC_DIRS=$(HTML_DIRS)
LOCAL_DOCS=$(man_MANS) $(DOC_FILES) $(DOC_DIRS)

EXTRA_DIST = $(LOCAL_DOCS) $(SGML) $(DOC_FUNCS_FNCS) $(FNCS_TMPL)

SUFFIXES=.fncs .sgml .txt .html

if ENABLE_DOCS

.fncs.sgml:
	$(RM) $@
	./edit-sgml $(FNCS_TMPL) < '$<' > $*.sgml

.sgml.txt:
	$(RM) $@
	$(DOC2TXT) $<

$(man_MANS): func.refs

func.refs: local-fontconfig-devel.sgml $(DOC_FUNCS_SGML) version.sgml
	$(RM) func.refs
	$(DOC2MAN) local-fontconfig-devel.sgml
	mv manpage.refs func.refs
	$(RM) manpage.links

$(DOC_FUNCS_SGML): edit-sgml $(FNCS_TMPL)

fonts-conf.5: local-fontconfig-user.sgml version.sgml
	$(RM) file.refs
	$(DOC2MAN) local-fontconfig-user.sgml
	$(RM) manpage.refs manpage.links

local-fontconfig-user.sgml: fontconfig-user.sgml
	$(LN_S) $< $@

all-local: $(LOCAL_DOCS)

clean-local:
	$(RM) $(man_MANS) $(DOC_FILES) $(DOC_FUNCS_SGML) func.refs
	$(RM) -r $(DOC_DIRS)

fontconfig-devel: local-fontconfig-devel.sgml $(DOCS_FUNCS_SGML) version.sgml
	$(RM) -r fontconfig-devel
	$(DOC2HTML) -o fontconfig-devel local-fontconfig-devel.sgml

local-fontconfig-devel.sgml: fontconfig-devel.sgml
	$(LN_S) $< $@

fontconfig-devel.txt: local-fontconfig-devel.sgml version.sgml
	$(RM) $@
	$(DOC2TXT) local-fontconfig-devel.sgml
	mv local-fontconfig-devel.txt $@

fontconfig-user.html: local-fontconfig-user.sgml version.sgml
	$(RM) $@ local-$@ $@.tmp
	$(DOC2HTML) -u local-fontconfig-user.sgml > $@.tmp
	-test -f local-$@ && mv local-$@ $@
	-test -f $@ || mv $@.tmp $@
	-test -f $@.tmp && $(RM) $@.tmp

fontconfig-user.txt:  local-fontconfig-user.sgml version.sgml
	$(RM) $@
	$(DOC2TXT) local-fontconfig-user.sgml
	mv local-fontconfig-user.txt $@

CLEANFILES=confdir.sgml local-fontconfig-user.sgml local-fontconfig-devel.sgml

else
all-local:
clean-local:
endif

install-data-local:
	$(mkinstalldirs) $(DESTDIR)$(DOCDIR)
	for i in $(DOC_FILES); do \
	  echo '-- Installing '$$i ; \
	  $(INSTALL_DATA) $$i $(DESTDIR)$(DOCDIR)/$$i; \
	done
	for i in $(DOC_DIRS); do \
	  $(mkinstalldirs) $(DESTDIR)$(DOCDIR)/$$i ; \
	  for f in $$i/*; do \
	    echo '-- Installing '$$f ; \
	    $(INSTALL_DATA) $$f $(DESTDIR)$(DOCDIR)/$$f; \
	  done \
	done

--- NEW FILE: Makefile.in ---
# Makefile.in generated by automake 1.7.9 from Makefile.am.
# @configure_input@

# Copyright 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003
# Free Software Foundation, Inc.
# This Makefile.in is free software; the Free Software Foundation
# gives unlimited permission to copy and/or distribute it,
# with or without modifications, as long as this notice is preserved.

# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY, to the extent permitted by law; without
# even the implied warranty of MERCHANTABILITY or FITNESS FOR A
# PARTICULAR PURPOSE.

@SET_MAKE@

srcdir = @srcdir@
top_srcdir = @top_srcdir@
VPATH = @srcdir@
pkgdatadir = $(datadir)/@PACKAGE@
pkglibdir = $(libdir)/@PACKAGE@
pkgincludedir = $(includedir)/@PACKAGE@
top_builddir = ..

am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd
INSTALL = @INSTALL@
install_sh_DATA = $(install_sh) -c -m 644
install_sh_PROGRAM = $(install_sh) -c
install_sh_SCRIPT = $(install_sh) -c
INSTALL_HEADER = $(INSTALL_DATA)
transform = $(program_transform_name)
NORMAL_INSTALL = :
PRE_INSTALL = :
POST_INSTALL = :
NORMAL_UNINSTALL = :
PRE_UNINSTALL = :
POST_UNINSTALL = :
host_triplet = @host@
ACLOCAL = @ACLOCAL@
AMDEP_FALSE = @AMDEP_FALSE@
AMDEP_TRUE = @AMDEP_TRUE@
AMTAR = @AMTAR@
AR = @AR@
AS = @AS@
AUTOCONF = @AUTOCONF@
AUTOHEADER = @AUTOHEADER@
AUTOMAKE = @AUTOMAKE@
AWK = @AWK@
CC = @CC@
CCDEPMODE = @CCDEPMODE@
CFLAGS = @CFLAGS@
CONFDIR = @CONFDIR@
CPP = @CPP@
CPPFLAGS = @CPPFLAGS@
CXX = @CXX@
CXXCPP = @CXXCPP@
CXXDEPMODE = @CXXDEPMODE@
CXXFLAGS = @CXXFLAGS@
CYGPATH_W = @CYGPATH_W@
DEFS = @DEFS@
DEPDIR = @DEPDIR@
DLLTOOL = @DLLTOOL@

DOCDIR = @DOCDIR@
ECHO = @ECHO@
ECHO_C = @ECHO_C@
ECHO_N = @ECHO_N@
ECHO_T = @ECHO_T@
EGREP = @EGREP@
ENABLE_DOCS_FALSE = @ENABLE_DOCS_FALSE@
ENABLE_DOCS_TRUE = @ENABLE_DOCS_TRUE@
EXEEXT = @EXEEXT@
EXPAT_CFLAGS = @EXPAT_CFLAGS@
EXPAT_LIBS = @EXPAT_LIBS@
F77 = @F77@
FC_ADD_FONTS = @FC_ADD_FONTS@
FC_DEFAULT_FONTS = @FC_DEFAULT_FONTS@
FC_FONTDATE = @FC_FONTDATE@
FC_FONTPATH = @FC_FONTPATH@
FFLAGS = @FFLAGS@
FREETYPE_CFLAGS = @FREETYPE_CFLAGS@
FREETYPE_LIBS = @FREETYPE_LIBS@
HASDOCBOOK = @HASDOCBOOK@
HAVE_EXPAT = @HAVE_EXPAT@
HAVE_XMLPARSE_H = @HAVE_XMLPARSE_H@
INSTALL_DATA = @INSTALL_DATA@
INSTALL_PROGRAM = @INSTALL_PROGRAM@
INSTALL_SCRIPT = @INSTALL_SCRIPT@
INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@
LDFLAGS = @LDFLAGS@
LIBOBJS = @LIBOBJS@
LIBS = @LIBS@
LIBTOOL = @LIBTOOL@
LN_S = @LN_S@
LTLIBOBJS = @LTLIBOBJS@
LT_CURRENT = @LT_CURRENT@
LT_CURRENT_MINUS_AGE = @LT_CURRENT_MINUS_AGE@
LT_REVISION = @LT_REVISION@
LT_VERSION_INFO = @LT_VERSION_INFO@
MAKEINFO = @MAKEINFO@
MS_LIB_AVAILABLE_FALSE = @MS_LIB_AVAILABLE_FALSE@
MS_LIB_AVAILABLE_TRUE = @MS_LIB_AVAILABLE_TRUE@
OBJDUMP = @OBJDUMP@
OBJEXT = @OBJEXT@
ORTH_FILES = @ORTH_FILES@
OS_WIN32_FALSE = @OS_WIN32_FALSE@
OS_WIN32_TRUE = @OS_WIN32_TRUE@
PACKAGE = @PACKAGE@
PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@
PACKAGE_NAME = @PACKAGE_NAME@
PACKAGE_STRING = @PACKAGE_STRING@
PACKAGE_TARNAME = @PACKAGE_TARNAME@
PACKAGE_VERSION = @PACKAGE_VERSION@
PATH_SEPARATOR = @PATH_SEPARATOR@
RANLIB = @RANLIB@
SET_MAKE = @SET_MAKE@
SHELL = @SHELL@
STRIP = @STRIP@
VERSION = @VERSION@
ac_ct_AR = @ac_ct_AR@
ac_ct_AS = @ac_ct_AS@
ac_ct_CC = @ac_ct_CC@
ac_ct_CXX = @ac_ct_CXX@
ac_ct_DLLTOOL = @ac_ct_DLLTOOL@
ac_ct_F77 = @ac_ct_F77@
ac_ct_OBJDUMP = @ac_ct_OBJDUMP@
ac_ct_RANLIB = @ac_ct_RANLIB@
ac_ct_STRIP = @ac_ct_STRIP@
am__fastdepCC_FALSE = @am__fastdepCC_FALSE@
am__fastdepCC_TRUE = @am__fastdepCC_TRUE@
am__fastdepCXX_FALSE = @am__fastdepCXX_FALSE@
am__fastdepCXX_TRUE = @am__fastdepCXX_TRUE@
am__include = @am__include@
am__leading_dot = @am__leading_dot@
am__quote = @am__quote@
bindir = @bindir@
build = @build@
build_alias = @build_alias@
build_cpu = @build_cpu@
build_os = @build_os@
build_vendor = @build_vendor@
confdir = @confdir@
datadir = @datadir@
exec_prefix = @exec_prefix@
ft_config = @ft_config@
host = @host@
host_alias = @host_alias@
host_cpu = @host_cpu@
host_os = @host_os@
host_vendor = @host_vendor@
includedir = @includedir@
infodir = @infodir@
install_sh = @install_sh@
libdir = @libdir@
libexecdir = @libexecdir@
localstatedir = @localstatedir@
mandir = @mandir@
ms_librarian = @ms_librarian@
oldincludedir = @oldincludedir@
prefix = @prefix@
program_transform_name = @program_transform_name@
sbindir = @sbindir@
sharedstatedir = @sharedstatedir@
sysconfdir = @sysconfdir@
target_alias = @target_alias@
DOC_SRC = $(srcdir)
DOC_MODULE = fontconfig
DOC2HTML = docbook2html
DOC2TXT = docbook2txt
DOC2MAN = docbook2man

TXT = fontconfig-user.txt fontconfig-devel.txt
HTML_FILES = fontconfig-user.html
HTML_DIRS = fontconfig-devel
SGML = fontconfig-user.sgml fontconfig-devel.sgml
FNCS_TMPL = ${DOC_SRC}/func.sgml

DOC_FUNCS_FNCS = \
	fcatomic.fncs \
	fcblanks.fncs \
	fccharset.fncs \
	fcconfig.fncs \
	fcconstant.fncs \
	fcfile.fncs \
	fcfontset.fncs \
	fcfreetype.fncs \
	fcinit.fncs \
	fcmatrix.fncs \
	fcobjectset.fncs \
	fcobjecttype.fncs \
	fcpattern.fncs \
	fcstring.fncs \
	fcstrset.fncs \
	fcvalue.fncs

DOC_FUNCS_SGML = \
	fcatomic.sgml \
	fcblanks.sgml \
	fccharset.sgml \
	fcconfig.sgml \
	fcconstant.sgml \
	fcfile.sgml \
	fcfontset.sgml \
	fcfreetype.sgml \
	fcinit.sgml \
	fcmatrix.sgml \
	fcobjectset.sgml \
	fcobjecttype.sgml \
	fcpattern.sgml \
	fcstring.sgml \
	fcstrset.sgml \
	fcvalue.sgml

man_MANS = fonts-conf.5 \
FcAtomicCreate.3 FcAtomicDeleteNew.3 FcAtomicDestroy.3 FcAtomicLock.3 \
FcAtomicNewFile.3 FcAtomicOrigFile.3 FcAtomicReplaceOrig.3 FcAtomicUnlock.3 \
FcBlanksAdd.3 FcBlanksCreate.3 FcBlanksDestroy.3 FcBlanksIsMember.3 \
FcCharSetAddChar.3 FcCharSetCopy.3 FcCharSetCount.3 FcCharSetCreate.3 \
FcCharSetDestroy.3 FcCharSetEqual.3 FcCharSetFirstPage.3 FcCharSetHasChar.3 \
FcCharSetIntersect.3 FcCharSetIntersectCount.3 FcCharSetIsSubset.3 \
FcCharSetNextPage.3 FcCharSetSubtract.3 FcCharSetSubtractCount.3 \
FcCharSetUnion.3 FcConfigAppFontAddDir.3 FcConfigAppFontAddFile.3 \
FcConfigAppFontClear.3 FcConfigBuildFonts.3 FcConfigCreate.3 \
FcConfigDestroy.3 FcConfigFilename.3 FcConfigGetBlanks.3 FcConfigGetCache.3 \
FcConfigGetConfigDirs.3 FcConfigGetConfigFiles.3 FcConfigGetCurrent.3 \
FcConfigGetFontDirs.3 FcConfigGetFonts.3 FcConfigGetRescanInverval.3 \
FcConfigParseAndLoad.3 FcConfigSetCurrent.3 FcConfigSetRescanInverval.3 \
FcConfigSubstitute.3 FcConfigSubstituteWithPat.3 FcConfigUptoDate.3 \
FcDefaultSubstitute.3 FcDirCacheValid.3 FcDirSave.3 FcDirScan.3 FcFileScan.3 \
FcFontList.3 FcFontMatch.3 FcFontRenderPrepare.3 FcFontSetAdd.3 \
FcFontSetCreate.3 FcFontSetDestroy.3 FcFontSort.3 FcFreeTypeCharIndex.3 \
FcFreeTypeCharSet.3 FcFreeTypeQuery.3 FcGetVersion.3 FcInit.3 \
FcInitBringUptoDate.3 FcInitLoadConfig.3 FcInitLoadConfigAndFonts.3 \
FcInitReinitialize.3 FcMatrixCopy.3 FcMatrixEqual.3 FcMatrixInit.3 \
FcMatrixMultiply.3 FcMatrixRotate.3 FcMatrixScale.3 FcMatrixShear.3 \
FcNameConstant.3 FcNameGetConstant.3 FcNameGetObjectType.3 FcNameParse.3 \
FcNameRegisterConstants.3 FcNameRegisterObjectTypes.3 FcNameUnparse.3 \
FcNameUnregisterConstants.3 FcNameUnregisterObjectTypes.3 FcObjectSetAdd.3 \
FcObjectSetBuild.3 FcObjectSetCreate.3 FcObjectSetDestroy.3 \
FcPatternAdd-Type.3 FcPatternAdd.3 FcPatternAddWeak.3 FcPatternBuild.3 \
FcPatternCreate.3 FcPatternDel.3 FcPatternDestroy.3 FcPatternEqual.3 \
FcPatternEqualSubset.3 FcPatternGet-Type.3 FcPatternGet.3 FcPatternHash.3 \
FcPatternPrint.3 FcStrBasename.3 FcStrCmpIgnoreCase.3 FcStrCopy.3 \
FcStrCopyFilename.3 FcStrDirname.3 FcStrListCreate.3 FcStrListDone.3 \
FcStrListNext.3 FcStrSetAdd.3 FcStrSetAddFilename.3 FcStrSetCreate.3 \
FcStrSetDel.3 FcStrSetDestroy.3 FcStrSetMember.3 FcUcs4ToUtf8.3 FcUtf16Len.3 \
FcUtf16ToUcs4.3 FcUtf8Len.3 FcUtf8ToUcs4.3 FcValueDestroy.3 FcValueSave.3

noinst_PROGRAMS = edit-sgml
edit_sgml_SOURCES = edit-sgml.c

DOC_FILES = $(TXT) $(HTML_FILES)
DOC_DIRS = $(HTML_DIRS)
LOCAL_DOCS = $(man_MANS) $(DOC_FILES) $(DOC_DIRS)

EXTRA_DIST = $(LOCAL_DOCS) $(SGML) $(DOC_FUNCS_FNCS) $(FNCS_TMPL)

SUFFIXES = .fncs .sgml .txt .html

@ENABLE_DOCS_TRUE at CLEANFILES = confdir.sgml local-fontconfig-user.sgml local-fontconfig-devel.sgml
subdir = doc
ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs
CONFIG_HEADER = $(top_builddir)/config.h
CONFIG_CLEAN_FILES = version.sgml
noinst_PROGRAMS = edit-sgml$(EXEEXT)
PROGRAMS = $(noinst_PROGRAMS)

am_edit_sgml_OBJECTS = edit-sgml.$(OBJEXT)
edit_sgml_OBJECTS = $(am_edit_sgml_OBJECTS)
edit_sgml_LDADD = $(LDADD)
edit_sgml_DEPENDENCIES =
edit_sgml_LDFLAGS =

DEFAULT_INCLUDES =  -I. -I$(srcdir) -I$(top_builddir)
depcomp = $(SHELL) $(top_srcdir)/depcomp
am__depfiles_maybe = depfiles
@AMDEP_TRUE at DEP_FILES = ./$(DEPDIR)/edit-sgml.Po
COMPILE = $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) \
	$(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)
LTCOMPILE = $(LIBTOOL) --mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) \
	$(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)
CCLD = $(CC)
LINK = $(LIBTOOL) --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) \
	$(AM_LDFLAGS) $(LDFLAGS) -o $@
DIST_SOURCES = $(edit_sgml_SOURCES)

NROFF = nroff
MANS = $(man_MANS)
DIST_COMMON = $(srcdir)/Makefile.in Makefile.am version.sgml.in
SOURCES = $(edit_sgml_SOURCES)

all: all-am

.SUFFIXES:
.SUFFIXES: .fncs .sgml .txt .html .c .lo .o .obj
$(srcdir)/Makefile.in:  Makefile.am  $(top_srcdir)/configure.in $(ACLOCAL_M4)
	cd $(top_srcdir) && \
	  $(AUTOMAKE) --gnu  doc/Makefile
Makefile:  $(srcdir)/Makefile.in  $(top_builddir)/config.status
	cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)
version.sgml: $(top_builddir)/config.status version.sgml.in
	cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@

clean-noinstPROGRAMS:
	@list='$(noinst_PROGRAMS)'; for p in $$list; do \
	  f=`echo $$p|sed 's/$(EXEEXT)$$//'`; \
	  echo " rm -f $$p $$f"; \
	  rm -f $$p $$f ; \
	done
edit-sgml$(EXEEXT): $(edit_sgml_OBJECTS) $(edit_sgml_DEPENDENCIES) 
	@rm -f edit-sgml$(EXEEXT)
	$(LINK) $(edit_sgml_LDFLAGS) $(edit_sgml_OBJECTS) $(edit_sgml_LDADD) $(LIBS)

mostlyclean-compile:
	-rm -f *.$(OBJEXT) core *.core

distclean-compile:
	-rm -f *.tab.c

@AMDEP_TRUE@@am__include@ @am__quote at ./$(DEPDIR)/edit-sgml.Po at am__quote@

.c.o:
@am__fastdepCC_TRUE@	if $(COMPILE) -MT $@ -MD -MP -MF "$(DEPDIR)/$*.Tpo" \
@am__fastdepCC_TRUE@	  -c -o $@ `test -f '$<' || echo '$(srcdir)/'`$<; \
@am__fastdepCC_TRUE@	then mv -f "$(DEPDIR)/$*.Tpo" "$(DEPDIR)/$*.Po"; \
@am__fastdepCC_TRUE@	else rm -f "$(DEPDIR)/$*.Tpo"; exit 1; \
@am__fastdepCC_TRUE@	fi
@AMDEP_TRUE@@am__fastdepCC_FALSE@	source='$<' object='$@' libtool=no @AMDEPBACKSLASH@
@AMDEP_TRUE@@am__fastdepCC_FALSE@	depfile='$(DEPDIR)/$*.Po' tmpdepfile='$(DEPDIR)/$*.TPo' @AMDEPBACKSLASH@
@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
@am__fastdepCC_FALSE@	$(COMPILE) -c `test -f '$<' || echo '$(srcdir)/'`$<

.c.obj:
@am__fastdepCC_TRUE@	if $(COMPILE) -MT $@ -MD -MP -MF "$(DEPDIR)/$*.Tpo" \
@am__fastdepCC_TRUE@	  -c -o $@ `if test -f '$<'; then $(CYGPATH_W) '$<'; else $(CYGPATH_W) '$(srcdir)/$<'; fi`; \
@am__fastdepCC_TRUE@	then mv -f "$(DEPDIR)/$*.Tpo" "$(DEPDIR)/$*.Po"; \
@am__fastdepCC_TRUE@	else rm -f "$(DEPDIR)/$*.Tpo"; exit 1; \
@am__fastdepCC_TRUE@	fi
@AMDEP_TRUE@@am__fastdepCC_FALSE@	source='$<' object='$@' libtool=no @AMDEPBACKSLASH@
@AMDEP_TRUE@@am__fastdepCC_FALSE@	depfile='$(DEPDIR)/$*.Po' tmpdepfile='$(DEPDIR)/$*.TPo' @AMDEPBACKSLASH@
@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
@am__fastdepCC_FALSE@	$(COMPILE) -c `if test -f '$<'; then $(CYGPATH_W) '$<'; else $(CYGPATH_W) '$(srcdir)/$<'; fi`

.c.lo:
@am__fastdepCC_TRUE@	if $(LTCOMPILE) -MT $@ -MD -MP -MF "$(DEPDIR)/$*.Tpo" \
@am__fastdepCC_TRUE@	  -c -o $@ `test -f '$<' || echo '$(srcdir)/'`$<; \
@am__fastdepCC_TRUE@	then mv -f "$(DEPDIR)/$*.Tpo" "$(DEPDIR)/$*.Plo"; \
@am__fastdepCC_TRUE@	else rm -f "$(DEPDIR)/$*.Tpo"; exit 1; \
@am__fastdepCC_TRUE@	fi
@AMDEP_TRUE@@am__fastdepCC_FALSE@	source='$<' object='$@' libtool=yes @AMDEPBACKSLASH@
@AMDEP_TRUE@@am__fastdepCC_FALSE@	depfile='$(DEPDIR)/$*.Plo' tmpdepfile='$(DEPDIR)/$*.TPlo' @AMDEPBACKSLASH@
@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
@am__fastdepCC_FALSE@	$(LTCOMPILE) -c -o $@ `test -f '$<' || echo '$(srcdir)/'`$<

mostlyclean-libtool:
	-rm -f *.lo

clean-libtool:
	-rm -rf .libs _libs

distclean-libtool:
	-rm -f libtool
uninstall-info-am:

man3dir = $(mandir)/man3
install-man3: $(man3_MANS) $(man_MANS)
	@$(NORMAL_INSTALL)
	$(mkinstalldirs) $(DESTDIR)$(man3dir)
	@list='$(man3_MANS) $(dist_man3_MANS) $(nodist_man3_MANS)'; \
	l2='$(man_MANS) $(dist_man_MANS) $(nodist_man_MANS)'; \
	for i in $$l2; do \
	  case "$$i" in \
	    *.3*) list="$$list $$i" ;; \
	  esac; \
	done; \
	for i in $$list; do \
	  if test -f $(srcdir)/$$i; then file=$(srcdir)/$$i; \
	  else file=$$i; fi; \
	  ext=`echo $$i | sed -e 's/^.*\\.//'`; \
	  case "$$ext" in \
	    3*) ;; \
	    *) ext='3' ;; \
	  esac; \
	  inst=`echo $$i | sed -e 's/\\.[0-9a-z]*$$//'`; \
	  inst=`echo $$inst | sed -e 's/^.*\///'`; \
	  inst=`echo $$inst | sed '$(transform)'`.$$ext; \
	  echo " $(INSTALL_DATA) $$file $(DESTDIR)$(man3dir)/$$inst"; \
	  $(INSTALL_DATA) $$file $(DESTDIR)$(man3dir)/$$inst; \
	done
uninstall-man3:
	@$(NORMAL_UNINSTALL)
	@list='$(man3_MANS) $(dist_man3_MANS) $(nodist_man3_MANS)'; \
	l2='$(man_MANS) $(dist_man_MANS) $(nodist_man_MANS)'; \
	for i in $$l2; do \
	  case "$$i" in \
	    *.3*) list="$$list $$i" ;; \
	  esac; \
	done; \
	for i in $$list; do \
	  ext=`echo $$i | sed -e 's/^.*\\.//'`; \
	  case "$$ext" in \
	    3*) ;; \
	    *) ext='3' ;; \
	  esac; \
	  inst=`echo $$i | sed -e 's/\\.[0-9a-z]*$$//'`; \
	  inst=`echo $$inst | sed -e 's/^.*\///'`; \
	  inst=`echo $$inst | sed '$(transform)'`.$$ext; \
	  echo " rm -f $(DESTDIR)$(man3dir)/$$inst"; \
	  rm -f $(DESTDIR)$(man3dir)/$$inst; \
	done

man5dir = $(mandir)/man5
install-man5: $(man5_MANS) $(man_MANS)
	@$(NORMAL_INSTALL)
	$(mkinstalldirs) $(DESTDIR)$(man5dir)
	@list='$(man5_MANS) $(dist_man5_MANS) $(nodist_man5_MANS)'; \
	l2='$(man_MANS) $(dist_man_MANS) $(nodist_man_MANS)'; \
	for i in $$l2; do \
	  case "$$i" in \
	    *.5*) list="$$list $$i" ;; \
	  esac; \
	done; \
	for i in $$list; do \
	  if test -f $(srcdir)/$$i; then file=$(srcdir)/$$i; \
	  else file=$$i; fi; \
	  ext=`echo $$i | sed -e 's/^.*\\.//'`; \
	  case "$$ext" in \
	    5*) ;; \
	    *) ext='5' ;; \
	  esac; \
	  inst=`echo $$i | sed -e 's/\\.[0-9a-z]*$$//'`; \
	  inst=`echo $$inst | sed -e 's/^.*\///'`; \
	  inst=`echo $$inst | sed '$(transform)'`.$$ext; \
	  echo " $(INSTALL_DATA) $$file $(DESTDIR)$(man5dir)/$$inst"; \
	  $(INSTALL_DATA) $$file $(DESTDIR)$(man5dir)/$$inst; \
	done
uninstall-man5:
	@$(NORMAL_UNINSTALL)
	@list='$(man5_MANS) $(dist_man5_MANS) $(nodist_man5_MANS)'; \
	l2='$(man_MANS) $(dist_man_MANS) $(nodist_man_MANS)'; \
	for i in $$l2; do \
	  case "$$i" in \
	    *.5*) list="$$list $$i" ;; \
	  esac; \
	done; \
	for i in $$list; do \
	  ext=`echo $$i | sed -e 's/^.*\\.//'`; \
	  case "$$ext" in \
	    5*) ;; \
	    *) ext='5' ;; \
	  esac; \
	  inst=`echo $$i | sed -e 's/\\.[0-9a-z]*$$//'`; \
	  inst=`echo $$inst | sed -e 's/^.*\///'`; \
	  inst=`echo $$inst | sed '$(transform)'`.$$ext; \
	  echo " rm -f $(DESTDIR)$(man5dir)/$$inst"; \
	  rm -f $(DESTDIR)$(man5dir)/$$inst; \
	done

ETAGS = etags
ETAGSFLAGS =

CTAGS = ctags
CTAGSFLAGS =

tags: TAGS

ID: $(HEADERS) $(SOURCES) $(LISP) $(TAGS_FILES)
	list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \
	unique=`for i in $$list; do \
	    if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \
	  done | \
	  $(AWK) '    { files[$$0] = 1; } \
	       END { for (i in files) print i; }'`; \
	mkid -fID $$unique

TAGS:  $(HEADERS) $(SOURCES)  $(TAGS_DEPENDENCIES) \
		$(TAGS_FILES) $(LISP)
	tags=; \
	here=`pwd`; \
	list='$(SOURCES) $(HEADERS)  $(LISP) $(TAGS_FILES)'; \
	unique=`for i in $$list; do \
	    if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \
	  done | \
	  $(AWK) '    { files[$$0] = 1; } \
	       END { for (i in files) print i; }'`; \
	test -z "$(ETAGS_ARGS)$$tags$$unique" \
	  || $(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \
	     $$tags $$unique

ctags: CTAGS
CTAGS:  $(HEADERS) $(SOURCES)  $(TAGS_DEPENDENCIES) \
		$(TAGS_FILES) $(LISP)
	tags=; \
	here=`pwd`; \
	list='$(SOURCES) $(HEADERS)  $(LISP) $(TAGS_FILES)'; \
	unique=`for i in $$list; do \
	    if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \
	  done | \
	  $(AWK) '    { files[$$0] = 1; } \
	       END { for (i in files) print i; }'`; \
	test -z "$(CTAGS_ARGS)$$tags$$unique" \
	  || $(CTAGS) $(CTAGSFLAGS) $(AM_CTAGSFLAGS) $(CTAGS_ARGS) \
	     $$tags $$unique

GTAGS:
	here=`$(am__cd) $(top_builddir) && pwd` \
	  && cd $(top_srcdir) \
	  && gtags -i $(GTAGS_ARGS) $$here

distclean-tags:
	-rm -f TAGS ID GTAGS GRTAGS GSYMS GPATH tags
DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST)

top_distdir = ..
distdir = $(top_distdir)/$(PACKAGE)-$(VERSION)

distdir: $(DISTFILES)
	$(mkinstalldirs) $(distdir)/${DOC_SRC}
	@srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; \
	topsrcdirstrip=`echo "$(top_srcdir)" | sed 's|.|.|g'`; \
	list='$(DISTFILES)'; for file in $$list; do \
	  case $$file in \
	    $(srcdir)/*) file=`echo "$$file" | sed "s|^$$srcdirstrip/||"`;; \
	    $(top_srcdir)/*) file=`echo "$$file" | sed "s|^$$topsrcdirstrip/|$(top_builddir)/|"`;; \
	  esac; \
	  if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \
	  dir=`echo "$$file" | sed -e 's,/[^/]*$$,,'`; \
	  if test "$$dir" != "$$file" && test "$$dir" != "."; then \
	    dir="/$$dir"; \
	    $(mkinstalldirs) "$(distdir)$$dir"; \
	  else \
	    dir=''; \
	  fi; \
	  if test -d $$d/$$file; then \
	    if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \
	      cp -pR $(srcdir)/$$file $(distdir)$$dir || exit 1; \
	    fi; \
	    cp -pR $$d/$$file $(distdir)$$dir || exit 1; \
	  else \
	    test -f $(distdir)/$$file \
	    || cp -p $$d/$$file $(distdir)/$$file \
	    || exit 1; \
	  fi; \
	done
check-am: all-am
check: check-am
all-am: Makefile $(PROGRAMS) $(MANS) all-local

installdirs:
	$(mkinstalldirs) $(DESTDIR)$(man3dir) $(DESTDIR)$(man5dir)
install: install-am
install-exec: install-exec-am
install-data: install-data-am
uninstall: uninstall-am

install-am: all-am
	@$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am

installcheck: installcheck-am
install-strip:
	$(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
	  install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
	  `test -z '$(STRIP)' || \
	    echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install
mostlyclean-generic:

clean-generic:
	-test -z "$(CLEANFILES)" || rm -f $(CLEANFILES)

distclean-generic:
	-rm -f $(CONFIG_CLEAN_FILES)

maintainer-clean-generic:
	@echo "This command is intended for maintainers to use"
	@echo "it deletes files that may require special tools to rebuild."
clean: clean-am

clean-am: clean-generic clean-libtool clean-local clean-noinstPROGRAMS \
	mostlyclean-am

distclean: distclean-am
	-rm -rf ./$(DEPDIR)
	-rm -f Makefile
distclean-am: clean-am distclean-compile distclean-generic \
	distclean-libtool distclean-tags

dvi: dvi-am

dvi-am:

info: info-am

info-am:

install-data-am: install-data-local install-man

install-exec-am:

install-info: install-info-am

install-man: install-man3 install-man5

installcheck-am:

maintainer-clean: maintainer-clean-am
	-rm -rf ./$(DEPDIR)
	-rm -f Makefile
maintainer-clean-am: distclean-am maintainer-clean-generic

mostlyclean: mostlyclean-am

mostlyclean-am: mostlyclean-compile mostlyclean-generic \
	mostlyclean-libtool

pdf: pdf-am

pdf-am:

ps: ps-am

ps-am:

uninstall-am: uninstall-info-am uninstall-man

uninstall-man: uninstall-man3 uninstall-man5

.PHONY: CTAGS GTAGS all all-am all-local check check-am clean \
	clean-generic clean-libtool clean-local clean-noinstPROGRAMS \
	ctags distclean distclean-compile distclean-generic \
	distclean-libtool distclean-tags distdir dvi dvi-am info \
	info-am install install-am install-data install-data-am \
	install-data-local install-exec install-exec-am install-info \
	install-info-am install-man install-man3 install-man5 \
	install-strip installcheck installcheck-am installdirs \
	maintainer-clean maintainer-clean-generic mostlyclean \
	mostlyclean-compile mostlyclean-generic mostlyclean-libtool pdf \
	pdf-am ps ps-am tags uninstall uninstall-am uninstall-info-am \
	uninstall-man uninstall-man3 uninstall-man5

@ENABLE_DOCS_TRUE at .fncs.sgml:
@ENABLE_DOCS_TRUE@	$(RM) $@
@ENABLE_DOCS_TRUE@	./edit-sgml $(FNCS_TMPL) < '$<' > $*.sgml

@ENABLE_DOCS_TRUE at .sgml.txt:
@ENABLE_DOCS_TRUE@	$(RM) $@
@ENABLE_DOCS_TRUE@	$(DOC2TXT) $<

@ENABLE_DOCS_TRUE@$(man_MANS): func.refs

@ENABLE_DOCS_TRUE at func.refs: local-fontconfig-devel.sgml $(DOC_FUNCS_SGML) version.sgml
@ENABLE_DOCS_TRUE@	$(RM) func.refs
@ENABLE_DOCS_TRUE@	$(DOC2MAN) local-fontconfig-devel.sgml
@ENABLE_DOCS_TRUE@	mv manpage.refs func.refs
@ENABLE_DOCS_TRUE@	$(RM) manpage.links

@ENABLE_DOCS_TRUE@$(DOC_FUNCS_SGML): edit-sgml $(FNCS_TMPL)

@ENABLE_DOCS_TRUE at fonts-conf.5: local-fontconfig-user.sgml version.sgml
@ENABLE_DOCS_TRUE@	$(RM) file.refs
@ENABLE_DOCS_TRUE@	$(DOC2MAN) local-fontconfig-user.sgml
@ENABLE_DOCS_TRUE@	$(RM) manpage.refs manpage.links

@ENABLE_DOCS_TRUE at local-fontconfig-user.sgml: fontconfig-user.sgml
@ENABLE_DOCS_TRUE@	$(LN_S) $< $@

@ENABLE_DOCS_TRUE at all-local: $(LOCAL_DOCS)

@ENABLE_DOCS_TRUE at clean-local:
@ENABLE_DOCS_TRUE@	$(RM) $(man_MANS) $(DOC_FILES) $(DOC_FUNCS_SGML) func.refs
@ENABLE_DOCS_TRUE@	$(RM) -r $(DOC_DIRS)

@ENABLE_DOCS_TRUE at fontconfig-devel: local-fontconfig-devel.sgml $(DOCS_FUNCS_SGML) version.sgml
@ENABLE_DOCS_TRUE@	$(RM) -r fontconfig-devel
@ENABLE_DOCS_TRUE@	$(DOC2HTML) -o fontconfig-devel local-fontconfig-devel.sgml

@ENABLE_DOCS_TRUE at local-fontconfig-devel.sgml: fontconfig-devel.sgml
@ENABLE_DOCS_TRUE@	$(LN_S) $< $@

@ENABLE_DOCS_TRUE at fontconfig-devel.txt: local-fontconfig-devel.sgml version.sgml
@ENABLE_DOCS_TRUE@	$(RM) $@
@ENABLE_DOCS_TRUE@	$(DOC2TXT) local-fontconfig-devel.sgml
@ENABLE_DOCS_TRUE@	mv local-fontconfig-devel.txt $@

@ENABLE_DOCS_TRUE at fontconfig-user.html: local-fontconfig-user.sgml version.sgml
@ENABLE_DOCS_TRUE@	$(RM) $@ local-$@ $@.tmp
@ENABLE_DOCS_TRUE@	$(DOC2HTML) -u local-fontconfig-user.sgml > $@.tmp
@ENABLE_DOCS_TRUE@	-test -f local-$@ && mv local-$@ $@
@ENABLE_DOCS_TRUE@	-test -f $@ || mv $@.tmp $@
@ENABLE_DOCS_TRUE@	-test -f $@.tmp && $(RM) $@.tmp

@ENABLE_DOCS_TRUE at fontconfig-user.txt:  local-fontconfig-user.sgml version.sgml
@ENABLE_DOCS_TRUE@	$(RM) $@
@ENABLE_DOCS_TRUE@	$(DOC2TXT) local-fontconfig-user.sgml
@ENABLE_DOCS_TRUE@	mv local-fontconfig-user.txt $@

@ENABLE_DOCS_FALSE at all-local:
@ENABLE_DOCS_FALSE at clean-local:

install-data-local:
	$(mkinstalldirs) $(DESTDIR)$(DOCDIR)
	for i in $(DOC_FILES); do \
	  echo '-- Installing '$$i ; \
	  $(INSTALL_DATA) $$i $(DESTDIR)$(DOCDIR)/$$i; \
	done
	for i in $(DOC_DIRS); do \
	  $(mkinstalldirs) $(DESTDIR)$(DOCDIR)/$$i ; \
	  for f in $$i/*; do \
	    echo '-- Installing '$$f ; \
	    $(INSTALL_DATA) $$f $(DESTDIR)$(DOCDIR)/$$f; \
	  done \
	done
# Tell versions [3.59,3.63) of GNU make to not export all variables.
# Otherwise a system limit (for SysV at least) may be exceeded.
.NOEXPORT:

--- NEW FILE: edit-sgml.c ---
(This appears to be a binary file; contents omitted.)

--- NEW FILE: fcatomic.fncs ---
(This appears to be a binary file; contents omitted.)

--- NEW FILE: fcblanks.fncs ---
(This appears to be a binary file; contents omitted.)

--- NEW FILE: fccharset.fncs ---
(This appears to be a binary file; contents omitted.)

--- NEW FILE: fcconfig.fncs ---
(This appears to be a binary file; contents omitted.)

--- NEW FILE: fcconstant.fncs ---
(This appears to be a binary file; contents omitted.)

--- NEW FILE: fcfile.fncs ---
(This appears to be a binary file; contents omitted.)

--- NEW FILE: fcfontset.fncs ---
(This appears to be a binary file; contents omitted.)

--- NEW FILE: fcfreetype.fncs ---
(This appears to be a binary file; contents omitted.)

--- NEW FILE: fcinit.fncs ---
(This appears to be a binary file; contents omitted.)

--- NEW FILE: fcmatrix.fncs ---
(This appears to be a binary file; contents omitted.)

--- NEW FILE: fcobjectset.fncs ---
(This appears to be a binary file; contents omitted.)

--- NEW FILE: fcobjecttype.fncs ---
(This appears to be a binary file; contents omitted.)

--- NEW FILE: fcpattern.fncs ---
(This appears to be a binary file; contents omitted.)

--- NEW FILE: fcstring.fncs ---
(This appears to be a binary file; contents omitted.)

--- NEW FILE: fcstrset.fncs ---
(This appears to be a binary file; contents omitted.)

--- NEW FILE: fcvalue.fncs ---
(This appears to be a binary file; contents omitted.)

--- NEW FILE: fontconfig-devel.sgml ---
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
<!ENTITY fcatomic SYSTEM "fcatomic.sgml">
<!ENTITY fcblanks SYSTEM "fcblanks.sgml">
<!ENTITY fccharset SYSTEM "fccharset.sgml">
<!ENTITY fcconfig SYSTEM "fcconfig.sgml">
<!ENTITY fcconstant SYSTEM "fcconstant.sgml">
<!ENTITY fcfile SYSTEM "fcfile.sgml">
<!ENTITY fcfontset SYSTEM "fcfontset.sgml">
<!ENTITY fcfreetype SYSTEM "fcfreetype.sgml">
<!ENTITY fcinit SYSTEM "fcinit.sgml">
<!ENTITY fcmatrix SYSTEM "fcmatrix.sgml">
<!ENTITY fcobjectset SYSTEM "fcobjectset.sgml">
<!ENTITY fcobjecttype SYSTEM "fcobjecttype.sgml">
<!ENTITY fcpattern SYSTEM "fcpattern.sgml">
<!ENTITY fcstring SYSTEM "fcstring.sgml">
<!ENTITY fcstrset SYSTEM "fcstrset.sgml">
<!ENTITY fcvalue SYSTEM "fcvalue.sgml">
<!ENTITY version SYSTEM "version.sgml">
]>
<!--
    $Id: fontconfig-devel.sgml,v 1.6.2.1 2003/04/23 04:09:56 keithp Exp $

    Copyright © 2003 Keith Packard

    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.
-->
<article>
	<title>Fontconfig Developers Reference, Version &version; </title>
	<artheader>
		<author>
			<firstname>Keith</firstname>
			<surname>Packard</surname>
			<affiliation><orgname>
				HP Cambridge Research Lab
			</orgname></affiliation>
		</author>
		<authorinitials>KRP</authorinitials>
		<productname>Fontconfig</productname>
		<productnumber>&version;</productnumber>
		<LegalNotice>
			<simpara>		
Copyright © 2002 Keith Packard
			</simpara><simpara>
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.
			</simpara><simpara>
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.
			</simpara>
		</LegalNotice>
	</artheader>
<sect1><title>DESCRIPTION</title>
  <para>
Fontconfig is a library designed to provide system-wide font configuration,
customization and application access.
  </para>
</sect1>
<sect1><title>FUNCTIONAL OVERVIEW</title>
  <para>
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.
  </para>
  <sect2><title>FONT CONFIGURATION</title>
    <para>
The configuration module consists of the FcConfig datatype, libexpat and
FcConfigParse which walks over an XML tree and ammends 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.  
    </para><para>
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.
    </para><para>
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
simplify and regularize font installation and customization.
    </para>
  </sect2>
  <sect2>
    <title>FONT PROPERTIES</title>
    <para>
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.
    </para>
    <programlisting>
                 Property Definitions

    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  Stretches glyphs horizontally
                                                before hinting
    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    Whether glyphs can be
                                                antialiased
    hinting        FC_HINTING           Bool    Whether the rasterizer should
                                                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  Scale factor for point->pixel
                                                conversions
    dpi            FC_DPI               Double  Target dots per inch
    rgba           FC_RGBA              Int     unknown, rgb, bgr, vrgb,
                                                vbgr, none - subpixel geometry
    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
    </programlisting>
  </sect2>
</sect1>
<sect1><title>Datatypes</title>
  <para>
Fontconfig uses abstract datatypes to hide internal implementation details
for most data structures.  A few structures are exposed where appropriate.
  </para>
  <sect2><title>FcChar8, FcChar16, FcChar32, FcBool</title>
    <para>
These are primitive datatypes; 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.
    </para>
  </sect2>
  <sect2><title>FcMatrix</title>
    <para>
An FcMatrix holds an affine transformation, usually used to reshape glyphs.
A small set of matrix operations are provided to manipulate these.
    <programlisting>
        typedef struct _FcMatrix {
                double xx, xy, yx, yy;
        } FcMatrix;
    </programlisting>
    </para>
  </sect2>
  <sect2><title>FcCharSet</title>
    <para>
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.
    </para>
  </sect2>
  <sect2><title>FcType</title>
    <para>
Tags the kind of data stored in an FcValue.
    </para>
  </sect2>
  <sect2><title>FcValue</title>
    <para>
An FcValue object holds a single value with one of a number of different
types.  The 'type' tag indicates which member is valid.
    <programlisting>
        typedef struct _FcValue {
                FcType type;
                union {
                        const FcChar8 *s;
                        int i;
                        FcBool b;
                        double d;
                        const FcMatrix *m;
                        const FcCharSet *c;
                } u;
        } FcValue;
    </programlisting>
    <programlisting>
                  FcValue Members

        Type            Union member    Datatype
        --------------------------------
        FcTypeVoid      (none)          (none)
        FcTypeInteger   i               int
        FcTypeDouble    d               double
        FcTypeString    s               char *
        FcTypeBool      b               b
        FcTypeMatrix    m               FcMatrix *
        FcTypeCharSet   c               FcCharSet *
    </programlisting>
    </para>
  </sect2>
  <sect2><title>FcPattern</title>
    <para>
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.
    </para>
  </sect2>
  <sect2><title>FcFontSet</title>
    <para>
    <programlisting>
        typedef struct _FcFontSet {
                int nfont;
                int sfont;
                FcPattern **fonts;
        } FcFontSet;
    </programlisting>
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.
    </para>
  </sect2>
  <sect2><title>FcStrSet, FcStrList</title>
    <para>
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.
    </para>
  </sect2>
  <sect2><title>FcObjectSet</title>
    <para>
      <programlisting>
        typedef struct _FcObjectSet {
                int nobject;
                int sobject;
                const char **objects;
        } FcObjectSet;
      </programlisting>
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.
    </para>
  </sect2>
  <sect2><title>FcObjectType</title>
    <para>
      <programlisting>
        typedef struct _FcObjectType {
                const char *object;
                FcType type;
        } FcObjectType;
      </programlisting>
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.
    </para>
  </sect2>
  <sect2><title>FcConstant</title>
    <para>
      <programlisting>
        typedef struct _FcConstant {
            const FcChar8 *name;
            const char *object;
            int value;
        } FcConstant;
      </programlisting>
Provides for symbolic constants for new pattern elements.  When 'name' is
seen in a font name, an 'object' element is created with value 'value'.
    </para>
  </sect2>
  <sect2><title>FcBlanks</title>
    <para>
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.
    </para>
  </sect2>
  <sect2><title>FcFileCache</title>
    <para>
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.
    </para>
  </sect2>
  <sect2><title>FcConfig</title>
    <para>
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.
    </para>
  </sect2>
  <sect2><title>FcSetName</title>
    <para>
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.
    </para>
  </sect2>
  <sect2><title>FcResult</title>
    <para>
Used as a return type for functions manipulating FcPattern objects.
    <programlisting>
      FcResult Values
        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
    </programlisting>
    </para>
  </sect2>
  <sect2><title>FcAtomic</title>
    <para>
Used for locking access to config files.  Provides a safe way to update
configuration files.
    </para>
  </sect2>
</sect1>
<sect1><title>FUNCTIONS</title>
  <para>
These are grouped by functionality, often using the main datatype being
manipulated.
  </para>
  <sect2><title>Initialization</title>
    <para>
These functions provide some control over how the library is initialized.
    </para>
    &fcinit;
  </sect2>
  <sect2><title>FcPattern</title>
    <para>
An FcPattern is an opaque type that holds both patterns to match against the
available fonts, as well as the information about each font.
    </para>
    &fcpattern;
  </sect2>
  <sect2><title>FcFontSet</title>
    <para>
An FcFontSet simply holds a list of patterns; these are used to return the
results of listing available fonts.
    </para>
    &fcfontset;
  </sect2>
  <sect2><title>FcObjectSet</title>
    <para>
An FcObjectSet holds a list of pattern property names; it is used to
indiciate which properties are to be returned in the patterns from
FcFontList.
    </para>
    &fcobjectset;
  </sect2>
  <sect2><title>FreeType specific functions</title>
    <para>
While the fontconfig library doesn't insist that FreeType be used as the
rasterization mechanism for fonts, it does provide some convenience
functions.
    </para>
    &fcfreetype;
  </sect2>
  <sect2><title>FcValue</title>
    <para>
FcValue is a structure containing a type tag and a union of all possible
datatypes.  The tag is an enum of type 
<emphasis>FcType</emphasis>
and is intended to provide a measure of run-time
typechecking, although that depends on careful programming.
    </para>
    &fcvalue;
  </sect2>
  <sect2><title>FcCharSet</title>
    <para>
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 it's argument, and that CharSet may remain unmodifiable.
    </para>
    &fccharset;
  </sect2>
  <sect2><title>FcMatrix</title>
    <para>
FcMatrix structures hold an affine transformation in matrix form.
    </para>
    &fcmatrix;
  </sect2>
  <sect2><title>FcConfig</title>
    <para>
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.
    </para>
    &fcconfig;
  </sect2>
  <sect2><title>FcObjectType</title>
    <para>
Provides for applcation-specified font name object types so that new
pattern elements can be generated from font names.
    </para>
    &fcobjecttype;
  </sect2>
  <sect2><title>FcConstant</title>
    <para>
Provides for application-specified symbolic constants for font names.
    </para>
    &fcconstant;
  </sect2>
  <sect2><title>FcBlanks</title>
    <para>
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.
    </para>
    &fcblanks;
  </sect2>
  <sect2><title>FcAtomic</title>
    <para>
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.
    </para>
    &fcatomic;
  </sect2>
  <sect2><title>File and Directory routines</title>
    <para>
These routines work with font files and directories, including font
directory cache files.
    </para>
    &fcfile;
  </sect2>
  <sect2><title>FcStrSet and FcStrList</title>
    <para>
A data structure for enumerating strings, used to list directories while
scanning the configuration as directories are added while scanning.
    </para>
    &fcstrset;
  </sect2>
  <sect2><title>String utilities</title>
    <para>
Fontconfig manipulates many UTF-8 strings represented with the FcChar8 type.
These functions are exposed to help applications deal with these UTF-8
strings in a locale-insensitive manner.
    </para>
    &fcstring;
  </sect2>
</sect1>
</article>

--- NEW FILE: fontconfig-devel.txt ---

Fontconfig Developers Reference, Version 2.2.2

Keith Packard

   HP Cambridge Research Lab
     _________________________________________________________

   Table of Contents
   1. DESCRIPTION
   2. FUNCTIONAL OVERVIEW

        2.1. FONT CONFIGURATION
        2.2. FONT PROPERTIES

   3. Datatypes

        3.1. FcChar8, FcChar16, FcChar32, FcBool
        3.2. FcMatrix
[...3592 lines suppressed...]

Name

   FcStrBasename -- last component of filename

Synopsis

#include <fontconfig.h>

   FcChar8 * FcStrBasename(const FcChar8 *file);

Description

   Returns the filename of file stripped of any leading directory
   names. This is returned in newly allocated storage which
   should be freed when no longer needed.

Version

   Fontconfig version 2.2.2

--- NEW FILE: fontconfig-user.html ---
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML
><HEAD
><TITLE
>fonts-conf</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><H1
><A
NAME="AEN1"
></A
[...995 lines suppressed...]
>
is the conventional repository of font information that isn't found in the
per-directory caches.  This file is automatically maintained by fontconfig.
  </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN206"
></A
><H2
>Version</H2
><P
>Fontconfig version 2.2.2

	    </P
></DIV
></BODY
></HTML
>
--- NEW FILE: fontconfig-user.sgml ---
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
<!ENTITY version SYSTEM "version.sgml">
]>
<!--
    $Id: fontconfig-user.sgml,v 1.6 2003/03/20 02:00:54 keithp Exp $

    Copyright © 2003 Keith Packard

    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.
-->
<refentry>
<refmeta>
  <refentrytitle>fonts-conf</refentrytitle>
  <manvolnum>5</manvolnum>
</refmeta>
<refnamediv>
	<refname>fonts.conf</refname>
	<refpurpose>Font configuration files</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>
   /etc/fonts/fonts.conf
   /etc/fonts/fonts.dtd
   ~/.fonts.conf
</synopsis>
</refsynopsisdiv>
<refsect1><title>Description</title>
  <para>
Fontconfig is a library designed to provide system-wide font configuration,
customization and application access.
  </para>
</refsect1>
<refsect1><title>Functional Overview</title>
  <para>
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.
  </para>
  <refsect2><title>Font Configuration</title>
    <para>
The configuration module consists of the FcConfig datatype, libexpat and
FcConfigParse which walks over an XML tree and ammends 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.  
    </para><para>
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.
    </para><para>
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
simplify and regularize font installation and customization.
    </para>
  </refsect2>
  <refsect2>
    <title>Font Properties</title>
    <para>
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.
    </para>
    <programlisting>
  Property        Type    Description
  --------------------------------------------------------------
  family          String  Font family name
  style           String  Font style. Overrides weight and slant
  slant           Int     Italic, oblique or roman
  weight          Int     Light, medium, demibold, bold or black
  size            Double  Point size
  aspect          Double  Stretches glyphs horizontally before hinting
  pixelsize       Double  Pixel size
  spacing         Int     Proportional, monospace or charcell
  foundry         String  Font foundry name
  antialias       Bool    Whether glyphs can be antialiased
  hinting         Bool    Whether the rasterizer should use hinting
  verticallayout  Bool    Use vertical layout
  autohint        Bool    Use autohinter instead of normal hinter
  globaladvance   Bool    Use font global advance data
  file            String  The filename holding the font
  index           Int     The index of the font within the file
  ftface          FT_Face Use the specified FreeType face object
  rasterizer      String  Which rasterizer is in use
  outline         Bool    Whether the glyphs are outlines
  scalable        Bool    Whether glyphs can be scaled
  scale           Double  Scale factor for point->pixel conversions
  dpi             Double  Target dots per inch
  rgba            Int     unknown, rgb, bgr, vrgb, vbgr,
                          none - subpixel geometry
  minspace        Bool    Eliminate leading from line spacing
  charset         CharSet Unicode chars encoded by the font
  lang            String  List of RFC-3066-style languages this
                          font supports
    </programlisting>
  </refsect2>
  <refsect2>
  <title>Font Matching</title>
    <para>
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.
    </para><para> 
Font matching starts with an application constructed pattern.  The desired
attributes of the resulting font are collected together in a pattern.  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.
    </para><para>
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.
    </para><para>
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.
    </para><para>
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.
    </para><para>
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.
    </para><para>
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.
    </para><para>
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.
    </para><para>
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.
    </para>
  </refsect2>
  <refsect2><title>Font Names</title>
    <para>
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:
    </para>
    <programlisting>
	&lt;families&gt;-&lt;point sizes&gt;:&lt;name1&gt;=&lt;values1&gt;:&lt;name2&gt;=&lt;values2&gt;...
    </programlisting>
    <para>
Values in a list are separated with commas.  The name needn't include either
families or point sizes; they can be elided.  In addition, there are
symbolic constants that simultaneously indicate both a name and a value.
Here are some examples:
    </para>
    <programlisting>
  Name                            Meaning
  ----------------------------------------------------------
  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
    </programlisting>
  </refsect2>
</refsect1>
<refsect1><title>Lang Tags</title>
  <para>
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.
  </para><para>
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.
  </para>
</refsect1>
<refsect1><title>Configuration File Format</title>
  <para>
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.
  </para><para>
The fontconfig document type definition resides in the external entity
"fonts.dtd"; this is normally stored in the default font configuration
directory (/etc/fonts).  Each configuration file should contain the
following structure:
    <programlisting>
	&lt;?xml version="1.0"?&gt;
	&lt;!DOCTYPE fontconfig SYSTEM "fonts.dtd"&gt;
	&lt;fontconfig&gt;
	...
	&lt;/fontconfig&gt;
    </programlisting>
  </para>
<refsect2><title><literal>&lt;fontconfig&gt;</literal></title><para>
This is the top level element for a font configuration and can contain
<sgmltag>dir</>, <sgmltag>cache</>, <sgmltag>include</>, <sgmltag>match</> and <sgmltag>alias</> elements in any order.
  </para></refsect2>
  <refsect2><title><sgmltag>dir</></title><para>
This element contains a directory name which will be scanned for font files
to include in the set of available fonts.
  </para></refsect2>
  <refsect2><title><sgmltag>cache</></title><para>
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-<sgmltag>version</>'', where <sgmltag>version</> is the font configuration
file version number (currently 1).
  </para></refsect2>
  <refsect2><title><sgmltag>include ignore_missing="no"</></title><para>
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.
  </para></refsect2>
  <refsect2><title><sgmltag>config</></title><para>
This element provides a place to consolodate additional configuration
information.  <sgmltag>config</> can contain <sgmltag>blank</> and <sgmltag>rescan</> elements in any
order.
  </para></refsect2>
  <refsect2><title><sgmltag>blank</></title><para>
Fonts often include "broken" glyphs which appear in the encoding but are
drawn as blanks on the screen.  Within the <sgmltag>blank</> element, place each
Unicode characters which is supposed to be blank in an <sgmltag>int</> element.
Characters outside of this set which are drawn as blank will be elided from
the set of characters supported by the font.
  </para></refsect2>
  <refsect2><title><sgmltag>rescan</></title><para>
The <sgmltag>rescan</> element holds an <sgmltag>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.
  </para></refsect2>
  <refsect2><title><sgmltag>match target="pattern"</></title><para>
This element holds first a (possibly empty) list of <sgmltag>test</> elements and then
a (possibly empty) list of <sgmltag>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.
  </para></refsect2>
  <refsect2><title><sgmltag>test qual="any" name="property" compare="eq"</></title><para>
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.
  </para></refsect2>
  <refsect2><title><sgmltag>edit name="property" mode="assign" binding="weak"</></title><para>
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 <sgmltag>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:
    <programlisting>
  Mode                    With Match              Without Match
  ---------------------------------------------------------------------
  "assign"                Replace matching value  Replace all values
  "assign_replace"        Replace all values      Replace all values
  "prepend"               Insert before matching  Insert at head of list
  "prepend_first"         Insert at head of list  Insert at head of list
  "append"                Append after matching   Append at end of list
  "append_last"           Append at end of list   Append at end of list
    </programlisting>
  </para></refsect2>
  <refsect2><title><sgmltag>int</>, <sgmltag>double</>, <sgmltag>string</>, <sgmltag>bool</></title><para>
These elements hold a single value of the indicated type.  <sgmltag>bool</>
elements hold either true or false.  An important limitation exists in
the parsing of floating point numbers -- fontconfig requires that
the mantissa start with a digit, not a decimal point, so insert a leading
zero for purely fractional values (e.g. use 0.5 instead of .5 and -0.5
instead of -.5).
  </para></refsect2>
  <refsect2><title><sgmltag>matrix</></title><para>
This element holds the four <sgmltag>double</> elements of an affine
transformation.
  </para></refsect2>
  <refsect2><title><sgmltag>name</></title><para>
Holds a property name.  Evaluates to the first value from the property of
the font, not the pattern.
  </para></refsect2>
  <refsect2><title><sgmltag>const</></title><para>
Holds the name of a constant; these are always integers and serve as
symbolic names for common font values:
    <programlisting>
  Constant        Property        Value
  -------------------------------------
  light           weight          0
  medium          weight          100
  demibold        weight          180
  bold            weight          200
  black           weight          210
  roman           slant           0
  italic          slant           100
  oblique         slant           110
  proportional    spacing         0
  mono            spacing         100
  charcell        spacing         110
  unknown         rgba            0
  rgb             rgba            1
  bgr             rgba            2
  vrgb            rgba            3
  vbgr            rgba            4
  none            rgba            5
    </programlisting>
      </para>
    </refsect2>
  <refsect2>
      <title><sgmltag>or</>, <sgmltag>and</>, <sgmltag>plus</>, <sgmltag>minus</>, <sgmltag>times</>, <sgmltag>divide</></title>
      <para>
These elements perform the specified operation on a list of expression
elements.  <sgmltag>or</> and <sgmltag>and</> are boolean, not bitwise.
      </para>
    </refsect2>
  <refsect2>
    <title><sgmltag>eq</>, <sgmltag>not_eq</>, <sgmltag>less</>, <sgmltag>less_eq</>, <sgmltag>more</>, <sgmltag>more_eq</></title>
    <para>
These elements compare two values, producing a boolean result.
  </para></refsect2>
  <refsect2><title><sgmltag>not</></title><para>
Inverts the boolean sense of its one expression element
  </para></refsect2>
  <refsect2><title><sgmltag>if</></title><para>
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.
  </para></refsect2>
  <refsect2><title><sgmltag>alias</></title><para>
Alias elements provide a shorthand notation for the set of common match
operations needed to substitute one font family for another.  They contain a
<sgmltag>family</> element followed by optional <sgmltag>prefer</>, <sgmltag>accept</> and <sgmltag>default</>
elements.  Fonts matching the <sgmltag>family</> element are edited to prepend the
list of <sgmltag>prefer</>ed families before the matching <sgmltag>family</>, append the
<sgmltag>accept</>able familys after the matching <sgmltag>family</> and append the <sgmltag>default</>
families to the end of the family list.
  </para></refsect2>
  <refsect2><title><sgmltag>family</></title><para>
Holds a single font family name
  </para></refsect2>
  <refsect2><title><sgmltag>prefer</>, <sgmltag>accept</>, <sgmltag>default</></title><para>
These hold a list of <sgmltag>family</> elements to be used by the <sgmltag>alias</> element.
<sgmltag>/article</>
  </para></refsect2>
</refsect1>
<refsect1><title>EXAMPLE CONFIGURATION FILE</title>
  <refsect2><title>System configuration file</title>
    <para>
This is an example of a system-wide configuration file
    </para>
    <programlisting>
&lt;?xml version="1.0"?&gt;
&lt;!DOCTYPE fontconfig SYSTEM "fonts.dtd"&gt;
&lt;!-- /etc/fonts/fonts.conf file to configure system font access --&gt;
&lt;fontconfig&gt;
&lt;!-- 
	Find fonts in these directories
--&gt;
&lt;dir&gt;/usr/X11R6/lib/X11/fonts/truetype&lt;/dir&gt;
&lt;dir&gt;/usr/X11R6/lib/X11/fonts/Type1&lt;/dir&gt;

&lt;!--
	Accept deprecated 'mono' alias, replacing it with 'monospace'
--&gt;
&lt;match target="pattern"&gt;
	&lt;test qual="any" name="family"&gt;&lt;string&gt;mono&lt;/string&gt;&lt;/test&gt;
	&lt;edit name="family" mode="assign"&gt;&lt;string&gt;monospace&lt;/string&gt;&lt;/edit&gt;
&lt;/match&gt;

&lt;!--
	Names not including any well known alias are given 'sans'
--&gt;
&lt;match target="pattern"&gt;
	&lt;test qual="all" name="family" mode="not_eq"&gt;sans&lt;/test&gt;
	&lt;test qual="all" name="family" mode="not_eq"&gt;serif&lt;/test&gt;
	&lt;test qual="all" name="family" mode="not_eq"&gt;monospace&lt;/test&gt;
	&lt;edit name="family" mode="append_last"&gt;&lt;string&gt;sans&lt;/string&gt;&lt;/edit&gt;
&lt;/match&gt;

&lt;!--
	Load per-user customization file, but don't complain
	if it doesn't exist
--&gt;
&lt;include ignore_missing="yes"&gt;~/.fonts.conf&lt;/include&gt;

&lt;!--
	Alias well known font names to available TrueType fonts.
	These substitute TrueType faces for similar Type1
	faces to improve screen appearance.
--&gt;
&lt;alias&gt;
	&lt;family&gt;Times&lt;/family&gt;
	&lt;prefer&gt;&lt;family&gt;Times New Roman&lt;/family&gt;&lt;/prefer&gt;
	&lt;default&gt;&lt;family&gt;serif&lt;/family&gt;&lt;/default&gt;
&lt;/alias&gt;
&lt;alias&gt;
	&lt;family&gt;Helvetica&lt;/family&gt;
	&lt;prefer&gt;&lt;family&gt;Verdana&lt;/family&gt;&lt;/prefer&gt;
	&lt;default&gt;&lt;family&gt;sans&lt;/family&gt;&lt;/default&gt;
&lt;/alias&gt;
&lt;alias&gt;
	&lt;family&gt;Courier&lt;/family&gt;
	&lt;prefer&gt;&lt;family&gt;Courier New&lt;/family&gt;&lt;/prefer&gt;
	&lt;default&gt;&lt;family&gt;monospace&lt;/family&gt;&lt;/default&gt;
&lt;/alias&gt;

&lt;!--
	Provide required aliases for standard names
	Do these after the users configuration file so that
	any aliases there are used preferentially
--&gt;
&lt;alias&gt;
	&lt;family&gt;serif&lt;/family&gt;
	&lt;prefer&gt;&lt;family&gt;Times New Roman&lt;/family&gt;&lt;/prefer&gt;
&lt;/alias&gt;
&lt;alias&gt;
	&lt;family&gt;sans&lt;/family&gt;
	&lt;prefer&gt;&lt;family&gt;Verdana&lt;/family&gt;&lt;/prefer&gt;
&lt;/alias&gt;
&lt;alias&gt;
	&lt;family&gt;monospace&lt;/family&gt;
	&lt;prefer&gt;&lt;family&gt;Andale Mono&lt;/family&gt;&lt;/prefer&gt;
&lt;/alias&gt;
&lt;/fontconfig&gt;
    </programlisting>
  </refsect2>
  <refsect2><title>User configuration file</title>
    <para>
This is an example of a per-user configuration file that lives in
~/.fonts.conf
    </para>
    <programlisting>
&lt;?xml version="1.0"?&gt;
&lt;!DOCTYPE fontconfig SYSTEM "fonts.dtd"&gt;
&lt;!-- ~/.fonts.conf for per-user font configuration --&gt;
&lt;fontconfig&gt;

&lt;!--
	Private font directory
--&gt;
&lt;dir&gt;~/misc/fonts&lt;/dir&gt;

&lt;!--
	use rgb sub-pixel ordering to improve glyph appearance on
	LCD screens.  Changes affecting rendering, but not matching
	should always use target="font".
--&gt;
&lt;match target="font"&gt;
	&lt;edit name="rgba" mode="assign"&gt;&lt;const&gt;rgb&lt;/const&gt;&lt;/edit&gt;
&lt;/match&gt;
&lt;/fontconfig&gt;
    </programlisting>
  </refsect2>
</refsect1>
<refsect1><title>Files</title>
  <para>
<emphasis>fonts.conf</emphasis>
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.
  </para>
  <para>
<emphasis>fonts.dtd</emphasis>
is a DTD that describes the format of the configuration files.
  </para>
  <para>
<emphasis>~/.fonts.conf</emphasis>
is the conventional location for per-user font configuration, although the
actual location is specified in the global fonts.conf file.
  </para>
  <para>
<emphasis> ~/.fonts.cache-*</emphasis>
is the conventional repository of font information that isn't found in the
per-directory caches.  This file is automatically maintained by fontconfig.
  </para>
</refsect1>
<refsect1><title>Version</title>
	    <para>
Fontconfig version &version;
	    </para>
</refsect1>
</refentry>

--- NEW FILE: fontconfig-user.txt ---

                              fonts-conf

Name

   fonts.conf -- Font configuration files

Synopsis

   /etc/fonts/fonts.conf
   /etc/fonts/fonts.dtd
   ~/.fonts.conf

Description

   Fontconfig is a library designed to provide system-wide font
   configuration, customization and application access.

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.

Font Configuration

   The configuration module consists of the FcConfig datatype,
   libexpat and FcConfigParse which walks over an XML tree and
   ammends 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
   simplify and regularize font installation and customization.

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.
  Property        Type    Description
  --------------------------------------------------------------
  family          String  Font family name
  style           String  Font style. Overrides weight and slant
  slant           Int     Italic, oblique or roman
  weight          Int     Light, medium, demibold, bold or black
  size            Double  Point size
  aspect          Double  Stretches glyphs horizontally before hinting
  pixelsize       Double  Pixel size
  spacing         Int     Proportional, monospace or charcell
  foundry         String  Font foundry name
  antialias       Bool    Whether glyphs can be antialiased
  hinting         Bool    Whether the rasterizer should use hinting
  verticallayout  Bool    Use vertical layout
  autohint        Bool    Use autohinter instead of normal hinter
  globaladvance   Bool    Use font global advance data
  file            String  The filename holding the font
  index           Int     The index of the font within the file
  ftface          FT_Face Use the specified FreeType face object
  rasterizer      String  Which rasterizer is in use
  outline         Bool    Whether the glyphs are outlines
  scalable        Bool    Whether glyphs can be scaled
  scale           Double  Scale factor for point->pixel conversions
  dpi             Double  Target dots per inch
  rgba            Int     unknown, rgb, bgr, vrgb, vbgr,
                          none - subpixel geometry
  minspace        Bool    Eliminate leading from line spacing
  charset         CharSet Unicode chars encoded by the font
  lang            String  List of RFC-3066-style languages this
                          font supports

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 a pattern. 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.

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:
        <families>-<point sizes>:<name1>=<values1>:<name2>=<values2>...

   Values in a list are separated with commas. The name needn't
   include either families or point sizes; they can be elided. In
   addition, there are symbolic constants that simultaneously
   indicate both a name and a value. Here are some examples:
  Name                            Meaning
  ----------------------------------------------------------
  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

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.

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 "fonts.dtd"; this is normally stored in the
   default font configuration directory (/etc/fonts). Each
   configuration file should contain the following structure:
        <?xml version="1.0"?>
        <!DOCTYPE fontconfig SYSTEM "fonts.dtd">
        <fontconfig>
        ...
        </fontconfig>

<fontconfig>

   This is the top level element for a font configuration and can
   contain dir, cache, include, match and alias elements in any
   order.

dir

   This element contains a directory name which will be scanned
   for font files to include in the set of available fonts.

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).

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.

config

   This element provides a place to consolodate additional
   configuration information. config can contain blank and rescan
   elements in any order.

blank

   Fonts often include "broken" glyphs which appear in the
   encoding but are drawn as blanks on the screen. Within the
   blank element, place each Unicode characters which is supposed
   to be blank in an int element. Characters outside of this set
   which are drawn as blank will be elided from the set of
   characters supported by the font.

rescan

   The rescan element holds an 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.

match target="pattern"

   This element holds first a (possibly empty) list of test
   elements and then a (possibly empty) list of 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.

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.

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 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:
  Mode                    With Match              Without Match
  ---------------------------------------------------------------------
  "assign"                Replace matching value  Replace all values
  "assign_replace"        Replace all values      Replace all values
  "prepend"               Insert before matching  Insert at head of lis
t
  "prepend_first"         Insert at head of list  Insert at head of lis
t
  "append"                Append after matching   Append at end of list
  "append_last"           Append at end of list   Append at end of list

int, double, string, bool

   These elements hold a single value of the indicated type. bool
   elements hold either true or false. An important limitation
   exists in the parsing of floating point numbers -- fontconfig
   requires that the mantissa start with a digit, not a decimal
   point, so insert a leading zero for purely fractional values
   (e.g. use 0.5 instead of .5 and -0.5 instead of -.5).

matrix

   This element holds the four double elements of an affine
   transformation.

name

   Holds a property name. Evaluates to the first value from the
   property of the font, not the pattern.

const

   Holds the name of a constant; these are always integers and
   serve as symbolic names for common font values:
  Constant        Property        Value
  -------------------------------------
  light           weight          0
  medium          weight          100
  demibold        weight          180
  bold            weight          200
  black           weight          210
  roman           slant           0
  italic          slant           100
  oblique         slant           110
  proportional    spacing         0
  mono            spacing         100
  charcell        spacing         110
  unknown         rgba            0
  rgb             rgba            1
  bgr             rgba            2
  vrgb            rgba            3
  vbgr            rgba            4
  none            rgba            5

or, and, plus, minus, times, divide

   These elements perform the specified operation on a list of
   expression elements. or and and are boolean, not bitwise.

eq, not_eq, less, less_eq, more, more_eq

   These elements compare two values, producing a boolean result.

not

   Inverts the boolean sense of its one expression element

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.

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 family element followed by
   optional prefer, accept and default elements. Fonts matching
   the family element are edited to prepend the list of prefered
   families before the matching family, append the acceptable
   familys after the matching family and append the default
   families to the end of the family list.

family

   Holds a single font family name

prefer, accept, default

   These hold a list of family elements to be used by the alias
   element. /article

EXAMPLE CONFIGURATION FILE

System configuration file

   This is an example of a system-wide configuration file
<?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></e
dit>
</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></e
dit>
</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>

User configuration file

   This is an example of a per-user configuration file that lives
   in ~/.fonts.conf
<?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>

Files

   fonts.conf 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.

   fonts.dtd is a DTD that describes the format of the
   configuration files.

   ~/.fonts.conf is the conventional location for per-user font
   configuration, although the actual location is specified in
   the global fonts.conf file.

   ~/.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.

Version

   Fontconfig version 2.2.2

--- NEW FILE: fonts-conf.5 ---
.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve at ggi-project.org>.
.TH "FONTS-CONF" "5" "10 March 2004" "" ""

.SH NAME
fonts.conf \- Font configuration files
.SH SYNOPSIS

.nf
   /etc/fonts/fonts.conf
   /etc/fonts/fonts.dtd
   ~/.fonts.conf
.fi
.SH "DESCRIPTION"
.PP
Fontconfig is a library designed to provide system-wide font configuration,
customization and application access.
.SH "FUNCTIONAL OVERVIEW"
.PP
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.
.SS "FONT CONFIGURATION"
.PP
The configuration module consists of the FcConfig datatype, libexpat and
FcConfigParse which walks over an XML tree and ammends 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.  
.PP
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.
.PP
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
simplify and regularize font installation and customization.
.SS "FONT PROPERTIES"
.PP
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.

.nf
  Property        Type    Description
  --------------------------------------------------------------
  family          String  Font family name
  style           String  Font style. Overrides weight and slant
  slant           Int     Italic, oblique or roman
  weight          Int     Light, medium, demibold, bold or black
  size            Double  Point size
  aspect          Double  Stretches glyphs horizontally before hinting
  pixelsize       Double  Pixel size
  spacing         Int     Proportional, monospace or charcell
  foundry         String  Font foundry name
  antialias       Bool    Whether glyphs can be antialiased
  hinting         Bool    Whether the rasterizer should use hinting
  verticallayout  Bool    Use vertical layout
  autohint        Bool    Use autohinter instead of normal hinter
  globaladvance   Bool    Use font global advance data
  file            String  The filename holding the font
  index           Int     The index of the font within the file
  ftface          FT_Face Use the specified FreeType face object
  rasterizer      String  Which rasterizer is in use
  outline         Bool    Whether the glyphs are outlines
  scalable        Bool    Whether glyphs can be scaled
  scale           Double  Scale factor for point->pixel conversions
  dpi             Double  Target dots per inch
  rgba            Int     unknown, rgb, bgr, vrgb, vbgr,
                          none - subpixel geometry
  minspace        Bool    Eliminate leading from line spacing
  charset         CharSet Unicode chars encoded by the font
  lang            String  List of RFC-3066-style languages this
                          font supports

.fi
.SS "FONT MATCHING"
.PP
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.
.PP
Font matching starts with an application constructed pattern.  The desired
attributes of the resulting font are collected together in a pattern.  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.
.PP
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.
.PP
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.
.PP
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.
.PP
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.
.PP
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.
.PP
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.
.PP
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.
.SS "FONT NAMES"
.PP
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:

.nf
	<families>-<point sizes>:<name1>=<values1>:<name2>=<values2>...

.fi
.PP
Values in a list are separated with commas.  The name needn't include either
families or point sizes; they can be elided.  In addition, there are
symbolic constants that simultaneously indicate both a name and a value.
Here are some examples:

.nf
  Name                            Meaning
  ----------------------------------------------------------
  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

.fi
.SH "LANG TAGS"
.PP
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.
.PP
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.
.SH "CONFIGURATION FILE FORMAT"
.PP
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.
.PP
The fontconfig document type definition resides in the external entity
"fonts.dtd"; this is normally stored in the default font configuration
directory (/etc/fonts).  Each configuration file should contain the
following structure:

.nf
	<?xml version="1.0"?>
	<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
	<fontconfig>
	...
	</fontconfig>

.fi
.SS "<FONTCONFIG>"
.PP
This is the top level element for a font configuration and can contain
dir, cache, include, match and alias elements in any order.
.SS "DIR"
.PP
This element contains a directory name which will be scanned for font files
to include in the set of available fonts.
.SS "CACHE"
.PP
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).
.SS "INCLUDE IGNORE_MISSING=\&"NO\&""
.PP
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.
.SS "CONFIG"
.PP
This element provides a place to consolodate additional configuration
information.  config can contain blank and rescan elements in any
order.
.SS "BLANK"
.PP
Fonts often include "broken" glyphs which appear in the encoding but are
drawn as blanks on the screen.  Within the blank element, place each
Unicode characters which is supposed to be blank in an int element.
Characters outside of this set which are drawn as blank will be elided from
the set of characters supported by the font.
.SS "RESCAN"
.PP
The rescan element holds an 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.
.SS "MATCH TARGET=\&"PATTERN\&""
.PP
This element holds first a (possibly empty) list of test elements and then
a (possibly empty) list of 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.
.SS "TEST QUAL=\&"ANY\&" NAME=\&"PROPERTY\&" COMPARE=\&"EQ\&""
.PP
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.
.SS "EDIT NAME=\&"PROPERTY\&" MODE=\&"ASSIGN\&" BINDING=\&"WEAK\&""
.PP
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 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:

.nf
  Mode                    With Match              Without Match
  ---------------------------------------------------------------------
  "assign"                Replace matching value  Replace all values
  "assign_replace"        Replace all values      Replace all values
  "prepend"               Insert before matching  Insert at head of list
  "prepend_first"         Insert at head of list  Insert at head of list
  "append"                Append after matching   Append at end of list
  "append_last"           Append at end of list   Append at end of list

.fi
.SS "INT, DOUBLE, STRING, BOOL"
.PP
These elements hold a single value of the indicated type.  bool
elements hold either true or false.  An important limitation exists in
the parsing of floating point numbers -- fontconfig requires that
the mantissa start with a digit, not a decimal point, so insert a leading
zero for purely fractional values (e.g. use 0.5 instead of .5 and -0.5
instead of -.5).
.SS "MATRIX"
.PP
This element holds the four double elements of an affine
transformation.
.SS "NAME"
.PP
Holds a property name.  Evaluates to the first value from the property of
the font, not the pattern.
.SS "CONST"
.PP
Holds the name of a constant; these are always integers and serve as
symbolic names for common font values:

.nf
  Constant        Property        Value
  -------------------------------------
  light           weight          0
  medium          weight          100
  demibold        weight          180
  bold            weight          200
  black           weight          210
  roman           slant           0
  italic          slant           100
  oblique         slant           110
  proportional    spacing         0
  mono            spacing         100
  charcell        spacing         110
  unknown         rgba            0
  rgb             rgba            1
  bgr             rgba            2
  vrgb            rgba            3
  vbgr            rgba            4
  none            rgba            5

.fi
.SS "OR, AND, PLUS, MINUS, TIMES, DIVIDE"
.PP
These elements perform the specified operation on a list of expression
elements.  or and and are boolean, not bitwise.
.SS "EQ, NOT_EQ, LESS, LESS_EQ, MORE, MORE_EQ"
.PP
These elements compare two values, producing a boolean result.
.SS "NOT"
.PP
Inverts the boolean sense of its one expression element
.SS "IF"
.PP
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.
.SS "ALIAS"
.PP
Alias elements provide a shorthand notation for the set of common match
operations needed to substitute one font family for another.  They contain a
family element followed by optional prefer, accept and default
elements.  Fonts matching the family element are edited to prepend the
list of prefered families before the matching family, append the
acceptable familys after the matching family and append the default
families to the end of the family list.
.SS "FAMILY"
.PP
Holds a single font family name
.SS "PREFER, ACCEPT, DEFAULT"
.PP
These hold a list of family elements to be used by the alias element.
/article
.SH "EXAMPLE CONFIGURATION FILE"
.SS "SYSTEM CONFIGURATION FILE"
.PP
This is an example of a system-wide configuration file

.nf
<?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>

.fi
.SS "USER CONFIGURATION FILE"
.PP
This is an example of a per-user configuration file that lives in
~/.fonts.conf

.nf
<?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>

.fi
.SH "FILES"
.PP
\fBfonts.conf\fR
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.
.PP
\fBfonts.dtd\fR
is a DTD that describes the format of the configuration files.
.PP
\fB~/.fonts.conf\fR
is the conventional location for per-user font configuration, although the
actual location is specified in the global fonts.conf file.
.PP
\fB ~/.fonts.cache-*\fR
is the conventional repository of font information that isn't found in the
per-directory caches.  This file is automatically maintained by fontconfig.
.SH "VERSION"
.PP
Fontconfig version 2.2.2

--- NEW FILE: func.sgml ---
(This appears to be a binary file; contents omitted.)

--- NEW FILE: version.sgml.in ---
(This appears to be a binary file; contents omitted.)