Update ChangeLog, fix some bugs in the man page

This commit is contained in:
Keith Packard 2002-08-26 20:52:59 +00:00
parent f21f40f347
commit 5d6788ac7e
2 changed files with 39 additions and 32 deletions

View File

@ -1,3 +1,6 @@
Mon Aug 26 13:37:23 PDT 2002 keithp
+ Append a version number to cache filenames
Thu Aug 22 11:36:18 PDT 2002 keithp Thu Aug 22 11:36:18 PDT 2002 keithp
+ Add "contains" and "not_contains" operators and elements to + Add "contains" and "not_contains" operators and elements to

View File

@ -1,5 +1,5 @@
.\" .\"
.\" $XFree86: xc/lib/fontconfig/src/fontconfig.man,v 1.3 2002/08/11 18:10:43 keithp Exp $ .\" $XFree86: xc/lib/fontconfig/src/fontconfig.man,v 1.5 2002/08/26 19:57:40 keithp Exp $
.\" .\"
.\" Copyright © 2002 Keith Packard, member of The XFree86 Project, Inc. .\" Copyright © 2002 Keith Packard, member of The XFree86 Project, Inc.
.\" .\"
@ -24,7 +24,8 @@
.de TQ .de TQ
.br .br
.ns .ns
.TP \\$1 .TP
\\$1
.. ..
.TH FONTCONFIG 3 "Version 1.0" "XFree86" .TH FONTCONFIG 3 "Version 1.0" "XFree86"
@ -430,8 +431,8 @@ Returns FcTrue if 'mat1' and 'mat2' are equal, else FcFalse.
.TP .TP
void FcMatrixMultiply (FcMatrix *result, const FcMatrix *a, const FcMatrix *b) void FcMatrixMultiply (FcMatrix *result, const FcMatrix *a, const FcMatrix *b)
Multiplies 'a' and 'b' together, placing the result in Multiplies 'a' and 'b' together, placing the result in 'result'. 'result'
'result'. 'result' may refer to the sam matrix as either 'a' or 'b'. may refer to the sam matrix as either 'a' or 'b'.
.TP .TP
void FcMatrixRotate (FcMatrix *m, double c, double s) void FcMatrixRotate (FcMatrix *m, double c, double s)
@ -509,11 +510,13 @@ Returns the number of chars that are in 'a' but not in 'b'.
FcBool FcCharSetIsSubset (const FcCharSet *a, const FcCharSet *b) FcBool FcCharSetIsSubset (const FcCharSet *a, const FcCharSet *b)
Returns whether 'a' is a subset of 'b'. Returns whether 'a' is a subset of 'b'.
.TP FcChar32 FcCharSetFirstPage (const FcCharSet *a, FcChar32 [FC_CHARSET_MAP_SIZE], FcChar32 *next) .TP
FcChar32 FcCharSetFirstPage (const FcCharSet *a, FcChar32 [FC_CHARSET_MAP_SIZE], FcChar32 *next)
Builds an array of bits marking the first page of Unicode coverage of 'a'. Builds an array of bits marking the first page of Unicode coverage of 'a'.
Returns the base of the array. 'next' contains the next page in the font. Returns the base of the array. 'next' contains the next page in the font.
.TP FcChar32 FcCharSetNextPage (const FcCharSet *a, FcChar32 [FC_CHARSET_MAP_SIZE], FcChar32 *next) .TP
FcChar32 FcCharSetNextPage (const FcCharSet *a, FcChar32 [FC_CHARSET_MAP_SIZE], FcChar32 *next)
Builds an array of bits marking the Unicode coverage of 'a' for page '*next'. Builds an array of bits marking the Unicode coverage of 'a' for page '*next'.
Returns the base of the array. 'next' contains the next page in the font. Returns the base of the array. 'next' contains the next page in the font.
@ -720,7 +723,8 @@ These build an object set from a null-terminated list of property names.
Provides for applcation-specified font name object types so that new Provides for applcation-specified font name object types so that new
pattern elements can be generated from font names. pattern elements can be generated from font names.
.TP FcBool FcNameRegisterObjectTypes (const FcObjectType *types, int ntype) .TP
FcBool FcNameRegisterObjectTypes (const FcObjectType *types, int ntype)
Register 'ntype' new object types. Register 'ntype' new object types.
.TP .TP
@ -885,8 +889,8 @@ been called for 'p'; otherwise the results will not be correct.
FcFontSet *FcFontSort (FcConfig *config, FcPattern *p, FcBool trim, FcCharSet **csp, FcResult *result) Returns the list of fonts sorted by FcFontSet *FcFontSort (FcConfig *config, FcPattern *p, FcBool trim, FcCharSet **csp, FcResult *result) Returns the list of fonts sorted by
closeness to 'p'. If 'trim' is FcTrue, elements in the list which don't closeness to 'p'. If 'trim' is FcTrue, elements in the list which don't
include Unicode coverage not provided by earlier elements in the list are 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 elided. The union of Unicode coverage of all of the fonts is returned
'csp', if 'csp' is not NULL. This function should be called only after in 'csp', if 'csp' is not NULL. This function should be called only after
FcConfigSubstitute and FcDefaultSubstitute have been called for 'p'; FcConfigSubstitute and FcDefaultSubstitute have been called for 'p';
otherwise the results will not be correct. otherwise the results will not be correct.
.P .P
@ -899,9 +903,9 @@ The FcFontSet returned by FcFontSort is destroyed by caling FcFontSetDestroy.
.TP .TP
FcPattern *FcFontRenderPrepare (FcConfig *config, FcPattern *pat, FcPattern *font) FcPattern *FcFontRenderPrepare (FcConfig *config, FcPattern *pat, FcPattern *font)
Creates a new pattern consisting of elements of 'font' not appearing in Creates a new pattern consisting of elements of 'font' not appearing
'pat', elements of 'pat' not appearing in 'font' and the best matching value in 'pat', elements of 'pat' not appearing in 'font' and the best matching
from 'pat' for elements appearing in both. The result is passed to value from 'pat' for elements appearing in both. The result is passed to
FcConfigSubstitute with 'kind' FcMatchFont and then returned. FcConfigSubstitute with 'kind' FcMatchFont and then returned.
.TP .TP
@ -978,8 +982,8 @@ locked.
.TP .TP
FcChar8 *FcAtomicNewFile (FcAtomic *atomic) FcChar8 *FcAtomicNewFile (FcAtomic *atomic)
Returns the filename for writing a new version of the file refernced by Returns the filename for writing a new version of the file referenced
'atomic'. by 'atomic'.
.TP .TP
FcChar8 *FcAtomicOrigFile (FcAtomic *atomic) FcChar8 *FcAtomicOrigFile (FcAtomic *atomic)
@ -1020,8 +1024,8 @@ higher level functions.
.TP .TP
FcCharSet *FcFreeTypeCharSet (FT_Face face, FcBlanks *blanks) Scans a FcCharSet *FcFreeTypeCharSet (FT_Face face, FcBlanks *blanks) Scans a
FreeType face and returns the set of encoded Unicode chars. This scans FreeType face and returns the set of encoded Unicode chars. This scans
several encoding tables to build as complete a list as possible. If several encoding tables to build as complete a list as possible.
'blanks' is not 0, the glyphs in the font are examined and any blank glyphs 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. not in 'blanks' are not placed in the returned FcCharSet.
.TP .TP
@ -1032,8 +1036,8 @@ of fonts in 'file' is returned in 'count'.
.SS XML specific functions .SS XML specific functions
.TP .TP
FcBool FcConfigParseAndLoad (FcConfig *config, const FcChar8 *file, FcBool complain) FcBool FcConfigParseAndLoad (FcConfig *config, const FcChar8 *file, FcBool complain)
Walks the configuration in 'file' and constructs the internal representation in Walks the configuration in 'file' and constructs the internal representation
'config'. Any include files referenced from within 'file' will be loaded in 'config'. Any include files referenced from within 'file' will be loaded
with FcConfigLoad and also parsed. If 'complain' is FcFalse, no warning with FcConfigLoad and also parsed. If 'complain' is FcFalse, no warning
will be displayed if 'file' does not exist. will be displayed if 'file' does not exist.
@ -1131,21 +1135,21 @@ long. Bytes of 'src' are combined into 16-bit units according to 'endian'.
.TP .TP
FcBool FcUtf16Len (FcChar8 *src, FcEndian endian, int len, int *nchar, int *wchar) FcBool FcUtf16Len (FcChar8 *src, FcEndian endian, int len, int *nchar, int *wchar)
Counts the number of Unicode chars in 'len' bytes of 'src'. Bytes of Counts the number of Unicode chars in 'len' bytes of 'src'. Bytes of 'src'
'src' are combined into 16-bit units according to 'endian'. Places that are combined into 16-bit units according to 'endian'. Places that
count in 'nchar'. 'wchar' contains 1, 2 or 4 depending on the number of count in 'nchar'. 'wchar' contains 1, 2 or 4 depending on the number of
bytes needed to hold the largest unicode char counted. The return value bytes needed to hold the largest unicode char counted. The return value
indicates whether 'string' is a well-formed UTF16 string. indicates whether 'string' is a well-formed UTF16 string.
.TP .TP
FcChar8 *FcStrCopy (const FcChar8 *s) FcChar8 *FcStrCopy (const FcChar8 *s)
Allocates memory, copies 's' and returns the resulting buffer. Yes, this is Allocates memory, copies 's' and returns the resulting buffer. Yes, this
'strdup', but that function isn't available on every platform. is 'strdup', but that function isn't available on every platform.
.TP .TP
FcChar8 *FcStrCopyFilename (const FcChar8 *s) FcChar8 *FcStrCopyFilename (const FcChar8 *s)
Just like FcStrCopy except that it converts any leading '~' characters in Just like FcStrCopy except that it converts any leading '~' characters
's' to the value of the HOME environment variable. in 's' to the value of the HOME environment variable.
.TP .TP
int FcStrCmpIgnoreCase (const char *s1, const char *s2) int FcStrCmpIgnoreCase (const char *s1, const char *s2)
@ -1232,8 +1236,8 @@ resulting from a match rather than a font pattern to be matched.
.SS <test qual="any" name="property" compare="eq"> .SS <test qual="any" name="property" compare="eq">
This element contains a single value which is compared with the pattern This element contains a single value which is compared with the pattern
property "property" (substitute any of the property names seen above). property "property" (substitute any of the property names seen
'compare' can be one of "eq", "not_eq", "less", "less_eq", "more", or 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 "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 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 "all", in which case all of the values associated with the property must