[naga] Various doc fixes.

Author: jimblandy

naga/src/front/wgsl/lower/conversion.rs

@@ -71,7 +71,7 @@ impl<'source> super::ExpressionContext<'source, '_, '_> {
         self.convert_leaf_scalar(expr, expr_span, goal_scalar)
     }
 
-    /// Try to convert `expr`'s leaf scalar to `goal` using automatic conversions.
+    /// Try to convert `expr`'s leaf scalar to `goal_scalar` using automatic conversions.
     ///
     /// If no conversions are necessary, return `expr` unchanged.
     ///

naga/src/proc/type_methods.rs

@@ -102,6 +102,12 @@ impl crate::TypeInner {
     ///
     /// If `inner` is a scalar, vector, or matrix type, return
     /// its scalar type. Otherwise, return `None`.
+    ///
+    /// Note that this doesn't inspect [`Array`] types, as required
+    /// for automatic conversions. For that, see [`scalar_for_conversions`].
+    ///
+    /// [`Array`]: crate::TypeInner::Array
+    /// [`scalar_for_conversions`]: crate::TypeInner::scalar_for_conversions
     pub const fn scalar(&self) -> Option<crate::Scalar> {
         use crate::TypeInner as Ti;
         match *self {