[style] Fix documentation
Message documentation a bit to get it working.
diff --git a/docs/harfbuzz-docs.xml b/docs/harfbuzz-docs.xml
index 83d3c30..c2b2323 100644
--- a/docs/harfbuzz-docs.xml
+++ b/docs/harfbuzz-docs.xml
@@ -97,6 +97,11 @@
<xi:include href="xml/hb-directwrite.xml"/>
</chapter>
+ <chapter id="style-api">
+ <title>Style API</title>
+ <xi:include href="xml/hb-style.xml"/>
+ </chapter>
+
<chapter id="subset-api">
<title>Subset API</title>
<xi:include href="xml/hb-subset.xml"/>
diff --git a/docs/harfbuzz-sections.txt b/docs/harfbuzz-sections.txt
index ace2c37..8160cf6 100644
--- a/docs/harfbuzz-sections.txt
+++ b/docs/harfbuzz-sections.txt
@@ -708,6 +708,12 @@
</SECTION>
<SECTION>
+<FILE>hb-style</FILE>
+hb_style_tag_t
+hb_style_get_value
+</SECTION>
+
+<SECTION>
<FILE>hb-subset</FILE>
hb_subset_flags_t
hb_subset_input_t
diff --git a/src/hb-style.cc b/src/hb-style.cc
index 26042ae..b6f31b5 100644
--- a/src/hb-style.cc
+++ b/src/hb-style.cc
@@ -34,6 +34,15 @@
#include "hb-ot-post-table.hh"
#include "hb-ot-face.hh"
+/**
+ * SECTION:hb-style
+ * @title: hb-style
+ * @short_description: Font Styles
+ * @include: hb.h
+ *
+ * Functions for fetching style information from fonts.
+ **/
+
static inline float
_hb_angle_to_ratio (float a)
{
@@ -52,7 +61,7 @@
* @font: a #hb_font_t object.
* @style_tag: a style tag.
*
- * Searches variation axes of a hb_font_t object for a specific axis first,
+ * Searches variation axes of a #hb_font_t object for a specific axis first,
* if not set, then tries to get default style values from different
* tables of the font.
*
diff --git a/src/hb-style.h b/src/hb-style.h
index 01e0218..54a3b59 100644
--- a/src/hb-style.h
+++ b/src/hb-style.h
@@ -44,6 +44,7 @@
* must be greater than -90 and less than +90. Values can be interpreted as
* the angle, in counter-clockwise degrees, of oblique slant from whatever the
* designer considers to be upright for that font design.
+ * @HB_STYLE_TAG_SLANT_RATIO: same as @HB_STYLE_TAG_SLANT_ANGLE expression as ratio.
* @HB_STYLE_TAG_WIDTH: Used to vary width of text from narrower to wider.
* Non-zero. Values can be interpreted as a percentage of whatever the font
* designer considers “normal width” for that font design.
@@ -52,7 +53,7 @@
* comparison to values for usWeightClass in the OS/2 table,
* or the CSS font-weight property.
*
- * Defined by https://docs.microsoft.com/en-us/typography/opentype/spec/dvaraxisreg
+ * Defined by [OpenType Design-Variation Axis Tag Registry](https://docs.microsoft.com/en-us/typography/opentype/spec/dvaraxisreg).
*
* Since: REPLACEME
**/
