Merge pull request #802 from andyleiserson/block2

block2: Fix typos and other minor issues in comments

Author: madsmtm

crates/block2/src/encoding.rs

@@ -12,6 +12,10 @@ use objc2::encode::{EncodeArguments, EncodeReturn, Encoding};
 /// still serve as a good way to obtain what to fill in the encoding string
 /// when implementing [`crate::ManualBlockEncoding`].
 ///
+/// See
+/// [`crate::ManualBlockEncoding`](crate::ManualBlockEncoding#encoding-string-generation)
+/// for an overview of the encoding string construction.
+///
 /// # Example
 ///
 /// ```ignore

crates/block2/src/global.rs

@@ -132,7 +132,7 @@ impl<F: ?Sized> fmt::Debug for GlobalBlock<F> {
 /// assert_eq!(ADDER_BLOCK.call((5, 7)), 12);
 /// ```
 ///
-/// The following does not compile because [`Box`] is not [`EncodeReturn`]:
+/// The following does not compile because [`Box`] is not [`EncodeArgument`]:
 ///
 /// ```compile_fail,E0277
 /// use block2::global_block;

crates/block2/src/lib.rs

@@ -218,7 +218,7 @@
 //! }
 //! ```
 //!
-//! This can similarly be done for Objcective-C methods declared with
+//! This can similarly be done for Objective-C methods declared with
 //! [`objc2::extern_methods!`] (though most of the time, the [framework
 //! crates][framework-crates] will take care of that for you).
 //!

crates/block2/src/stack.rs

@@ -351,7 +351,7 @@ impl<'f, A, R, Closure> StackBlock<'f, A, R, Closure> {
         } else {
             BlockFlags::EMPTY
         };
-        // See discussion in `new` above with regards to the safety of the
+        // See discussion in `maybe_encoded` above with regards to the safety of the
         // pointer to the descriptor.
         let descriptor = match (mem::needs_drop::<Self>(), E::IS_NONE) {
             (true, true) => {