diff --git a/include/librustzcash.h b/include/librustzcash.h
index 666f780..5a06b00 100644
--- a/include/librustzcash.h
+++ b/include/librustzcash.h
@@ -12,7 +12,7 @@ extern "C" {
     /// Initializes some parameters for sapling-crypto,
     /// returning a pointer to the parameters. You should
     /// free this when you're done with 
-    /// `librustzcash_init_params()`.
+    /// `librustzcash_free_params()`.
     librustzcash_params* librustzcash_init_params();
 
     /// Frees some parameters that were previously returned
diff --git a/src/rustzcash.rs b/src/rustzcash.rs
index 70bf70b..19fe22b 100644
--- a/src/rustzcash.rs
+++ b/src/rustzcash.rs
@@ -90,7 +90,7 @@ pub extern "system" fn librustzcash_merkle_hash(
     ).into_xy().0.into_repr();
 
     // Should be okay, caller is responsible for ensuring the pointer
-    // is valid.
+    // is a valid pointer to 32 bytes that can be mutated.
     let result = unsafe { &mut *result };
 
     tmp.write_be(&mut result[..]).unwrap();