fix(api): Fix docs

lib/api/build.rs

@@ -384,5 +384,6 @@ fn main() {
     build_wamr();
 
     #[cfg(feature = "v8")]
-    build_v8()
+    build_v8();
+
 }

lib/api/src/entities/engine/engine_ref.rs

@@ -31,7 +31,7 @@ pub trait AsEngineRef {
     /// Create a [`StoreRef`].
     ///
     /// NOTE: this function will return [`None`] if the [`AsEngineRef`] implementor is not an
-    /// actual [`Store`].
+    /// actual [`crate::Store`].
     fn maybe_as_store(&self) -> Option<StoreRef<'_>> {
         None
     }

lib/api/src/entities/store/store_ref.rs

@@ -8,7 +8,7 @@ use wasmer_types::{ExternType, OnCalledAction};
 #[cfg(feature = "sys")]
 use wasmer_vm::TrapHandlerFn;
 
-/// A temporary handle to a [`Store`].
+/// A temporary handle to a [`crate::Store`].
 #[derive(Debug)]
 pub struct StoreRef<'a> {
     pub(crate) inner: &'a StoreInner,
@@ -39,7 +39,7 @@ impl<'a> StoreRef<'a> {
     }
 }
 
-/// A temporary handle to a [`Store`].
+/// A temporary handle to a [`crate::Store`].
 pub struct StoreMut<'a> {
     pub(crate) inner: &'a mut StoreInner,
 }

lib/api/src/lib.rs

@@ -408,6 +408,9 @@
 //! [`wasmer-wasix`]: https://docs.rs/wasmer-wasix/
 //! [`wasm-pack`]: https://github.com/rustwasm/wasm-pack/
 //! [`wasm-bindgen`]: https://github.com/rustwasm/wasm-bindgen
+//! [`v8`]: https://v8.dev/
+//! [`wamr`]: https://github.com/bytecodealliance/wasm-micro-runtime
+//! [`wasmi`]: https://github.com/wasmi-labs/wasmi
 
 #[cfg(not(any(
     feature = "sys",

lib/api/src/rt/sys/entities/function/env.rs

@@ -76,23 +76,23 @@ impl<T> FunctionEnv<T> {
 }
 
 impl<T> crate::FunctionEnv<T> {
-    /// Consume [`self`] into [`crate::rt::sys::function::env::FunctionEnv`].
+    /// Consume self into [`crate::rt::sys::function::FunctionEnv`].
     pub fn into_sys(self) -> FunctionEnv<T> {
         match self.0 {
             crate::RuntimeFunctionEnv::Sys(s) => s,
             _ => panic!("Not a `sys` function env!"),
         }
     }
 
-    /// Convert a reference to [`self`] into a reference to [`crate::rt::sys::function::env::FunctionEnv`].
+    /// Convert a reference to self into a reference to [`crate::rt::sys::function::FunctionEnv`].
     pub fn as_sys(&self) -> &FunctionEnv<T> {
         match self.0 {
             crate::RuntimeFunctionEnv::Sys(ref s) => s,
             _ => panic!("Not a `sys` function env!"),
         }
     }
 
-    /// Convert a mutable reference to [`self`] into a mutable reference [`crate::rt::sys::function::env::FunctionEnv`].
+    /// Convert a mutable reference to self into a mutable reference [`crate::rt::sys::function::FunctionEnv`].
     pub fn as_sys_mut(&mut self) -> &mut FunctionEnv<T> {
         match self.0 {
             crate::RuntimeFunctionEnv::Sys(ref mut s) => s,

lib/api/src/rt/sys/entities/memory/mod.rs

@@ -328,23 +328,23 @@ unsafe fn volatile_memcpy_write(mut src: *const u8, mut dst: *mut u8, mut len: u
 }
 
 impl crate::Memory {
-    /// Consume [`self`] into a [`crate::rt::sys::mem::Memory`].
+    /// Consume [`self`] into a [`crate::rt::sys::memory::Memory`].
     pub fn into_sys(self) -> crate::rt::sys::memory::Memory {
         match self.0 {
             RuntimeMemory::Sys(s) => s,
             _ => panic!("Not a `sys` memory!"),
         }
     }
 
-    /// Convert a reference to [`self`] into a reference to [`crate::rt::sys::mem::Memory`].
+    /// Convert a reference to [`self`] into a reference to [`crate::rt::sys::memory::Memory`].
     pub fn as_sys(&self) -> &crate::rt::sys::memory::Memory {
         match self.0 {
             RuntimeMemory::Sys(ref s) => s,
             _ => panic!("Not a `sys` memory!"),
         }
     }
 
-    /// Convert a mutable reference to [`self`] into a mutable reference to [`crate::rt::sys::mem::Memory`].
+    /// Convert a mutable reference to [`self`] into a mutable reference to [`crate::rt::sys::memory::Memory`].
     pub fn as_sys_mut(&mut self) -> &mut crate::rt::sys::memory::Memory {
         match self.0 {
             RuntimeMemory::Sys(ref mut s) => s,

lib/api/src/rt/sys/entities/store/obj.rs

@@ -3,23 +3,23 @@ use wasmer_vm::StoreId;
 use crate::AsStoreMut;
 
 impl crate::StoreObjects {
-    /// Consume [`self`] into [`crate::rt::sys::store::StoreObjects`].
+    /// Consume store objects into [`crate::rt::sys::store::StoreObjects`].
     pub fn into_sys(self) -> crate::rt::sys::store::StoreObjects {
         match self {
             Self::Sys(s) => s,
             _ => panic!("Not a `sys` store!"),
         }
     }
 
-    /// Convert a reference to [`self`] into a reference [`crate::rt::sys::store::StoreObjects`].
+    /// Convert a reference to store objects into a reference [`crate::rt::sys::store::StoreObjects`].
     pub fn as_sys(&self) -> &crate::rt::sys::store::StoreObjects {
         match self {
             Self::Sys(s) => s,
             _ => panic!("Not a `sys` store!"),
         }
     }
 
-    /// Convert a mutable reference to [`self`] into a mutable reference [`crate::rt::sys::store::StoreObjects`].
+    /// Convert a mutable reference to store objects into a mutable reference [`crate::rt::sys::store::StoreObjects`].
     pub fn as_sys_mut(&mut self) -> &mut crate::rt::sys::store::StoreObjects {
         match self {
             Self::Sys(s) => s,

lib/api/src/utils/mem/mod.rs

@@ -15,7 +15,7 @@ use access::{WasmRefAccess, WasmSliceAccess};
 use thiserror::Error;
 pub use wasmer_types::{Memory32, Memory64, MemorySize, ValueType};
 
-/// Error for invalid [`Memory`][super::Memory] access.
+/// Error for invalid [`Memory`][crate::Memory] access.
 #[derive(Clone, Copy, Debug, Error)]
 #[non_exhaustive]
 pub enum MemoryAccessError {