Tizen 2.1 base
[external/pango1.0.git] / debian / libpango1.0-common.README.Debian
1 Pango for Debian
2 ----------------
3
4 These packages provides the renderer as the follow:
5
6  - X Window System
7  - Xft2
8  - FreeType
9
10
11 pangox.aliases file:
12 I recommend strongly that /etc/pango/pangox.aliases is
13 managed by defoma, because you can also write some font
14 settings to ~/.pangox_aliases instead. this file will get
15 preference over /etc/pango/pangox.aliases.  When you will
16 see some broken characters or empty squares, please try to
17 install suggested font packages. these packages supports
18 defoma, so pangox.aliases will be automatically generated,
19 when you install them.
20
21 If you don't want to use defoma and you prefer to edit
22 pangox.aliases manually, please run 'dpkg-reconfigure
23 libpango1.0-common', and says 'No' for manage the file by
24 yourself.
25
26
27 Static-linked probram:
28 Right now the static version of Pango1.0 includes all of
29 modules. even if your program will links those static
30 libraries, your program should have no problem.  However if
31 you see any problem, which is related the static libraries,
32 you may solve it - please try to make your program without
33 -static gcc option. I mean:
34
35 gcc -export-dynamic -o foo foo.c -Wl,-Bstatic
36  `pkg-config --cflags --libs pango` -Wl,-Bdynamic
37
38 Pango uses dlopen(3) function in order to load some
39 modules. Generally dynamic-linked programs/libraries has the
40 Procedure Linkage Table(PLT), and the undefined symbols are
41 resolved with it by the dynamic linker. however fully
42 static-linked programs has no PLT. so the dynamic linker has
43 no way to know what symbols they have. When the loadable
44 modules links another shared libraries and that shared
45 libraries has the same symbols with the static-linked
46 program, the problem may be caused. It's an ELF spec, but
47 not Pango bug.
48
49
50 Default renderer:
51 the default renderer has been changed to Xft2 since 1.2.0
52 has been released. and your font configuration depends on a
53 fontconfig configuration file /etc/fonts/fonts.conf.  If you
54 want to change any of the fonts, you need to change
55 /etc/fonts/fonts.conf.  If you want to use the X window
56 system fonts, which is managed by pangox.aliases file,
57 rather than the Xft2 renderer, you need to set GDK_USE_XFT=0
58 as an environment variable.
59
60
61 To work Pango for multilingualization:
62 You may need to install appropriate font packages to get
63 proper encodings for use with Pango.  If you don't have
64 fonts installed that are compatible with the locales you
65 want to use, you may get empty squares instead of correct
66 glyphs.
67 If you add font packages:
68 - If you use Pango with GDK_USE_XFT=0, remember to modify
69 pangox.aliases file. especially that font packages doesn't
70 support the defoma mechanism.
71 - Otherwise, remember to run fc-cache.
72
73
74  -- Akira TAGOH <tagoh@debian.org>  Sat,  6 Sep 2003 14:04:28 +0900
75