Update comments

src/function.rs

@@ -77,7 +77,7 @@ impl<'lua> Function<'lua> {
                 return Err(pop_error(lua.state, ret));
             }
             let nresults = ffi::lua_gettop(lua.state) - stack_start;
-            let mut results = args; // Recycle MultiValue container
+            let mut results = args; // Reuse MultiValue container
             assert_stack(lua.state, 2);
             for _ in 0..nresults {
                 results.push_front(lua.pop_value());

src/thread.rs

@@ -137,7 +137,7 @@ impl<'lua> Thread<'lua> {
                 return Err(pop_error(thread_state, ret));
             }
 
-            let mut results = args; // Recycle MultiValue container
+            let mut results = args; // Reuse MultiValue container
             check_stack(lua.state, nresults + 2)?; // 2 is extra for `lua.pop_value()` below
             ffi::lua_xmove(thread_state, lua.state, nresults);
 

src/value.rs

@@ -163,6 +163,7 @@ impl<'lua> MultiValue<'lua> {
         MultiValue(Vec::new())
     }
 
+    /// Similar to `new` but can return previously used container with allocated capacity.
     #[inline]
     pub(crate) fn new_or_cached(lua: &'lua Lua) -> MultiValue<'lua> {
         lua.new_or_cached_multivalue()