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

« back to all changes in this revision

Viewing changes to doc/fontconfig-devel.sgml

  • 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:
1
1
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
2
2
<!ENTITY fcatomic SYSTEM "fcatomic.sgml">
3
3
<!ENTITY fcblanks SYSTEM "fcblanks.sgml">
 
4
<!ENTITY fccache SYSTEM "fccache.sgml">
4
5
<!ENTITY fccharset SYSTEM "fccharset.sgml">
5
6
<!ENTITY fcconfig SYSTEM "fcconfig.sgml">
6
7
<!ENTITY fcconstant SYSTEM "fcconstant.sgml">
 
8
<!ENTITY fcdircache SYSTEM "fcdircache.sgml">
7
9
<!ENTITY fcfile SYSTEM "fcfile.sgml">
8
10
<!ENTITY fcfontset SYSTEM "fcfontset.sgml">
9
11
<!ENTITY fcfreetype SYSTEM "fcfreetype.sgml">
10
12
<!ENTITY fcinit SYSTEM "fcinit.sgml">
 
13
<!ENTITY fclangset SYSTEM "fclangset.sgml">
11
14
<!ENTITY fcmatrix SYSTEM "fcmatrix.sgml">
12
15
<!ENTITY fcobjectset SYSTEM "fcobjectset.sgml">
13
16
<!ENTITY fcobjecttype SYSTEM "fcobjecttype.sgml">
178
181
                                                spacing
179
182
    charset        FC_CHARSET           CharSet Unicode chars encoded by
180
183
                                                the font
181
 
    lang           FC_LANG              String  List of RFC-3066-style
 
184
    lang           FC_LANG              LangSet Set of RFC-3066-style
182
185
                                                languages this font supports
183
186
    fontversion    FC_FONTVERSION       Int     Version number of the font
184
187
    capability     FC_CAPABILITY        String  List of layout capabilities in
217
220
in a font.  Operations to build and compare these sets are provided.
218
221
    </para>
219
222
  </sect2>
 
223
  <sect2><title>FcLangSet</title>
 
224
    <para>
 
225
An FcLangSet is an abstract type that holds the set of languages supported
 
226
by a font.  Operations to build and compare these sets are provided. These
 
227
are computed for a font based on orthographic information built into the
 
228
fontconfig library. Fontconfig has orthographies for all of the ISO 639-1
 
229
languages except for MS, NA, PA, PS, QU, RN, RW, SD, SG, SN, SU and ZA. If
 
230
you have orthographic information for any of these languages, please submit
 
231
them.
 
232
    </para>
 
233
  </sect2>
 
234
  <sect2><title>FcLangResult</title>
 
235
    <para>
 
236
An FcLangResult is an enumeration used to return the results of comparing
 
237
two language strings or FcLangSet objects. FcLangEqual means the
 
238
objects match language and territory. FcLangDifferentTerritory means
 
239
the objects match in language but differ in territory.
 
240
FcLangDifferentLang means the objects differ in language.
 
241
    </para>
 
242
  </sect2>
220
243
  <sect2><title>FcType</title>
221
244
    <para>
222
245
Tags the kind of data stored in an FcValue.
236
259
                        double d;
237
260
                        const FcMatrix *m;
238
261
                        const FcCharSet *c;
 
262
                        void *f;
 
263
                        const FcLangSet *l;
239
264
                } u;
240
265
        } FcValue;
241
266
    </programlisting>
247
272
        FcTypeVoid      (none)          (none)
248
273
        FcTypeInteger   i               int
249
274
        FcTypeDouble    d               double
250
 
        FcTypeString    s               char *
 
275
        FcTypeString    s               FcChar8 *
251
276
        FcTypeBool      b               b
252
277
        FcTypeMatrix    m               FcMatrix *
253
278
        FcTypeCharSet   c               FcCharSet *
 
279
        FcTypeFTFace    f               void * (FT_Face)
 
280
        FcTypeLangSet   l               FcLangSet *
254
281
    </programlisting>
255
282
    </para>
256
283
  </sect2>
382
409
configuration files.
383
410
    </para>
384
411
  </sect2>
 
412
  <sect2><title>FcCache</title>
 
413
    <para>
 
414
Holds information about the fonts contained in a single directory. Normal
 
415
applications need not worry about this as caches for font access are
 
416
automatically managed by the library. Applications dealing with cache
 
417
management may want to use some of these objects in their work, however the
 
418
included 'fc-cache' program generally suffices for all of that.
 
419
    </para>
 
420
  </sect2>
385
421
</sect1>
386
422
<sect1><title>FUNCTIONS</title>
387
423
  <para>
444
480
    </para>
445
481
    &fccharset;
446
482
  </sect2>
 
483
  <sect2><title>FcLangSet</title>
 
484
    <para>
 
485
An FcLangSet is a set of language names (each of which include language and
 
486
an optional territory). They are used when selecting fonts to indicate which
 
487
languages the fonts need to support. Each font is marked, using language
 
488
orthography information built into fontconfig, with the set of supported
 
489
languages.
 
490
    </para>
 
491
    &fclangset;
 
492
  </sect2>
447
493
  <sect2><title>FcMatrix</title>
448
494
    <para>
449
495
FcMatrix structures hold an affine transformation in matrix form.
495
541
directory cache files.
496
542
    </para>
497
543
    &fcfile;
 
544
    &fcdircache;
 
545
  </sect2>
 
546
  <sect2><title>FcCache routines</title>
 
547
    <para>
 
548
These routines work with font directory caches, accessing their contents in
 
549
limited ways. It is not expected that normal applications will need to use
 
550
these functions.
 
551
    </para>
 
552
    &fccache;
498
553
  </sect2>
499
554
  <sect2><title>FcStrSet and FcStrList</title>
500
555
    <para>