Commit 9d3de385a6ac989223d3c179fd5c78b88a3783b7
2005-10-26T20:08:45
Fix comment style.
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
diff --git a/include/freetype/ftstroke.h b/include/freetype/ftstroke.h
index c6c96de..f4c14bd 100644
--- a/include/freetype/ftstroke.h
+++ b/include/freetype/ftstroke.h
@@ -4,7 +4,7 @@
/* */
/* FreeType path stroker (specification). */
/* */
-/* Copyright 2002, 2003, 2004 by */
+/* Copyright 2002, 2003, 2004, 2005 by */
/* David Turner, Robert Wilhelm, and Werner Lemberg. */
/* */
/* This file is part of the FreeType project, and may only be used, */
@@ -29,16 +29,16 @@ FT_BEGIN_HEADER
/************************************************************************
*
- * <Section>
+ * @section:
* glyph_stroker
*
- * <Title>
+ * @title:
* Glyph Stroker
*
- * <Abstract>
+ * @abstract:
* Generating bordered and stroked glyphs.
*
- * <Description>
+ * @description:
* This component generates stroked outlines of a given vectorial
* glyph. It also allows you to retrieve the `outside' and/or the
* `inside' borders of the stroke.
diff --git a/include/freetype/tttables.h b/include/freetype/tttables.h
index 051c1ea..0a5f302 100644
--- a/include/freetype/tttables.h
+++ b/include/freetype/tttables.h
@@ -5,7 +5,7 @@
/* Basic SFNT/TrueType tables definitions and interface */
/* (specification only). */
/* */
-/* Copyright 1996-2001, 2002, 2003, 2004 by */
+/* Copyright 1996-2001, 2002, 2003, 2004, 2005 by */
/* David Turner, Robert Wilhelm, and Werner Lemberg. */
/* */
/* This file is part of the FreeType project, and may only be used, */
@@ -604,56 +604,61 @@ FT_BEGIN_HEADER
/**************************************************************************
*
- * <Function>
- * FT_Load_Sfnt_Table
+ * @function:
+ * FT_Load_Sfnt_Table
*
- * <Description>
+ * @description:
* Loads any font table into client memory.
*
- * <Input>
- * face :: A handle to the source face.
+ * @input:
+ * face ::
+ * A handle to the source face.
*
- * tag :: The 4-byte tag of the table to load. Use the value 0 if
- * you want to access the whole font file. Otherwise, you can
- * use one of the definitions found in the @FT_TRUETYPE_TAGS_H
- * file, or forge a new one with @FT_MAKE_TAG.
+ * tag ::
+ * The 4-byte tag of the table to load. Use the value 0 if you want to
+ * access the whole font file. Otherwise, you can use one of the
+ * definitions found in the @FT_TRUETYPE_TAGS_H file, or forge a new
+ * one with @FT_MAKE_TAG.
*
- * offset :: The starting offset in the table (or file if tag == 0).
+ * offset ::
+ * The starting offset in the table (or file if tag == 0).
*
- * <Output>
- * buffer :: The target buffer address. The client must ensure that
- * the memory array is big enough to hold the data.
+ * @output:
+ * buffer ::
+ * The target buffer address. The client must ensure that the memory
+ * array is big enough to hold the data.
*
- * <InOut>
- * length :: If the `length' parameter is NULL, then try to load the whole
- * table. Return an error code if it fails.
+ * @inout:
+ * length ::
+ * If the `length' parameter is NULL, then try to load the whole table.
+ * Return an error code if it fails.
*
- * Else, if `*length' is 0, exit immediately while returning
- * the table's (or file) full size in it.
+ * Else, if `*length' is 0, exit immediately while returning the
+ * table's (or file) full size in it.
*
- * Else the number of bytes to read from the table or file,
- * from the starting offset.
+ * Else the number of bytes to read from the table or file, from the
+ * starting offset.
*
- * <Return>
+ * @return:
* FreeType error code. 0 means success.
*
- * <Note>
+ * @note:
* 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 ... }
+ * }
*/
FT_EXPORT( FT_Error )
FT_Load_Sfnt_Table( FT_Face face,
@@ -665,13 +670,13 @@ FT_BEGIN_HEADER
/**************************************************************************
*
- * <Function>
- * FT_Sfnt_Table_Info
+ * @function:
+ * FT_Sfnt_Table_Info
*
- * <Description>
+ * @description:
* Returns information on an SFNT table.
*
- * <Input>
+ * @input:
* face ::
* A handle to the source face.
*
@@ -679,17 +684,17 @@ FT_BEGIN_HEADER
* The index of an SFNT table. The function returns
* FT_Err_Table_Missing for an invalid value.
*
- * <Output>
+ * @output:
* tag ::
* The name tag of the SFNT table.
*
* length ::
* The length of the SFNT table.
*
- * <Return>
+ * @return:
* FreeType error code. 0 means success.
*
- * <Note>
+ * @note:
* SFNT tables with length zero are treated as missing by Windows.
*
*/