Tweak comments and docs

pin-project-internal/Cargo.toml

@@ -10,7 +10,7 @@ documentation = "https://docs.rs/pin-project-internal"
 keywords = ["pin", "macros", "attribute"]
 categories = ["no-std", "rust-patterns"]
 description = """
-An internal crate to support pin_project - do not use directly
+Implementation detail of the `pin-project` crate.
 """
 
 [package.metadata.docs.rs]

pin-project-internal/src/lib.rs

@@ -1,4 +1,4 @@
-//! An internal crate to support pin_project - **do not use directly**
+//! Implementation detail of the `pin-project` crate. - **do not use directly**
 
 #![doc(html_root_url = "https://docs.rs/pin-project-internal/1.0.0-alpha.1")]
 #![doc(test(
@@ -566,7 +566,7 @@ pub fn pinned_drop(args: TokenStream, input: TokenStream) -> TokenStream {
     pinned_drop::attribute(&args.into(), input).into()
 }
 
-// An internal helper macro. Not public API.
+// Not public API.
 #[doc(hidden)]
 #[proc_macro_derive(__PinProjectInternalDerive, attributes(pin))]
 pub fn __pin_project_internal_derive(input: TokenStream) -> TokenStream {

tests/drop_order.rs

@@ -1,5 +1,7 @@
 #![warn(rust_2018_idioms, single_use_lifetimes)]
 
+// Refs: https://doc.rust-lang.org/reference/destructors.html
+
 use pin_project::pin_project;
 use std::{cell::Cell, pin::Pin, thread};
 
@@ -34,7 +36,7 @@ struct TuplePinned<'a>(#[pin] D<'a>, #[pin] D<'a>);
 #[pin_project(project_replace)]
 struct TupleUnpinned<'a>(D<'a>, D<'a>);
 
-#[pin_project(project_replace= EnumProj)]
+#[pin_project(project_replace = EnumProj)]
 enum Enum<'a> {
     StructPinned {
         #[pin]