Documentation fixes

3 files changed, 9 insertions, 16 deletions

diff --git a/library/src/meta/figure.rs b/library/src/meta/figure.rs
index bfbfeb83..548233c4 100644
--- a/library/src/meta/figure.rs
+++ b/library/src/meta/figure.rs
@@ -331,11 +331,8 @@ impl FigureElem {
             .cloned()
     }
 
-    /// Builds the supplement and numbering of the figure.
-    /// If there is no numbering, returns [`None`].
-    ///
-    /// # Errors
-    /// If a numbering is specified but the [`Self::data()`] is `None`.
+    /// Builds the supplement and numbering of the figure. Returns [`None`] if
+    /// there is no numbering.
     pub fn show_supplement_and_numbering(
         &self,
         vt: &mut Vt,
@@ -364,11 +361,8 @@ impl FigureElem {
         }
     }
 
-    /// Builds the caption for the figure.
-    /// If there is a numbering, will also try to show the supplement and the numbering.
-    ///
-    /// # Errors
-    /// If a numbering is specified but the [`Self::element`] is `None`.
+    /// Builds the caption for the figure. If there is a numbering, will also
+    /// try to show the supplement and the numbering.
     pub fn show_caption(&self, vt: &mut Vt) -> SourceResult<Content> {
         let Some(mut caption) = self.caption(StyleChain::default()) else {
             return Ok(Content::empty());
diff --git a/library/src/meta/reference.rs b/library/src/meta/reference.rs
index ceb1a3b2..e4b6bbec 100644
--- a/library/src/meta/reference.rs
+++ b/library/src/meta/reference.rs
@@ -245,10 +245,9 @@ cast_to_value! {
     }
 }
 
-/// Marks an element as being able to be referenced.
-/// This is used to implement the `@ref` macro.
-/// It is expected to build the [`Content`] that gets linked
-/// by the [`RefElement`].
+/// Marks an element as being able to be referenced. This is used to implement
+/// the `@ref` element. It is expected to build the [`Content`] that gets linked
+/// by the [`RefElem`].
 pub trait Refable {
     /// Tries to build a reference content for this element.
     ///
diff --git a/library/src/text/shaping.rs b/library/src/text/shaping.rs
index e670d0d1..b0be8bf6 100644
--- a/library/src/text/shaping.rs
+++ b/library/src/text/shaping.rs
@@ -90,7 +90,7 @@ impl ShapedGlyph {
         matches!(self.c.script(), Hiragana | Katakana | Han) || self.c == '\u{30FC}'
     }
 
-    /// See https://www.w3.org/TR/clreq/#punctuation_width_adjustment
+    /// See <https://www.w3.org/TR/clreq/#punctuation_width_adjustment>
     pub fn is_cjk_left_aligned_punctuation(&self) -> bool {
         // CJK quotation marks shares codepoints with latin quotation marks.
         // But only the CJK ones have full width.
@@ -101,7 +101,7 @@ impl ShapedGlyph {
         matches!(self.c, '，' | '。' | '、' | '：' | '；' | '》' | '）' | '』' | '」')
     }
 
-    /// See https://www.w3.org/TR/clreq/#punctuation_width_adjustment
+    /// See <https://www.w3.org/TR/clreq/#punctuation_width_adjustment>
     pub fn is_cjk_right_aligned_punctuation(&self) -> bool {
         // CJK quotation marks shares codepoints with latin quotation marks.
         // But only the CJK ones have full width.