[Docs] Address review comments

This commit is contained in:
Khaled Hosny 2020-09-26 10:22:39 +02:00
parent 41b46a3cb2
commit cc7b3a1abd
3 changed files with 11 additions and 7 deletions

View File

@ -102,9 +102,10 @@ DEFINE_NULL_INSTANCE (hb_face_t) =
* @user_data: A pointer to the user data * @user_data: A pointer to the user data
* @destroy: (optional): A callback to call when @data is not needed anymore * @destroy: (optional): A callback to call when @data is not needed anymore
* *
* Variant of hb_face_create(), built for those cases where * Variant of hb_face_create(), built for those cases where it is more
* client programs are primarily concerned with querying the * convenient to provide data for individual tables instead of the whole font
* font tables, rather than with full shaping. * data. With the caveat that hb_face_get_table_tags() does not currently work
* with faces created this way.
* *
* Creates a new face object from the specified @user_data and @reference_table_func, * Creates a new face object from the specified @user_data and @reference_table_func,
* with the @destroy callback. * with the @destroy callback.
@ -397,8 +398,8 @@ hb_face_reference_table (const hb_face_t *face,
* @face: A face object * @face: A face object
* *
* Fetches a pointer to the binary blob that contains the * Fetches a pointer to the binary blob that contains the
* specified face. Can only be used on faces created with * specified face. Returns an empty blob if referencing face data is not
* hb_face_builder_create(). * possible.
* *
* Return value: (transfer full): A pointer to the blob for @face * Return value: (transfer full): A pointer to the blob for @face
* *

View File

@ -48,8 +48,6 @@ hb_face_count (hb_blob_t *blob);
/** /**
* hb_face_t: * hb_face_t:
* @blob: A pointer to the #hb_blob_t that contains the binary blob of a font file
* @index: The index (zero-based) into the font file that points to the face
* *
* Data type for holding font faces. * Data type for holding font faces.
* *

View File

@ -139,9 +139,14 @@ hb_unicode_decompose_compatibility_nil (hb_unicode_funcs_t *ufuncs HB_UNUSED
#endif #endif
/** /**
* hb_unicode_funcs_get_default:
* *
* Fetches a pointer to the default Unicode-functions structure that is used
* when no functions are explicitly set on #hb_buffer_t.
* *
* Return value: (transfer none): a pointer to the #hb_unicode_funcs_t Unicode-functions structure
* *
* Since: 0.9.2
**/ **/
hb_unicode_funcs_t * hb_unicode_funcs_t *
hb_unicode_funcs_get_default () hb_unicode_funcs_get_default ()