cairo 1.10.0-x86-mingw32 → 1.10.1-x86-mingw32

data/vendor/local/share/man/man3/FcPatternFilter.3

@@ -0,0 +1,20 @@
+.\\" auto-generated by docbook2man-spec $Revision: 1.2 $
+.TH "FcPatternFilter" "3" "18 November 2009" "" ""
+.SH NAME
+FcPatternFilter \- Filter the objects of pattern
+.SH SYNOPSIS
+.nf
+\fB#include <fontconfig.h>
+.sp
+FcPattern * FcPatternFilter(FcPattern *\fIp\fB);
+(const FcObjectSet *\fI\fB);
+\fR.fi
+.SH "DESCRIPTION"
+.PP
+Returns a new pattern that only has those objects from
+\fIp\fR that are in \fIos\fR\&.
+If \fIos\fR is NULL, a duplicate of
+\fIp\fR is returned.
+.SH "VERSION"
+.PP
+Fontconfig version 2.8.0

data/vendor/local/share/man/man3/FcPatternFormat.3

@@ -0,0 +1,205 @@
+.\\" auto-generated by docbook2man-spec $Revision: 1.2 $
+.TH "FcPatternFormat" "3" "18 November 2009" "" ""
+.SH NAME
+FcPatternFormat \- Format a pattern into a string according to a format specifier
+.SH SYNOPSIS
+.nf
+\fB#include <fontconfig.h>
+.sp
+FcChar8 * FcPatternFormat(FcPattern *\fIpat\fB);
+(const FcChar8 *\fIformat\fB);
+\fR.fi
+.SH "DESCRIPTION"
+.PP
+Converts given pattern \fIpat\fR into text described by
+the format specifier \fIformat\fR\&.
+The return value refers to newly allocated memory which should be freed by the
+caller using free(), or NULL if \fIformat\fR is invalid.
+.PP
+The format is loosely modelled after printf-style format string.
+The format string is composed of zero or more directives: ordinary
+characters (not "%"), which are copied unchanged to the output stream;
+and tags which are interpreted to construct text from the pattern in a
+variety of ways (explained below).
+Special characters can be escaped
+using backslash. C-string style special characters like \\n and \\r are
+also supported (this is useful when the format string is not a C string
+literal).
+It is advisable to always escape curly braces that
+are meant to be copied to the output as ordinary characters.
+.PP
+Each tags is introduced by the character "%",
+followed by an optional minimum field width,
+followed by tag contents in curly braces ({}).
+If the minimum field width value is provided the tag
+will be expanded and the result padded to achieve the minimum width.
+If the minimum field width is positive, the padding will right-align
+the text. Negative field width will left-align.
+The rest of this section describes various supported tag contents
+and their expansion.
+.PP
+A \fIsimple\fR tag
+is one where the content is an identifier. When simple
+tags are expanded, the named identifier will be looked up in
+\fIpattern\fR and the resulting list of values returned,
+joined together using comma. For example, to print the family name and style the
+pattern, use the format "%{family} %{style}\\n". To extend the family column
+to forty characters use "%-40{family}%{style}\\n".
+.PP
+Simple tags expand to list of all values for an element. To only choose
+one of the values, one can index using the syntax "%{elt[idx]}". For example,
+to get the first family name only, use "%{family[0]}".
+.PP
+If a simple tag ends with "=" and the element is found in the pattern, the
+name of the element followed by "=" will be output before the list of values.
+For example, "%{weight=}" may expand to the string "weight=80". Or to the empty
+string if \fIpattern\fR does not have weight set.
+.PP
+If a simple tag starts with ":" and the element is found in the pattern, ":"
+will be printed first. For example, combining this with the =, the format
+"%{:weight=}" may expand to ":weight=80" or to the empty string
+if \fIpattern\fR does not have weight set.
+.PP
+If a simple tag contains the string ":-", the rest of the the tag contents
+will be used as a default string. The default string is output if the element
+is not found in the pattern. For example, the format
+"%{:weight=:-123}" may expand to ":weight=80" or to the string
+":weight=123" if \fIpattern\fR does not have weight set.
+.PP
+A \fIcount\fR tag
+is one that starts with the character "#" followed by an element
+name, and expands to the number of values for the element in the pattern.
+For example, "%{#family}" expands to the number of family names
+\fIpattern\fR has set, which may be zero.
+.PP
+A \fIsub-expression\fR tag
+is one that expands a sub-expression. The tag contents
+are the sub-expression to expand placed inside another set of curly braces.
+Sub-expression tags are useful for aligning an entire sub-expression, or to
+apply converters (explained later) on an entire sub-expression.
+For example, the format "%40{{%{family} %{style}}}" expands the sub-expression
+to construct the family name followed by the style, then takes the entire
+string and pads it on the left to be at least forty characters.
+.PP
+A \fIfilter-out\fR tag
+is one starting with the character "-" followed by a
+comma-separated list of element names, followed by a sub-expression enclosed
+in curly braces. The sub-expression will be expanded but with a pattern that
+has the listed elements removed from it.
+For example, the format "%{-size,pixelsize{sub-expr}}" will expand "sub-expr"
+with \fIpattern\fR sans the size and pixelsize elements.
+.PP
+A \fIfilter-in\fR tag
+is one starting with the character "+" followed by a
+comma-separated list of element names, followed by a sub-expression enclosed
+in curly braces. The sub-expression will be expanded but with a pattern that
+only has the listed elements from the surrounding pattern.
+For example, the format "%{+family,familylang{sub-expr}}" will expand "sub-expr"
+with a sub-pattern consisting only the family and family lang elements of
+\fIpattern\fR\&.
+.PP
+A \fIconditional\fR tag
+is one starting with the character "?" followed by a
+comma-separated list of element conditions, followed by two sub-expression
+enclosed in curly braces. An element condition can be an element name,
+in which case it tests whether the element is defined in pattern, or
+the character "!" followed by an element name, in which case the test
+is negated. The conditional passes if all the element conditions pass.
+The tag expands the first sub-expression if the conditional passes, and
+expands the second sub-expression otherwise.
+For example, the format "%{?size,dpi,!pixelsize{pass}{fail}}" will expand
+to "pass" if \fIpattern\fR has size and dpi elements but
+no pixelsize element, and to "fail" otherwise.
+.PP
+An \fIenumerate\fR tag
+is one starting with the string "[]" followed by a
+comma-separated list of element names, followed by a sub-expression enclosed
+in curly braces. The list of values for the named elements are walked in
+parallel and the sub-expression expanded each time with a pattern just having
+a single value for those elements, starting from the first value and
+continuing as long as any of those elements has a value.
+For example, the format "%{[]family,familylang{%{family} (%{familylang})\\n}}"
+will expand the pattern "%{family} (%{familylang})\\n" with a pattern
+having only the first value of the family and familylang elemtns, then expands
+it with the second values, then the third, etc.
+.PP
+As a special case, if an enumerate tag has only one element, and that element
+has only one value in the pattern, and that value is of type FcLangSet, the
+individual languages in the language set are enumerated.
+.PP
+A \fIbuiltin\fR tag
+is one starting with the character "=" followed by a builtin
+name. The following builtins are defined:
+.TP
+\fBunparse\fR
+Expands to the result of calling FcNameUnparse() on the pattern.
+.TP
+\fBfcmatch\fR
+Expands to the output of the default output format of the fc-match
+command on the pattern, without the final newline.
+.TP
+\fBfclist\fR
+Expands to the output of the default output format of the fc-list
+command on the pattern, without the final newline.
+.TP
+\fBpkgkit\fR
+Expands to the list of PackageKit font() tags for the pattern.
+Currently this includes tags for each family name, and each language
+from the pattern, enumerated and sanitized into a set of tags terminated
+by newline. Package management systems can use these tags to tag their
+packages accordingly.
+.PP
+For example, the format "%{+family,style{%{=unparse}}}\\n" will expand
+to an unparsed name containing only the family and style element values
+from \fIpattern\fR\&.
+.PP
+The contents of any tag can be followed by a set of zero or more
+\fIconverter\fRs. A converter is specified by the
+character "|" followed by the converter name and arguments. The
+following converters are defined:
+.TP
+\fBbasename\fR
+Replaces text with the results of calling FcStrBasename() on it.
+.TP
+\fBdirname\fR
+Replaces text with the results of calling FcStrDirname() on it.
+.TP
+\fBdowncase\fR
+Replaces text with the results of calling FcStrDowncase() on it.
+.TP
+\fBshescape\fR
+Escapes text for one level of shell expansion.
+(Escapes single-quotes, also encloses text in single-quotes.)
+.TP
+\fBcescape\fR
+Escapes text such that it can be used as part of a C string literal.
+(Escapes backslash and double-quotes.)
+.TP
+\fBxmlescape\fR
+Escapes text such that it can be used in XML and HTML.
+(Escapes less-than, greater-than, and ampersand.)
+.TP
+\fBdelete(\fIchars\fB)\fR
+Deletes all occurrences of each of the characters in \fIchars\fR
+from the text.
+FIXME: This converter is not UTF-8 aware yet.
+.TP
+\fBescape(\fIchars\fB)\fR
+Escapes all occurrences of each of the characters in \fIchars\fR
+by prepending it by the first character in \fIchars\fR\&.
+FIXME: This converter is not UTF-8 aware yet.
+.TP
+\fBtranslate(\fIfrom\fB,\fIto\fB)\fR
+Translates all occurrences of each of the characters in \fIfrom\fR
+by replacing them with their corresponding character in \fIto\fR\&.
+If \fIto\fR has fewer characters than
+\fIfrom\fR, it will be extended by repeating its last
+character.
+FIXME: This converter is not UTF-8 aware yet.
+.PP
+For example, the format "%{family|downcase|delete( )}\\n" will expand
+to the values of the family element in \fIpattern\fR,
+lower-cased and with spaces removed.
+.SH "VERSION"
+.PP
+Fontconfig version 2.8.0

data/vendor/local/share/man/man3/FcPatternGet-Type.3

@@ -0,0 +1,56 @@
+.\\" auto-generated by docbook2man-spec $Revision: 1.2 $
+.TH "FcPatternGet-Type" "3" "18 November 2009" "" ""
+.SH NAME
+FcPatternGetInteger, FcPatternGetDouble, FcPatternGetString, FcPatternGetMatrix, FcPatternGetCharSet, FcPatternGetBool, FcPatternGetFTFace, FcPatternGetLangSet \- Return a typed value from a pattern
+.SH SYNOPSIS
+.nf
+\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);
+(FcChar8 **\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);
+.sp
+FcResult FcPatternGetFTFace(FcPattern *\fIp\fB);
+(const char *\fIobject\fB);
+(int \fIn\fB);
+.sp
+FcResult FcPatternGetLangSet(FcPattern *\fIp\fB);
+(const char *\fIobject\fB);
+(FT_Face *\fIf\fB);
+\fR.fi
+.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.8.0

data/vendor/local/share/man/man3/FcPatternGet.3

@@ -0,0 +1,22 @@
+.\\" auto-generated by docbook2man-spec $Revision: 1.2 $
+.TH "FcPatternGet" "3" "18 November 2009" "" ""
+.SH NAME
+FcPatternGet \- Return a value from a pattern
+.SH SYNOPSIS
+.nf
+\fB#include <fontconfig.h>
+.sp
+FcResult FcPatternGet(FcPattern *\fIp\fB);
+(const char *\fIobject\fB);
+(int \fIid\fB);
+(FcValue *\fIv\fB);
+\fR.fi
+.SH "DESCRIPTION"
+.PP
+Returns in \fIv\fR the \fIid\fR\&'th value
+associated with the property \fIobject\fR\&.
+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.8.0

data/vendor/local/share/man/man3/FcPatternHash.3

@@ -0,0 +1,17 @@
+.\\" auto-generated by docbook2man-spec $Revision: 1.2 $
+.TH "FcPatternHash" "3" "18 November 2009" "" ""
+.SH NAME
+FcPatternHash \- Compute a pattern hash value
+.SH SYNOPSIS
+.nf
+\fB#include <fontconfig.h>
+.sp
+FcChar32 FcPatternHash(const FcPattern *\fIp\fB);
+\fR.fi
+.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.8.0

data/vendor/local/share/man/man3/FcPatternPrint.3

@@ -0,0 +1,18 @@
+.\\" auto-generated by docbook2man-spec $Revision: 1.2 $
+.TH "FcPatternPrint" "3" "18 November 2009" "" ""
+.SH NAME
+FcPatternPrint \- Print a pattern for debugging
+.SH SYNOPSIS
+.nf
+\fB#include <fontconfig.h>
+.sp
+void FcPatternPrint(const FcPattern *\fIp\fB);
+\fR.fi
+.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.8.0

data/vendor/local/share/man/man3/FcPatternReference.3

@@ -0,0 +1,17 @@
+.\\" auto-generated by docbook2man-spec $Revision: 1.2 $
+.TH "FcPatternReference" "3" "18 November 2009" "" ""
+.SH NAME
+FcPatternReference \- Increment pattern reference count
+.SH SYNOPSIS
+.nf
+\fB#include <fontconfig.h>
+.sp
+void FcPatternReference(FcPattern *\fIp\fB);
+\fR.fi
+.SH "DESCRIPTION"
+.PP
+Add another reference to \fIp\fR\&. Patterns are freed only
+when the reference count reaches zero.
+.SH "VERSION"
+.PP
+Fontconfig version 2.8.0

data/vendor/local/share/man/man3/FcPatternRemove.3

@@ -0,0 +1,19 @@
+.\\" auto-generated by docbook2man-spec $Revision: 1.2 $
+.TH "FcPatternRemove" "3" "18 November 2009" "" ""
+.SH NAME
+FcPatternRemove \- Remove one object of the specified type from the pattern
+.SH SYNOPSIS
+.nf
+\fB#include <fontconfig.h>
+.sp
+FcBool FcPatternRemove(FcPattern *\fIp\fB);
+(const char *\fIobject\fB);
+(int \fIid\fB);
+\fR.fi
+.SH "DESCRIPTION"
+.PP
+Removes the value associated with the property `object' at position `id', returning 
+whether the property existed and had a value at that position or not.
+.SH "VERSION"
+.PP
+Fontconfig version 2.8.0

data/vendor/local/share/man/man3/FcStrBasename.3

@@ -0,0 +1,18 @@
+.\\" auto-generated by docbook2man-spec $Revision: 1.2 $
+.TH "FcStrBasename" "3" "18 November 2009" "" ""
+.SH NAME
+FcStrBasename \- last component of filename
+.SH SYNOPSIS
+.nf
+\fB#include <fontconfig.h>
+.sp
+FcChar8 * FcStrBasename(const FcChar8 *\fIfile\fB);
+\fR.fi
+.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.8.0

data/vendor/local/share/man/man3/FcStrCmp.3

@@ -0,0 +1,18 @@
+.\\" auto-generated by docbook2man-spec $Revision: 1.2 $
+.TH "FcStrCmp" "3" "18 November 2009" "" ""
+.SH NAME
+FcStrCmp \- compare UTF-8 strings
+.SH SYNOPSIS
+.nf
+\fB#include <fontconfig.h>
+.sp
+int FcStrCmp(const FcChar8 *\fIs1\fB);
+(const FcChar8 *\fIs2\fB);
+\fR.fi
+.SH "DESCRIPTION"
+.PP
+Returns the usual <0, 0, >0 result of comparing
+\fIs1\fR and \fIs2\fR\&.
+.SH "VERSION"
+.PP
+Fontconfig version 2.8.0

data/vendor/local/share/man/man3/FcStrCmpIgnoreCase.3

@@ -0,0 +1,19 @@
+.\\" auto-generated by docbook2man-spec $Revision: 1.2 $
+.TH "FcStrCmpIgnoreCase" "3" "18 November 2009" "" ""
+.SH NAME
+FcStrCmpIgnoreCase \- compare UTF-8 strings ignoring case
+.SH SYNOPSIS
+.nf
+\fB#include <fontconfig.h>
+.sp
+int FcStrCmpIgnoreCase(const FcChar8 *\fIs1\fB);
+(const FcChar8 *\fIs2\fB);
+\fR.fi
+.SH "DESCRIPTION"
+.PP
+Returns the usual <0, 0, >0 result of comparing
+\fIs1\fR and \fIs2\fR\&. This test is
+case-insensitive for all proper UTF-8 encoded strings.
+.SH "VERSION"
+.PP
+Fontconfig version 2.8.0

data/vendor/local/share/man/man3/FcStrCopy.3

@@ -0,0 +1,18 @@
+.\\" auto-generated by docbook2man-spec $Revision: 1.2 $
+.TH "FcStrCopy" "3" "18 November 2009" "" ""
+.SH NAME
+FcStrCopy \- duplicate a string
+.SH SYNOPSIS
+.nf
+\fB#include <fontconfig.h>
+.sp
+FcChar8 * FcStrCopy(const FcChar8 *\fIs\fB);
+\fR.fi
+.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.8.0