diff --git a/include/evmc/evmc.h b/include/evmc/evmc.h
index 56953c6..81cba6c 100644
--- a/include/evmc/evmc.h
+++ b/include/evmc/evmc.h
@@ -974,12 +974,12 @@ struct evmc_instance
     evmc_execute_fn execute;
 
     /**
-     * Pointer to function returning capabilities supported by the VM instance.
+     * A method returning capabilities supported by the VM instance.
      *
-     * The value returned might change when different options are requested via set_option.
+     * The value returned MAY change when different options are set via the set_option() method.
      *
-     * A Client SHOULD only rely on the value returned here if it has queried it after
-     * it has called set_option.
+     * A Client SHOULD only rely on the value returned if it has queried it after
+     * it has called the set_option().
      *
      * This is a mandatory method and MUST NOT be set to NULL.
      */