wasm2c: Misc docs and inline comment fixes

2 files changed, 11 insertions, 17 deletions

diff --git a/wasm2c/README.md b/wasm2c/README.md
index 625ce25b..68fdb11a 100644
--- a/wasm2c/README.md
+++ b/wasm2c/README.md
@@ -305,30 +305,25 @@ runtime has been initialized.
 `wasm_rt_trap` is a function that is called when the module traps. Some possible
 implementations are to throw a C++ exception, or to just abort the program
 execution. The default runtime included in wasm2c unwinds the stack using
-`longjmp`. You can overide this call to `longjmp` from the embeder by defining a
-custom trap handler with the signature `void
-wasm2c_custom_trap_handler(wasm_rt_trap_t code)` and compiling the runtime with
-the with macro definition
-`#define WASM_RT_TRAP_HANDLER wasm2c_custom_trap_handler`. It is recommended
-that you add this macro definition via a compiler flag
-(`-DWASM_RT_TRAP_HANDLER=wasm2c_custom_trap_handler` on clang/gcc).
+`longjmp`. The host can overide this call to `longjmp` by compiling the runtime
+with `WASM_RT_TRAP_HANDLER` defined to the name of a trap handler function. The
+handler function should be a function taking a `wasm_rt_trap_t` as a parameter
+and returning `void`. e.g. `-DWASM_RT_TRAP_HANDLER=my_trap_handler`
 
 `wasm_rt_allocate_memory` initializes a memory instance, and allocates at least
 enough space for the given number of initial pages. The memory must be cleared
 to zero. The `is64` parameter indicates if the memory is indexed with
 an i32 or i64 address.
 
-`wasm_rt_grow_memory` must grow the given memory instance by the given number
-of pages. If there isn't enough memory to do so, or the new page count would be
+`wasm_rt_grow_memory` must grow the given memory instance by the given number of
+pages. If there isn't enough memory to do so, or the new page count would be
 greater than the maximum page count, the function must fail by returning
 `0xffffffff`. If the function succeeds, it must return the previous size of the
 memory instance, in pages. The host can optionally be notified of failures by
-defining a function the signature `void wasm2c_grow_failed_handler()` and
-compiling the runtime with the with macro definition `#define
-WASM_RT_GROW_FAILED_HANDLER wasm2c_grow_failed_handler`. It is recommended that
-you add this macro definition via a compiler flag
-(`-WASM_RT_GROW_FAILED_HANDLER=wasm2c_grow_failed_handler` on clang/gcc).
-
+compiling the runtime with `WASM_RT_GROW_FAILED_HANDLER` defined to the name of
+a handler function.  The handler function should be a function taking no
+arguments and returning `void` . e.g.
+`-DWASM_RT_GROW_FAILED_HANDLER=my_growfail_handler`
 
 `wasm_rt_free_memory` frees the memory instance.
 
diff --git a/wasm2c/wasm-rt-impl.c b/wasm2c/wasm-rt-impl.c
index 25532e95..5616ce92 100644
--- a/wasm2c/wasm-rt-impl.c
+++ b/wasm2c/wasm-rt-impl.c
@@ -300,7 +300,6 @@ void wasm_rt_free(void) {
 #if WASM_RT_USE_MMAP
 
 static uint64_t get_allocation_size_for_mmap(wasm_rt_memory_t* memory) {
-  /* Reserve 8GiB. */
   assert(!memory->is64 &&
          "memory64 is not yet compatible with WASM_RT_USE_MMAP");
 #if WASM_RT_MEMCHECK_GUARD_PAGES
@@ -399,7 +398,7 @@ uint64_t wasm_rt_grow_memory(wasm_rt_memory_t* memory, uint64_t delta) {
 void wasm_rt_free_memory(wasm_rt_memory_t* memory) {
 #if WASM_RT_USE_MMAP
   const uint64_t mmap_size = get_allocation_size_for_mmap(memory);
-  os_munmap(memory->data, mmap_size);  // ignore error?
+  os_munmap(memory->data, mmap_size); // ignore error
 #else
   free(memory->data);
 #endif