applied suggestions

Author: oriongonza

compiler/rustc_parse/src/parser/diagnostics.rs

@@ -2954,10 +2954,12 @@ impl<'a> Parser<'a> {
         err
     }
 
-    /// This checks if this is a git diff marker, one of
-    /// >>>>>
-    /// =====
-    /// <<<<<
+    /// This checks if this is a git diff marker, depending of the parameter passed.
+    ///
+    /// * `>>>>>`
+    /// * `=====`
+    /// * `<<<<<`
+    ///
     pub fn is_git_diff_marker(&mut self, long_kind: &TokenKind, short_kind: &TokenKind) -> bool {
         (0..3).all(|i| self.look_ahead(i, |tok| tok == long_kind))
             && self.look_ahead(3, |tok| tok == short_kind)

compiler/rustc_parse/src/parser/item.rs

@@ -1690,8 +1690,9 @@ impl<'a> Parser<'a> {
     }
 
     /// This function parses the fields of record structs:
-    ///   - struct S { ... }
-    ///   - enum E { variant { ... } }
+    ///
+    ///   - `struct S { ... }`
+    ///   - `enum E { Variant { ... } }`
     pub(crate) fn parse_record_struct_body(
         &mut self,
         adt_ty: &str,