ref: e9d95aa06bfd96a6e182b1e9cc9f27e4a4ca09fc
parent: 9193259cf236a7db4c1e1ca9e15ad53998d272ce
author: Werner Lemberg <[email protected]>
date: Wed Dec 11 02:48:51 EST 2013
[documentation] Add section how to include FreeType header files. Problem reported by David Kastrup <[email protected]>. Surprisingly, a description how to do that was completely missing in the API reference. * include/freetype.h, include/ftchapters.h: New documentation section `header_inclusion'.
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,14 @@
+2013-12-11 Werner Lemberg <[email protected]>
+
+ [documentation] Add section how to include FreeType header files.
+ Problem reported by David Kastrup <[email protected]>.
+
+ Surprisingly, a description how to do that was completely missing in
+ the API reference.
+
+ * include/freetype.h, include/ftchapters.h: New documentation
+ section `header_inclusion'.
+
2013-12-10 Werner Lemberg <[email protected]>
[autofit] s/DFLT/NONE/, s/dflt/none/.
--- a/include/freetype.h
+++ b/include/freetype.h
@@ -42,6 +42,38 @@
/*************************************************************************/
/* */
/* <Section> */
+ /* header_inclusion */
+ /* */
+ /* <Title> */
+ /* FreeType's header inclusion scheme */
+ /* */
+ /* <Abstract> */
+ /* How client applications should include FreeType header files. */
+ /* */
+ /* <Description> */
+ /* To be as flexible as possible (and for historical reasons), */
+ /* FreeType uses a very special inclusion scheme to load header */
+ /* files, for example */
+ /* */
+ /* { */+ /* #include <ft2build.h> */
+ /* */
+ /* #include FT_FREETYPE_H */
+ /* #include FT_OUTLINE_H */
+ /* } */
+ /* */
+ /* A compiler and its preprocessor only needs an include path to find */
+ /* the file `ft2build.h'; the exact locations and names of the other */
+ /* FreeType header files are hidden by preprocessor macro names, */
+ /* loaded by `ft2build.h'. The API documentation always gives the */
+ /* header macro name needed for a particular function. */
+ /* */
+ /*************************************************************************/
+
+
+ /*************************************************************************/
+ /* */
+ /* <Section> */
/* user_allocation */
/* */
/* <Title> */
--- a/include/ftchapters.h
+++ b/include/ftchapters.h
@@ -15,6 +15,7 @@
/* General Remarks */
/* */
/* <Sections> */
+/* header_inclusion */
/* user_allocation */
/* */
/***************************************************************************/