Improved docs

Author: zesterer

src/cache.rs

@@ -50,7 +50,7 @@ pub trait Cached {
     fn make_parser<'src>(self) -> Self::Parser<'src>;
 }
 
-/// Allows a parser to be cached for use with inputs and outputs of difference lifetimes.
+/// Allows a parser to be cached for reuse with inputs and outputs of different lifetimes.
 pub struct Cache<C: Cached> {
     parser: C::Parser<'static>,
     #[allow(dead_code)]
@@ -75,7 +75,7 @@ impl<C: Cached> Cache<C> {
     /// Get a reference to the cached parser.
     ///
     /// Because this function is generic over an input lifetime, the returned parser can be used in many
-    /// difference contexts.
+    /// different contexts.
     pub fn get<'src>(&self) -> &C::Parser<'src> {
         // SAFETY: This is safe because the API of `Cache` requires that the parser we store is bound by an arbitrary
         // lifetime variable (see `Cached::make_parser`). Therefore, the implementor of `Cached` has no way to

src/lib.rs

@@ -1420,9 +1420,10 @@ pub trait Parser<'a, I: Input<'a>, O, E: ParserExtra<'a, I> = extra::Default>:
     /// Parse a pattern zero or more times (analog to Regex's `<PAT>*`).
     ///
     /// Input is eagerly parsed. Be aware that the parser will accept no occurrences of the pattern too. Consider using
-    /// [`Repeated::at_least`] instead if it better suits your use-case.
+    /// [`Repeated::at_least`] instead if you wish to parse a minimum number of elements.
     ///
-    /// The output type of this parser can be any [`Container`].
+    /// The output type of this parser is, by default, `()`. If you want to collect the items into a [`Container`]
+    /// (such as a [`Vec`]), use [`IterParser::collect`].
     ///
     /// # Examples
     ///
@@ -2729,7 +2730,7 @@ where
 /// Internally, [`select!`] is very similar to [`Parser::try_map`] and thinking of it as such might make it less
 /// confusing.
 ///
-/// `select!` requires that tokens implement [`Clone`].
+/// `select!` requires that tokens implement [`Clone`] and the input type implements [`ValueInput`].
 ///
 /// If you're trying to access tokens referentially (for the sake of nested parsing, or simply because you want to
 /// avoid cloning the token), see [`select_ref!`].