improve and update docs

Author: Robbepop

crates/wasmi/src/engine/translator/func2/stack/mod.rs

@@ -425,7 +425,8 @@ impl Stack {
     ///
     /// # Note
     ///
-    /// Returns the [`Operand`] at `depth` before being converted to an [`Operand::Temp`].
+    /// - Returns the [`Operand`] at `depth` before being converted to an [`Operand::Temp`].
+    /// - [`Operand::Temp`] will have their optional `instr` set to `None`.
     ///
     /// # Panics
     ///

crates/wasmi/src/engine/translator/func2/stack/operands.rs

@@ -233,7 +233,8 @@ impl OperandStack {
     ///
     /// # Note
     ///
-    /// Returns the [`Operand`] at `depth` before being converted to an [`Operand::Temp`].
+    /// - Returns the [`Operand`] at `depth` before being converted to an [`Operand::Temp`].
+    /// - [`Operand::Temp`] will have their optional `instr` set to `None`.
     ///
     /// # Panics
     ///
@@ -249,7 +250,8 @@ impl OperandStack {
     ///
     /// # Note
     ///
-    /// Returns `None` if operand at `index` is [`StackOperand::Temp`] already.
+    /// - Returns the [`Operand`] at `index` before being converted to an [`Operand::Temp`].
+    /// - [`Operand::Temp`] will have their optional `instr` set to `None`.
     ///
     /// # Panics
     ///