Add low-level warnings.

src/api/call_fn.rs

@@ -86,7 +86,11 @@ impl Engine {
     ///
     /// Not available under `no_function`.
     ///
-    /// # WARNING
+    /// # WARNING - Low Level API
+    ///
+    /// This function is very low level.
+    ///
+    /// ## Arguments
     ///
     /// All the arguments are _consumed_, meaning that they're replaced by `()`.
     /// This is to avoid unnecessarily cloning the arguments.

src/api/deprecated.rs

@@ -125,7 +125,11 @@ impl Engine {
     ///
     /// This method will be removed in the next major version.
     ///
-    /// # WARNING
+    /// # WARNING - Low Level API
+    ///
+    /// This function is very low level.
+    ///
+    /// ## Arguments
     ///
     /// All the arguments are _consumed_, meaning that they're replaced by `()`.
     /// This is to avoid unnecessarily cloning the arguments.
@@ -221,7 +225,11 @@ impl Dynamic {
 impl NativeCallContext<'_> {
     /// Call a function inside the call context.
     ///
-    /// # WARNING
+    /// # WARNING - Low Level API
+    ///
+    /// This function is very low level.
+    ///
+    /// ## Arguments
     ///
     /// All arguments may be _consumed_, meaning that they may be replaced by `()`. This is to avoid
     /// unnecessarily cloning the arguments.
@@ -273,7 +281,11 @@ impl FnPtr {
     ///
     /// This method will be removed in the next major version.
     ///
-    /// # WARNING
+    /// # WARNING - Low Level API
+    ///
+    /// This function is very low level.
+    ///
+    /// ## Arguments
     ///
     /// All the arguments are _consumed_, meaning that they're replaced by `()`.
     /// This is to avoid unnecessarily cloning the arguments.

src/api/register.rs

@@ -154,7 +154,7 @@ impl Engine {
     ///
     /// This function is very low level.  It takes a list of [`TypeId`][std::any::TypeId]'s indicating the actual types of the parameters.
     ///
-    /// # Arguments
+    /// ## Arguments
     ///
     /// Arguments are simply passed in as a mutable array of [`&mut Dynamic`][crate::Dynamic],
     /// The arguments are guaranteed to be of the correct types matching the [`TypeId`][std::any::TypeId]'s.