Commit 86e7385342b11ac6a2a179a80585d629e97f2a1f
2018-08-06T10:24:08
Minor comment formatting.
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 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292
diff --git a/include/freetype/freetype.h b/include/freetype/freetype.h
index 92a4b44..620df4c 100644
--- a/include/freetype/freetype.h
+++ b/include/freetype/freetype.h
@@ -3239,12 +3239,12 @@ FT_BEGIN_HEADER
* hinting algorithm and have the results rendered in horizontal LCD
* pixel mode, with code like
*
- * {
- * FT_Load_Glyph( face, glyph_index,
- * load_flags | FT_LOAD_TARGET_LIGHT );
+ * {
+ * FT_Load_Glyph( face, glyph_index,
+ * load_flags | FT_LOAD_TARGET_LIGHT );
*
- * FT_Render_Glyph( face->glyph, FT_RENDER_MODE_LCD );
- * }
+ * FT_Render_Glyph( face->glyph, FT_RENDER_MODE_LCD );
+ * }
*
* In general, you should stick with one rendering mode. For example,
* switching between @FT_LOAD_TARGET_NORMAL and @FT_LOAD_TARGET_MONO
diff --git a/include/freetype/ftglyph.h b/include/freetype/ftglyph.h
index 3841930..be17a77 100644
--- a/include/freetype/ftglyph.h
+++ b/include/freetype/ftglyph.h
@@ -508,74 +508,71 @@ FT_BEGIN_HEADER
* be _replaced_ by this function (with newly allocated data).
* Typically, you would use (omitting error handling):
*
- *
- * {
- * FT_Glyph glyph;
- * FT_BitmapGlyph glyph_bitmap;
+ * {
+ * FT_Glyph glyph;
+ * FT_BitmapGlyph glyph_bitmap;
*
*
- * // load glyph
- * error = FT_Load_Char( face, glyph_index, FT_LOAD_DEFAULT );
+ * // load glyph
+ * error = FT_Load_Char( face, glyph_index, FT_LOAD_DEFAULT );
*
- * // extract glyph image
- * error = FT_Get_Glyph( face->glyph, &glyph );
+ * // extract glyph image
+ * error = FT_Get_Glyph( face->glyph, &glyph );
*
- * // convert to a bitmap (default render mode + destroying old)
- * if ( glyph->format != FT_GLYPH_FORMAT_BITMAP )
- * {
- * error = FT_Glyph_To_Bitmap( &glyph, FT_RENDER_MODE_NORMAL,
+ * // convert to a bitmap (default render mode + destroying old)
+ * if ( glyph->format != FT_GLYPH_FORMAT_BITMAP )
+ * {
+ * error = FT_Glyph_To_Bitmap( &glyph, FT_RENDER_MODE_NORMAL,
* 0, 1 );
- * if ( error ) // `glyph' unchanged
- * ...
- * }
- *
- * // access bitmap content by typecasting
- * glyph_bitmap = (FT_BitmapGlyph)glyph;
- *
- * // do funny stuff with it, like blitting/drawing
- * ...
- *
- * // discard glyph image (bitmap or not)
- * FT_Done_Glyph( glyph );
+ * if ( error ) // `glyph' unchanged
+ * ...
* }
*
+ * // access bitmap content by typecasting
+ * glyph_bitmap = (FT_BitmapGlyph)glyph;
*
- * Here another example, again without error handling:
- *
+ * // do funny stuff with it, like blitting/drawing
+ * ...
*
- * {
- * FT_Glyph glyphs[MAX_GLYPHS]
+ * // discard glyph image (bitmap or not)
+ * FT_Done_Glyph( glyph );
+ * }
*
+ * Here another example, again without error handling:
*
- * ...
+ * {
+ * FT_Glyph glyphs[MAX_GLYPHS]
*
- * for ( idx = 0; i < MAX_GLYPHS; i++ )
- * error = FT_Load_Glyph( face, idx, FT_LOAD_DEFAULT ) ||
- * FT_Get_Glyph ( face->glyph, &glyphs[idx] );
*
- * ...
+ * ...
*
- * for ( idx = 0; i < MAX_GLYPHS; i++ )
- * {
- * FT_Glyph bitmap = glyphs[idx];
+ * for ( idx = 0; i < MAX_GLYPHS; i++ )
+ * error = FT_Load_Glyph( face, idx, FT_LOAD_DEFAULT ) ||
+ * FT_Get_Glyph ( face->glyph, &glyphs[idx] );
*
+ * ...
*
- * ...
+ * for ( idx = 0; i < MAX_GLYPHS; i++ )
+ * {
+ * FT_Glyph bitmap = glyphs[idx];
*
- * // after this call, `bitmap' no longer points into
- * // the `glyphs' array (and the old value isn't destroyed)
- * FT_Glyph_To_Bitmap( &bitmap, FT_RENDER_MODE_MONO, 0, 0 );
*
- * ...
+ * ...
*
- * FT_Done_Glyph( bitmap );
- * }
+ * // after this call, `bitmap' no longer points into
+ * // the `glyphs' array (and the old value isn't destroyed)
+ * FT_Glyph_To_Bitmap( &bitmap, FT_RENDER_MODE_MONO, 0, 0 );
*
* ...
*
- * for ( idx = 0; i < MAX_GLYPHS; i++ )
- * FT_Done_Glyph( glyphs[idx] );
+ * FT_Done_Glyph( bitmap );
* }
+ *
+ * ...
+ *
+ * for ( idx = 0; i < MAX_GLYPHS; i++ )
+ * FT_Done_Glyph( glyphs[idx] );
+ * }
*/
FT_EXPORT( FT_Error )
FT_Glyph_To_Bitmap( FT_Glyph* the_glyph,
diff --git a/include/freetype/ftincrem.h b/include/freetype/ftincrem.h
index 08bba73..b3a17c3 100644
--- a/include/freetype/ftincrem.h
+++ b/include/freetype/ftincrem.h
@@ -286,30 +286,30 @@ FT_BEGIN_HEADER
* wants to support incremental glyph loading. You should use it with
* @FT_PARAM_TAG_INCREMENTAL as in the following example:
*
- * {
- * FT_Incremental_InterfaceRec inc_int;
- * FT_Parameter parameter;
- * FT_Open_Args open_args;
- *
- *
- * // set up incremental descriptor
- * inc_int.funcs = my_funcs;
- * inc_int.object = my_object;
- *
- * // set up optional parameter
- * parameter.tag = FT_PARAM_TAG_INCREMENTAL;
- * parameter.data = &inc_int;
- *
- * // set up FT_Open_Args structure
- * open_args.flags = FT_OPEN_PATHNAME | FT_OPEN_PARAMS;
- * open_args.pathname = my_font_pathname;
- * open_args.num_params = 1;
- * open_args.params = ¶meter; // we use one optional argument
- *
- * // open the font
- * error = FT_Open_Face( library, &open_args, index, &face );
- * ...
- * }
+ * {
+ * FT_Incremental_InterfaceRec inc_int;
+ * FT_Parameter parameter;
+ * FT_Open_Args open_args;
+ *
+ *
+ * // set up incremental descriptor
+ * inc_int.funcs = my_funcs;
+ * inc_int.object = my_object;
+ *
+ * // set up optional parameter
+ * parameter.tag = FT_PARAM_TAG_INCREMENTAL;
+ * parameter.data = &inc_int;
+ *
+ * // set up FT_Open_Args structure
+ * open_args.flags = FT_OPEN_PATHNAME | FT_OPEN_PARAMS;
+ * open_args.pathname = my_font_pathname;
+ * open_args.num_params = 1;
+ * open_args.params = ¶meter; // we use one optional argument
+ *
+ * // open the font
+ * error = FT_Open_Face( library, &open_args, index, &face );
+ * ...
+ * }
*
*/
typedef struct FT_Incremental_InterfaceRec_
diff --git a/include/freetype/ftmoderr.h b/include/freetype/ftmoderr.h
index 1f71633..661b0da 100644
--- a/include/freetype/ftmoderr.h
+++ b/include/freetype/ftmoderr.h
@@ -73,20 +73,20 @@
* It can also be used to create a module error message table easily
* with something like
*
+ * {
+ * #undef FTMODERR_H_
+ * #define FT_MODERRDEF( e, v, s ) { FT_Mod_Err_ ## e, s },
+ * #define FT_MODERR_START_LIST {
+ * #define FT_MODERR_END_LIST { 0, 0 } };
+ *
+ * const struct
* {
- * #undef FTMODERR_H_
- * #define FT_MODERRDEF( e, v, s ) { FT_Mod_Err_ ## e, s },
- * #define FT_MODERR_START_LIST {
- * #define FT_MODERR_END_LIST { 0, 0 } };
- *
- * const struct
- * {
- * int mod_err_offset;
- * const char* mod_err_msg
- * } ft_mod_errors[] =
- *
- * #include FT_MODULE_ERRORS_H
- * }
+ * int mod_err_offset;
+ * const char* mod_err_msg
+ * } ft_mod_errors[] =
+ *
+ * #include FT_MODULE_ERRORS_H
+ * }
*
*/
diff --git a/include/freetype/fttypes.h b/include/freetype/fttypes.h
index de69e3b..9da08a0 100644
--- a/include/freetype/fttypes.h
+++ b/include/freetype/fttypes.h
@@ -370,10 +370,10 @@ FT_BEGIN_HEADER
* A simple structure used to store a 2x2 matrix. Coefficients are
* in 16.16 fixed-point format. The computation performed is:
*
- * {
- * x' = x*xx + y*xy
- * y' = x*yx + y*yy
- * }
+ * {
+ * x' = x*xx + y*xy
+ * y' = x*yx + y*yy
+ * }
*
* @fields:
* xx ::
diff --git a/include/freetype/tttables.h b/include/freetype/tttables.h
index c23d3c6..8ecc8e2 100644
--- a/include/freetype/tttables.h
+++ b/include/freetype/tttables.h
@@ -779,19 +779,19 @@ FT_BEGIN_HEADER
* If you need to determine the table's length you should first call this
* function with `*length' set to~0, as in the following example:
*
- * {
- * FT_ULong length = 0;
+ * {
+ * FT_ULong length = 0;
*
*
- * error = FT_Load_Sfnt_Table( face, tag, 0, NULL, &length );
- * if ( error ) { ... table does not exist ... }
+ * error = FT_Load_Sfnt_Table( face, tag, 0, NULL, &length );
+ * if ( error ) { ... table does not exist ... }
*
- * buffer = malloc( length );
- * if ( buffer == NULL ) { ... not enough memory ... }
+ * buffer = malloc( length );
+ * if ( buffer == NULL ) { ... not enough memory ... }
*
- * error = FT_Load_Sfnt_Table( face, tag, 0, buffer, &length );
- * if ( error ) { ... could not load table ... }
- * }
+ * error = FT_Load_Sfnt_Table( face, tag, 0, buffer, &length );
+ * if ( error ) { ... could not load table ... }
+ * }
*
* Note that structures like @TT_Header or @TT_OS2 can't be used with
* this function; they are limited to @FT_Get_Sfnt_Table. Reason is that