ref: 214ca056f5fe29e7ae9b7b62a398fca7e5849e0d
parent: fc6d12a1f70b8d66f5d52b73501a07c2bc995933
author: Werner Lemberg <[email protected]>
date: Sun Jan 11 06:45:54 EST 2009
* include/freetype/ftbdf.h (FT_Get_BDF_Property): Improve documentation.
--- a/ChangeLog
+++ b/ChangeLog
@@ -2,6 +2,9 @@
* docs/formats.txt: Add link to PCF specification.
+ * include/freetype/ftbdf.h (FT_Get_BDF_Property): Improve
+ documentation.
+
2009-01-09 suzuki toshiya <[email protected]>
* src/base/ftadvanc.c (_ft_face_scale_advances, FT_Get_Advance,
--- a/include/freetype/ftbdf.h
+++ b/include/freetype/ftbdf.h
@@ -4,7 +4,7 @@
/* */
/* FreeType API for accessing BDF-specific strings (specification). */
/* */
-/* Copyright 2002, 2003, 2004, 2006 by */
+/* Copyright 2002, 2003, 2004, 2006, 2009 by */
/* David Turner, Robert Wilhelm, and Werner Lemberg. */
/* */
/* This file is part of the FreeType project, and may only be used, */
@@ -182,6 +182,14 @@
* This function works with BDF _and_ PCF fonts. It returns an error
* otherwise. It also returns an error if the property is not in the
* font.
+ *
+ * A `property' is a either key-value pair within the STARTPROPERTIES
+ * ... ENDPROPERTIES block of a BDF font or a key-value pair from the
+ * `info->props' array within a `FontRec' structure of a PCF font.
+ *
+ * Integer properties are always stored as `signed' within PCF fonts;
+ * consequently, @BDF_PROPERTY_TYPE_CARDINAL is a possible return value
+ * for BDF fonts only.
*
* In case of error, `aproperty->type' is always set to
* @BDF_PROPERTY_TYPE_NONE.