Fix doc comments in librustc/hir/lowering.rs

src/librustc/hir/lowering.rs

@@ -74,7 +74,7 @@ const HIR_ID_COUNTER_LOCKED: u32 = 0xFFFFFFFF;
 pub struct LoweringContext<'a> {
  crate_root: Option<&'static str>,
 
- // Used to assign ids to HIR nodes that do not directly correspond to an AST node.
+ /// Used to assign ids to HIR nodes that do not directly correspond to an AST node.
  sess: &'a Session,
 
  cstore: &'a dyn CrateStore,
@@ -107,25 +107,25 @@ pub struct LoweringContext<'a> {
  /// written at all (e.g., `&T` or `std::cell::Ref<T>`).
  anonymous_lifetime_mode: AnonymousLifetimeMode,
 
- // Used to create lifetime definitions from in-band lifetime usages.
- // e.g., `fn foo(x: &'x u8) -> &'x u8` to `fn foo<'x>(x: &'x u8) -> &'x u8`
- // When a named lifetime is encountered in a function or impl header and
- // has not been defined
- // (i.e., it doesn't appear in the in_scope_lifetimes list), it is added
- // to this list. The results of this list are then added to the list of
- // lifetime definitions in the corresponding impl or function generics.
+ /// Used to create lifetime definitions from in-band lifetime usages.
+ /// e.g., `fn foo(x: &'x u8) -> &'x u8` to `fn foo<'x>(x: &'x u8) -> &'x u8`
+ /// When a named lifetime is encountered in a function or impl header and
+ /// has not been defined
+ /// (i.e., it doesn't appear in the in_scope_lifetimes list), it is added
+ /// to this list. The results of this list are then added to the list of
+ /// lifetime definitions in the corresponding impl or function generics.
  lifetimes_to_define: Vec<(Span, ParamName)>,
 
- // Whether or not in-band lifetimes are being collected. This is used to
- // indicate whether or not we're in a place where new lifetimes will result
- // in in-band lifetime definitions, such a function or an impl header,
- // including implicit lifetimes from `impl_header_lifetime_elision`.
+ /// Whether or not in-band lifetimes are being collected. This is used to
+ /// indicate whether or not we're in a place where new lifetimes will result
+ /// in in-band lifetime definitions, such a function or an impl header,
+ /// including implicit lifetimes from `impl_header_lifetime_elision`.
  is_collecting_in_band_lifetimes: bool,
 
- // Currently in-scope lifetimes defined in impl headers, fn headers, or HRTB.
- // When `is_collectin_in_band_lifetimes` is true, each lifetime is checked
- // against this list to see if it is already in-scope, or if a definition
- // needs to be created for it.
+ /// Currently in-scope lifetimes defined in impl headers, fn headers, or HRTB.
+ /// When `is_collectin_in_band_lifetimes` is true, each lifetime is checked
+ /// against this list to see if it is already in-scope, or if a definition
+ /// needs to be created for it.
  in_scope_lifetimes: Vec<Ident>,
 
  current_module: NodeId,