docs: Document files, enable files list

Doxyfile

@@ -100,7 +100,7 @@ WARN_LOGFILE           =
 # Configuration options related to the input files
 #---------------------------------------------------------------------------
 INPUT                  = \
-    include/evmc/evmc.h include/evmc/evmc.hpp include/evmc/helpers.h include/evmc/helpers.hpp include/evmc/loader.h include/evmc/utils.h include/evmc/instructions.h \
+    include/evmc/ \
     docs/ \
     examples/example_vm.c
 INPUT_ENCODING         = UTF-8
@@ -109,7 +109,7 @@ RECURSIVE              = NO
 EXCLUDE                =
 EXCLUDE_SYMLINKS       = NO
 EXCLUDE_PATTERNS       =
-EXCLUDE_SYMBOLS        = internal
+EXCLUDE_SYMBOLS        = internal std
 EXAMPLE_PATH           =
 EXAMPLE_PATTERNS       =
 EXAMPLE_RECURSIVE      = NO

docs/custom.dox

@@ -0,0 +1,29 @@
+/**
+ * @defgroup cpp EVMC C++
+ * @copydoc evmc
+ */
+
+/**
+ * @file evmc.h
+ * @copydoc EVMC
+ */
+
+/**
+ * @file evmc.hpp
+ * @copydoc cpp
+ */
+
+/**
+ * @file helpers.h
+ * @copydoc helpers
+ */
+
+/**
+ * @file instructions.h
+ * @copydoc instructions
+ */
+
+/**
+ * @file loader.h
+ * @copydoc loader
+ */

include/evmc/evmc.hpp

@@ -9,11 +9,8 @@
 #include <initializer_list>
 #include <utility>
 
-/// @defgroup cpp EVMC C++
-/// @copydoc evmc
-/// @{
-
 /// EVMC C++ API - wrappers and bindings for C++
+/// @ingroup cpp
 namespace evmc
 {
 /// @copydoc evmc_result
@@ -334,5 +331,3 @@ constexpr evmc_host_interface interface{
 inline Host::Host() noexcept : evmc_context{&internal::interface} {}
 
 }  // namespace evmc
-
-/// @}

include/evmc/helpers.h

@@ -6,7 +6,7 @@
 /**
  * EVMC Helpers
  *
- * A collection of helper functions for invoking a VM instance methods.
+ * A collection of C helper functions for invoking a VM instance methods.
  * These are convenient for languages where invoking function pointers
  * is "ugly" or impossible (such as Go).
  *

include/evmc/utils.h

@@ -6,6 +6,9 @@
 #pragma once
 
 /**
+ * @file
+ * A collection of helper macros to handle some non-portable features of C/C++ compilers.
+ *
  * @addtogroup helpers
  * @{
  */