Document text category

2 files changed, 5 insertions, 5 deletions

diff --git a/src/font/mod.rs b/src/font/mod.rs
index 13189b6d..0422f3b9 100644
--- a/src/font/mod.rs
+++ b/src/font/mod.rs
@@ -254,7 +254,7 @@ pub struct LineMetrics {
 /// Identifies a vertical metric of a font.
 #[derive(Debug, Copy, Clone, Eq, PartialEq, Hash)]
 pub enum VerticalFontMetric {
-    /// The distance from the baseline to the typographic ascender.
+    /// The typographic ascender.
     ///
     /// Corresponds to the typographic ascender from the `OS/2` table if present
     /// and falls back to the ascender from the `hhea` table otherwise.
@@ -265,7 +265,7 @@ pub enum VerticalFontMetric {
     XHeight,
     /// The baseline on which the letters rest.
     Baseline,
-    /// The distance from the baseline to the typographic descender.
+    /// The typographic descender.
     ///
     /// Corresponds to the typographic descender from the `OS/2` table if
     /// present and falls back to the descender from the `hhea` table otherwise.
diff --git a/src/font/variant.rs b/src/font/variant.rs
index 085f2ae7..aa9ff141 100644
--- a/src/font/variant.rs
+++ b/src/font/variant.rs
@@ -32,11 +32,11 @@ impl Debug for FontVariant {
 #[derive(Serialize, Deserialize)]
 #[serde(rename_all = "kebab-case")]
 pub enum FontStyle {
-    /// The default style.
+    /// The default, typically upright style.
     Normal,
-    /// A cursive style.
+    /// A cursive style with custom letterform.
     Italic,
-    /// A slanted style.
+    /// Just a slanted version of the normal style.
     Oblique,
 }