[cairo-commit] [cairo-www] src/FAQ.mdwn
cworth at freedesktop.org
Wed Oct 1 22:06:30 PDT 2008
src/FAQ.mdwn | 14 +++++++-------
1 file changed, 7 insertions(+), 7 deletions(-)
Author: Carl Worth <cworth at cworth.org>
Date: Wed Oct 1 22:05:19 2008 -0700
Minor wording tweaks to pango example.
I don't know why, but I can never seem to do a proper read-through
until after I've published something on the web. Anyway, here are
the obvious little fixups from one reading.
diff --git a/src/FAQ.mdwn b/src/FAQ.mdwn
index 1423712..35d6b60 100644
@@ -255,12 +255,12 @@ it's not intended for use in actual applications.
It's not hard to run into some of the limitations of
`cairo_show_text`. For example, it will only display glyphs from a
-single font so if you happen to choose a font that doesn't provide
+single font. So if you happen to choose a font that doesn't provide
glyphs covering every character in your string, then some characters
just won't appear. It has a host of other limitations with respect to
layout, ligatures, and shaping. We won't go into all of those details
here, but suffice it to say that if you have any aspirations of having
-reasonable internationalized text display in your application, then
+reasonable, internationalized text display in your application, then
you don't want to be using `cairo_show_text`.
Meanwhile, the non-toy APIs in cairo, (`cairo_show_glyphs` and
@@ -276,8 +276,8 @@ layout, shaping, etc. and integrates very nicely with cairo. We
heartily recommend that "real" applications wanting to display
text with cairo use pango to do it.
-And, it's also really easy to get started using pango. The pango-using
-equivalent of our code above is:
+And it's really not that hard to get started using pango. The
+pango-using equivalent of our code above is:
@@ -306,9 +306,9 @@ previous example. To get the same text origin as `cairo_show_text`,
pango_cairo_show_layout_line (cr, pango_layout_get_line (layout, 0));
-Also, to compile a pango-using program, you'll want to change the
-compilation flags we suggested before from $(pkg-config --cflags
---libs cairo) to $(pkg-config --cflags --libs pangocairo).
+Finally, to compile a pango-using program, you'll want to change the
+compilation flags we suggested before from `$(pkg-config --cflags
+--libs cairo)` to `$(pkg-config --cflags --libs pangocairo)`.
Hopefully that's enough to get started using pango. See the [Pango
Reference Manual](http://library.gnome.org/devel/pango/stable/) for
More information about the cairo-commit