Minor syntax and formatting update to doc comment

The comment is on find_vtable_types_for_unsizing, but there is another
unrelated typo fix as well.
This commit is contained in:
Eric Holk 2022-08-17 13:07:17 -07:00
parent 9c20b2a8cc
commit 8b7b1f773a
1 changed files with 8 additions and 4 deletions

View File

@ -128,7 +128,7 @@
//! #### Unsizing Casts //! #### Unsizing Casts
//! A subtle way of introducing neighbor edges is by casting to a trait object. //! A subtle way of introducing neighbor edges is by casting to a trait object.
//! Since the resulting fat-pointer contains a reference to a vtable, we need to //! Since the resulting fat-pointer contains a reference to a vtable, we need to
//! instantiate all object-save methods of the trait, as we need to store //! instantiate all object-safe methods of the trait, as we need to store
//! pointers to these functions even if they never get called anywhere. This can //! pointers to these functions even if they never get called anywhere. This can
//! be seen as a special case of taking a function reference. //! be seen as a special case of taking a function reference.
//! //!
@ -1044,10 +1044,12 @@ fn should_codegen_locally<'tcx>(tcx: TyCtxt<'tcx>, instance: &Instance<'tcx>) ->
/// them. /// them.
/// ///
/// For example, the source type might be `&SomeStruct` and the target type /// For example, the source type might be `&SomeStruct` and the target type
/// might be `&SomeTrait` in a cast like: /// might be `&dyn SomeTrait` in a cast like:
/// ///
/// ```rust,ignore (not real code)
/// let src: &SomeStruct = ...; /// let src: &SomeStruct = ...;
/// let target = src as &SomeTrait; /// let target = src as &dyn SomeTrait;
/// ```
/// ///
/// Then the output of this function would be (SomeStruct, SomeTrait) since for /// Then the output of this function would be (SomeStruct, SomeTrait) since for
/// constructing the `target` fat-pointer we need the vtable for that pair. /// constructing the `target` fat-pointer we need the vtable for that pair.
@ -1068,8 +1070,10 @@ fn should_codegen_locally<'tcx>(tcx: TyCtxt<'tcx>, instance: &Instance<'tcx>) ->
/// for the pair of `T` (which is a trait) and the concrete type that `T` was /// for the pair of `T` (which is a trait) and the concrete type that `T` was
/// originally coerced from: /// originally coerced from:
/// ///
/// ```rust,ignore (not real code)
/// let src: &ComplexStruct<SomeStruct> = ...; /// let src: &ComplexStruct<SomeStruct> = ...;
/// let target = src as &ComplexStruct<SomeTrait>; /// let target = src as &ComplexStruct<dyn SomeTrait>;
/// ```
/// ///
/// Again, we want this `find_vtable_types_for_unsizing()` to provide the pair /// Again, we want this `find_vtable_types_for_unsizing()` to provide the pair
/// `(SomeStruct, SomeTrait)`. /// `(SomeStruct, SomeTrait)`.