rust: Fix `cargo doc` warnings.
authorBen Pfaff <blp@cs.stanford.edu>
Fri, 11 Jul 2025 23:53:49 +0000 (16:53 -0700)
committerBen Pfaff <blp@cs.stanford.edu>
Fri, 11 Jul 2025 23:53:58 +0000 (16:53 -0700)
rust/pspp/src/format/display/mod.rs
rust/pspp/src/lex/token.rs
rust/pspp/src/output/cairo/fsm.rs
rust/pspp/src/output/pivot/mod.rs
rust/pspp/src/output/render.rs

index 4b5e2fbb4c3d89ce7d1848898da13441522996c2..92e628998faa9e3c8f1c52796e0c5808715a843d 100644 (file)
@@ -674,7 +674,7 @@ impl<'a, 'b> DisplayDatum<'a, 'b> {
     /// [Type::PIB], and so on) as binary values, and writes other output
     /// formats in the given `encoding`.
     ///
-    /// If `dv` is a [DisplayValue], the difference between `write!(f, "{}",
+    /// If `dv` is a [DisplayDatum], the difference between `write!(f, "{}",
     /// dv)` and `dv.write(f, encoding)` is:
     ///
     /// * `write!` always outputs UTF-8. Binary formats are encoded as the
index 3eb1f99df690b35a02c7072bb1ce95ecf3b08379..66547c83e249eee417928e259ac17692919f01ea 100644 (file)
@@ -257,7 +257,7 @@ pub enum Punct {
     /// `?` (only appears in macros).
     Question,
 
-    /// ```` (only appears in macros).
+    /// <code>`</code> (only appears in macros).
     Backtick,
 
     /// `.`.
index 2c369674122ee24ae961c0da072c00271b6032b8..ccf4d21f1cc1f82f91e2235547953cdb69004dd6 100644 (file)
@@ -67,8 +67,8 @@ pub struct CairoFsmStyle {
     /// Resolution, in units per inch, used for measuring font "points":
     ///
     /// - 72.0 if 1 pt is one device unit, e.g. for rendering to a surface
-    ///   created by [PsSurface::new] with its default transformation matrix of 72
-    ///   units/inch.p
+    ///   created by [cairo::PsSurface::new] with its default transformation
+    ///   matrix of 72 units/inch.p
     ///
     /// - 96.0 is traditional for a screen-based surface.
     pub font_resolution: f64,
index 70f83b28d4ef34984e4da21f587c989851bebd69..6c34441add64bfbbf938bd9dbc3c05e75fbe4ef4 100644 (file)
@@ -643,9 +643,9 @@ impl From<&str> for Category {
 
 /// Styling for a pivot table.
 ///
-/// The division between this and the style information in [Table] seems fairly
-/// arbitrary.  The ultimate reason for the division is simply because that's
-/// how SPSS documentation and file formats do it.
+/// The division between this and the style information in [PivotTable] seems
+/// fairly arbitrary.  The ultimate reason for the division is simply because
+/// that's how SPSS documentation and file formats do it.
 #[derive(Clone, Debug)]
 pub struct Look {
     pub name: Option<String>,
@@ -1766,8 +1766,8 @@ impl Display for Display26Adic {
 ///    category while creating the category.  See pivot_dimension_create() for
 ///    more details.
 ///
-///    [F]: crate::format::Format::F
-///    [Pct]: crate::format::Format::Pct
+///    [F]: crate::format::Type::F
+///    [Pct]: crate::format::Type::Pct
 ///
 /// 2. A numeric or string value obtained from data ([ValueInner::Number] or
 ///    [ValueInner::String]).  If such a value corresponds to a variable, then the
index 4a9bd56996d34f9ad956e22b6cbbc4f29663ff40..075a1fa69f52bd62e64d9c0f5facc54c6f75e32f 100644 (file)
@@ -79,10 +79,10 @@ pub struct Params {
     /// on-screen display).
     pub printing: bool,
 
-    /// Whether [RenderOps::adjust_break] is implemented.
+    /// Whether [Device::adjust_break] is implemented.
     pub can_adjust_break: bool,
 
-    /// Whether [RenderOps::scale] is implemented.
+    /// Whether [Device::scale] is implemented.
     pub can_scale: bool,
 }
 
@@ -123,8 +123,8 @@ pub trait Device {
     /// return value would be just sufficiently less that the breakpoint would
     /// be between lines of text.
     ///
-    /// Optional.  If [RenderParams::can_adjust_break] is false, the rendering
-    /// engine assumes that all breakpoints are acceptable.
+    /// Optional.  If [Params::can_adjust_break] is false, the rendering engine
+    /// assumes that all breakpoints are acceptable.
     fn adjust_break(&self, cell: &Content, size: Coord2) -> usize;
 
     /// Draws a generalized intersection of lines in `bb`.
@@ -162,8 +162,8 @@ pub trait Device {
     /// everything subsequent to be drawn half-size.  `factor` will be greater
     /// than 0 and less than or equal to 1.
     ///
-    /// Optional.  If [RenderParams::can_scale] is false, the rendering engine
-    /// won't try to scale output.
+    /// Optional.  If [Params::can_scale] is false, the rendering engine won't
+    /// try to scale output.
     fn scale(&mut self, factor: f64);
 }