diff options
Diffstat (limited to 'doc/fcfile.fncs')
-rwxr-xr-x | doc/fcfile.fncs | 28 |
1 files changed, 14 insertions, 14 deletions
diff --git a/doc/fcfile.fncs b/doc/fcfile.fncs index 80d7e7f..5f5f32a 100755 --- a/doc/fcfile.fncs +++ b/doc/fcfile.fncs @@ -1,5 +1,5 @@ /* - * $Id$ + * fontconfig/doc/fcfile.fncs * * Copyright © 2003 Keith Packard * @@ -7,15 +7,15 @@ * 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 + * documentation, and that the name of the author(s) not be used in * advertising or publicity pertaining to distribution of the software without - * specific, written prior permission. Keith Packard makes no + * specific, written prior permission. The authors make 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, + * THE AUTHOR(S) 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 + * EVENT SHALL THE AUTHOR(S) 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 @@ -29,7 +29,7 @@ @TYPE3@ FcFileCache * @ARG3@ cache @TYPE4@ FcBlanks * @ARG4@ blanks @TYPE5@ const FcChar8 * @ARG5@ file -@TYPE6@ FcBool% @ARG6@ force +@TYPE6@ FcBool% @ARG6@ force @PURPOSE@ scan a font file @DESC@ Scans a single file and adds all fonts found to <parameter>set</parameter>. @@ -61,15 +61,15 @@ returns FcFalse. @TYPE3@ FcFileCache * @ARG3@ cache @TYPE4@ FcBlanks * @ARG4@ blanks @TYPE5@ const FcChar8 * @ARG5@ dir -@TYPE6@ FcBool% @ARG6@ force -@PURPOSE@ DEPRECATED: formerly used to scan a font directory +@TYPE6@ FcBool% @ARG6@ force +@PURPOSE@ scan a font directory without caching it @DESC@ -This function does nothing aside from returning FcFalse. It used to scan an -entire directory and add all fonts found to -<parameter>set</parameter>. If <parameter>force</parameter> was FcTrue, then -the directory and all files within it were scanned even if information was -present in the per-directory cache file or <parameter>cache</parameter>. Any -subdirectories found were added to <parameter>dirs</parameter>. +If <parameter>cache</parameter> is not zero or if <parameter>force</parameter> +is FcFalse, this function currently returns FcFalse. Otherwise, it scans an +entire directory and adds all fonts found to <parameter>set</parameter>. +Any subdirectories found are added to <parameter>dirs</parameter>. Calling +this function does not create any cache files. Use FcDirCacheRead() if +caching is desired. @@ @RET@ FcBool |