Commit 7ec9598f47e5e8f6e05c38508d1e59e2bb9395ee
2018-08-06T17:35:14
More comment formattings. This helps in the forthcoming transition to markdown syntax.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147
diff --git a/devel/ftoption.h b/devel/ftoption.h
index 801238a..c434ac1 100644
--- a/devel/ftoption.h
+++ b/devel/ftoption.h
@@ -50,8 +50,10 @@ FT_BEGIN_HEADER
* slightly to pre-define the macro FT_CONFIG_OPTIONS_H used to
* locate this file during the build. For example,
*
+ * {
* #define FT_CONFIG_OPTIONS_H <myftoptions.h>
* #include <freetype/config/ftheader.h>
+ * }
*
* will use `$BUILD/myftoptions.h' instead of this file for macro
* definitions.
@@ -351,8 +353,7 @@ FT_BEGIN_HEADER
*
* Guessing methods to access embedded resource forks
*
- * Enable extra Mac fonts support on non-Mac platforms (e.g.
- * GNU/Linux).
+ * Enable extra Mac fonts support on non-Mac platforms (e.g., GNU/Linux).
*
* Resource forks which include fonts data are stored sometimes in
* locations which users or developers don't expected. In some cases,
@@ -429,22 +430,28 @@ FT_BEGIN_HEADER
* boolean variables (consequently, you should *never* enable this
* while compiling in `release' mode):
*
+ * {
* _af_debug_disable_horz_hints
* _af_debug_disable_vert_hints
* _af_debug_disable_blue_hints
+ * }
*
* Additionally, the following functions provide dumps of various
* internal autofit structures to stdout (using `printf'):
*
+ * {
* af_glyph_hints_dump_points
* af_glyph_hints_dump_segments
* af_glyph_hints_dump_edges
* af_glyph_hints_get_num_segments
* af_glyph_hints_get_segment_offset
+ * }
*
* As an argument, they use another global variable:
*
+ * {
* _af_debug_hints
+ * }
*
* Please have a look at the `ftgrid' demo program to see how those
* variables and macros should be used.
@@ -888,9 +895,11 @@ FT_BEGIN_HEADER
* like Fedora that did not un-patch the following change (which was
* present in FreeType between versions 2.4.6 and 2.7.1, inclusive).
*
+ * {
* 2011-07-16 Steven Chu <steven.f.chu@gmail.com>
*
* [truetype] Fix metrics on size request for scalable fonts.
+ * }
*
* This problematic commit is now reverted (more or less).
*/
diff --git a/include/freetype/config/ftoption.h b/include/freetype/config/ftoption.h
index 3062e28..18c7d13 100644
--- a/include/freetype/config/ftoption.h
+++ b/include/freetype/config/ftoption.h
@@ -50,8 +50,10 @@ FT_BEGIN_HEADER
* slightly to pre-define the macro FT_CONFIG_OPTIONS_H used to
* locate this file during the build. For example,
*
+ * {
* #define FT_CONFIG_OPTIONS_H <myftoptions.h>
* #include <freetype/config/ftheader.h>
+ * }
*
* will use `$BUILD/myftoptions.h' instead of this file for macro
* definitions.
@@ -351,8 +353,7 @@ FT_BEGIN_HEADER
*
* Guessing methods to access embedded resource forks
*
- * Enable extra Mac fonts support on non-Mac platforms (e.g.
- * GNU/Linux).
+ * Enable extra Mac fonts support on non-Mac platforms (e.g., GNU/Linux).
*
* Resource forks which include fonts data are stored sometimes in
* locations which users or developers don't expected. In some cases,
@@ -429,22 +430,28 @@ FT_BEGIN_HEADER
* boolean variables (consequently, you should *never* enable this
* while compiling in `release' mode):
*
+ * {
* _af_debug_disable_horz_hints
* _af_debug_disable_vert_hints
* _af_debug_disable_blue_hints
+ * }
*
* Additionally, the following functions provide dumps of various
* internal autofit structures to stdout (using `printf'):
*
+ * {
* af_glyph_hints_dump_points
* af_glyph_hints_dump_segments
* af_glyph_hints_dump_edges
* af_glyph_hints_get_num_segments
* af_glyph_hints_get_segment_offset
+ * }
*
* As an argument, they use another global variable:
*
+ * {
* _af_debug_hints
+ * }
*
* Please have a look at the `ftgrid' demo program to see how those
* variables and macros should be used.
@@ -888,9 +895,11 @@ FT_BEGIN_HEADER
* like Fedora that did not un-patch the following change (which was
* present in FreeType between versions 2.4.6 and 2.7.1, inclusive).
*
+ * {
* 2011-07-16 Steven Chu <steven.f.chu@gmail.com>
*
* [truetype] Fix metrics on size request for scalable fonts.
+ * }
*
* This problematic commit is now reverted (more or less).
*/
diff --git a/include/ft2build.h b/include/ft2build.h
index 4c770b2..97dbd3c 100644
--- a/include/ft2build.h
+++ b/include/ft2build.h
@@ -25,8 +25,10 @@
*
* A typical example is
*
+ * {
* #include <ft2build.h>
* #include FT_FREETYPE_H
+ * }
*
*/