src/scanner/mod.rs

@@ -924,7 +924,7 @@ impl Scanner
     }
 
     /// Chomp whitespace and optionally comments until we
-    /// reach the next token, updating buffer[0] to the
+    /// reach the next token, updating .buffer to the
     /// beginning of the new token
     fn eat_whitespace(&mut self, opts: Flags, buffer: &mut &str, comments: bool) -> Result<usize>
     {

src/scanner/tag.rs

@@ -430,8 +430,7 @@ where
     }
 }
 
-/// Helper function for constructing
+/// Helper function for constructing [Token::Tag](Token)s
-/// [Ref][Ref]<[Token::Tag][Token]>s
 fn assemble_tag<'de>(handle: &'de str, suffix: Slice<'de>, can_borrow: bool) -> Token<'de>
 {
     if can_borrow

src/token.rs

@@ -11,9 +11,9 @@ pub type Slice<'a> = std::borrow::Cow<'a, str>;
 pub enum Token<'a>
 {
     /// The stream's start, with the byte (encoding)
-    /// [virtual]
+    /// {virtual}
     StreamStart(StreamEncoding),
-    /// The stream's end [virtual]
+    /// The stream's end {virtual}
     StreamEnd,
     /// The %YAML directive, (major,minor)
     VersionDirective(u8, u8),
@@ -99,9 +99,9 @@ impl<'a> Token<'a>
 pub enum Marker
 {
     /// The stream's start, with the byte (encoding)
-    /// [virtual]
+    /// {virtual}
     StreamStart,
-    /// The stream's end [virtual]
+    /// The stream's end {virtual}
     StreamEnd,
     /// The %YAML directive, (major,minor)
     VersionDirective,