← Back to branch summary

~ubuntu-branches/ubuntu/intrepid/fontconfig/intrepid

« back to all changes in this revision

Viewing changes to doc/fcdircache.fncs

  • Committer: Bazaar Package Importer
  • Author(s): Matthias Klose
  • Date: 2007-12-05 14:16:40 UTC
  • mfrom: (1.1.5 upstream)
  • Revision ID: james.westby@ubuntu.com-20071205141640-xikzw02c8gpgndze
Tags: 2.5.0-2ubuntu1
* Merge with Debian; remaining changes:
  - conf.d/40-nonlatin.conf: Add `MgOpen Moderna' to the list of fonts
    for which we might fall back to sans-serif.
  - conf.d/60-latin.conf: Prefer DejaVu over Bitstream Vera,
    as done for dapper.
  - 52-languageselector.conf loads language-selector.conf.
  - Include 52-languageselector.conf in the lists in conf.d/Makefile.am so
    that it actually gets installed and used.  Fixes LP 73714.
  - Some hackery in the debconf config script which attempts to upgrade
    user preferences across the many changes which have occurred to the
    debconf questions.  In particular:
    + Do not attempt to divine enable_bitmaps option by reading the
      symlinks in /etc.  This leaves the only way to permanently change
      the behaviour being dpkg-reconfigure.  The divination code was
      wrong and was intended by Debian to preserve pre-debconf
      configuration.  It would be nicer to preserve handmade updates to
      the /etc directory.
    + Always create /etc/fontconfig/conf.d/ symlink for enabling or
      disabling bitmap fonts.  This records the state from debconf
      unambiguously into the filesystem and will make it possible for
      future upgrades (from Edgy or later) to preserve handmade changes.
  - Add a (optional) include for "language-selector.conf" in fonts.conf
  - debian/patches/03_preferred_symbol_font.patch:
    + prefer "Standard Symbols L" as symbol font (Ubuntu: #37745)
  - Fix incorrect location of /usr/share/X11/fonts.
  - Correctly fix the (eg) firefox vs. (eg) evince font metrics problem:
    + New FC_ANY_METRICS property, boolean.
    + Change URW Nimbus and AMT font aliases in 30-{urw,metric}-aliases.conf
      into equivalent <match> directives so that we can add an additional
      test which disables them when the anymetrics property is true.
* Link using -Bsymbolic-functions.
* debian/rules (clean): Clean doc directory.
* debian/rules: Set shell to /bin/bash.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/fcdircache.fncs
 
1
/*
 
2
 * Copyright © 2007 Keith Packard
 
3
 *
 
4
 * Permission to use, copy, modify, distribute, and sell this software and its
 
5
 * documentation for any purpose is hereby granted without fee, provided that
 
6
 * the above copyright notice appear in all copies and that both that copyright
 
7
 * notice and this permission notice appear in supporting documentation, and
 
8
 * that the name of the copyright holders not be used in advertising or
 
9
 * publicity pertaining to distribution of the software without specific,
 
10
 * written prior permission.  The copyright holders make no representations
 
11
 * about the suitability of this software for any purpose.  It is provided "as
 
12
 * is" without express or implied warranty.
 
13
 *
 
14
 * THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
 
15
 * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
 
16
 * EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
 
17
 * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
 
18
 * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
 
19
 * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
 
20
 * OF THIS SOFTWARE.
 
21
 */
 
22
 
 
23
@RET@           FcBool
 
24
@FUNC@          FcDirCacheUnlink
 
25
@TYPE1@         const FcChar8 *                 @ARG1@          dir
 
26
@TYPE2@         FcConfig *                      @ARG2@          config
 
27
@PURPOSE@       Remove all caches related to <parameter>dir</parameter>
 
28
@DESC@
 
29
Scans the cache directories in <parameter>config</parameter>, removing any
 
30
instances of the cache file for <parameter>dir</parameter>. Returns FcFalse
 
31
when some internal error occurs (out of memory, etc). Errors actually
 
32
unlinking any files are ignored.
 
33
@@
 
34
 
 
35
@RET@           FcBool  
 
36
@FUNC@          FcDirCacheValid 
 
37
@TYPE1@         const FcChar8 *                 @ARG1@          dir
 
38
@PURPOSE@       check directory cache 
 
39
@DESC@
 
40
Returns FcTrue if <parameter>dir</parameter> has an associated valid cache
 
41
file, else returns FcFalse
 
42
@@
 
43
 
 
44
@RET@           FcCache *
 
45
@FUNC@          FcDirCacheLoad
 
46
@TYPE1@         const FcChar8 *                 @ARG1@          dir
 
47
@TYPE2@         FcConfig *                      @ARG2@          config
 
48
@TYPE3@         FcChar8 **                      @ARG3@          cache_file
 
49
@PURPOSE@       load a directory cache
 
50
@DESC@
 
51
Loads the cache related to <parameter>dir</parameter>. If no cache file
 
52
exists, returns NULL. The name of the cache file is returned in
 
53
<parameter>cache_file</parameter>, unless that is NULL. See also
 
54
FcDirCacheRead.
 
55
@@
 
56
 
 
57
@RET@           FcCache *
 
58
@FUNC@          FcDirCacheRead
 
59
@TYPE1@         const FcChar8 *                 @ARG1@          dir
 
60
@TYPE2@         FcBool%                         @ARG2@          force
 
61
@TYPE3@         FcConfig *                      @ARG3@          config
 
62
@PURPOSE@       read or construct a directory cache
 
63
@DESC@
 
64
This returns a cache for <parameter>dir</parameter>. If
 
65
<parameter>force</parameter> is FcFalse, then an existing, valid cache file
 
66
will be used. Otherwise, a new cache will be created by scanning the
 
67
directory and that returned.
 
68
@@
 
69
 
 
70
@RET@           FcCache *
 
71
@FUNC@          FcDirCacheLoadFile
 
72
@TYPE1@         const FcChar8 *                 @ARG1@          cache_file
 
73
@TYPE2@         struct stat *                   @ARG2@          file_stat
 
74
@PURPOSE@       load a cache file
 
75
@DESC@
 
76
This function loads a directory cache from
 
77
<parameter>cache_file</parameter>. If <parameter>file_stat</parameter> is
 
78
non-NULL, it will be filled with the results of stat(2) on the cache file.
 
79
@@
 
80
 
 
81
@RET@           void
 
82
@FUNC@          FcDirCacheUnload
 
83
@TYPE1@         FcCache *                       @ARG1@          cache
 
84
@PURPOSE@       unload a cache file
 
85
@DESC@
 
86
This function dereferences <parameter>cache</parameter>. When no other
 
87
references to it remain, all memory associated with the cache will be freed.
 
88
@@