Rename detail header, fix some comments

Author: Eczbek

…/rsl/_impl/macro/define_static_array.hpp include/rsl/_impl/macro/compat.hppinclude/rsl/_impl/macro/define_static_array.hpp renamed to include/rsl/_impl/macro/compat.hpp include/rsl/_impl/macro/define_static_array.hpp renamed to include/rsl/_impl/macro/compat.hpp

@@ -1,5 +1,4 @@
 #pragma once
-#include <version>
 
 #define RSL_COMPILER_UNKNOWN 0
 #define RSL_COMPILER_CLANG   1
@@ -49,4 +48,4 @@
 #else
 #  define RSL_STDLIB         RSL_STDLIB_UNKNOWN
 #  define RSL_STDLIB_VERSION 0
-#endif
+#endif

include/rsl/_impl/macro/compiler.hpp

@@ -24,41 +24,43 @@
  */
 #define $os_is(os) (RSL_OS == RSL_OS_##os)
 
-/// feature macro helper
+/// Feature macro helper
 #define $uses_opt(x) USES_OPT(x)
 
 /**
- * @param: one of always, never
+ * @param opt: one of always, never
  */
-#define $inline(...) RSL_INLINE(__VA_ARGS__)
+#define $inline(opt) RSL_INLINE(opt)
 
-/** Enable this overload if expr evaluates to true. Clang only.
- * @param expr
- */
+/// Enable this overload if a given expression evaluates to true. Clang only.
 #define $enable_if(...) RSL_ENABLE_IF(__VA_ARGS__)
 
 //! Workaround for expansion statements in GCC
 #define $define_static_array(...) RSL_DEFINE_STATIC_ARRAY(__VA_ARGS__)
 
 /** Applies `macro` to every element and inserts delimiters produced by `delim` between elements
- * @param macro function-like macro applied to every element
- * @param delim function-like macro producing the delimiter
- * @param ... elements to loop over
+ * @param macro: function-like macro applied to every element
+ * @param delim: function-like macro producing the delimiter
+ * @param ...: elements to loop over
 */
 #define $for_each_delim(macro, delim, ...) RSL_IMPL_FOR_EACH_DELIM(macro, delim, __VA_ARGS__)
 
 /** Applies `macro` to every element and inserts commas between elements
- * @param macro function-like macro applied to every element
- * @param ... elements to loop over
+ * @param macro: function-like macro applied to every element
+ * @param ...: elements to loop over
 */
 #define $for_each_list(macro, ...) RSL_IMPL_FOR_EACH_DELIM(macro, RSL_IMPL_DELIM_COMMA, __VA_ARGS__)
 
 /** Applies `macro` to every element
- * @param macro function-like macro applied to every element
- * @param ... elements to loop over
+ * @param macro: function-like macro applied to every element
+ * @param ...: elements to loop over
 */
 #define $for_each(macro, ...) RSL_IMPL_FOR_EACH_DELIM(macro, RSL_IMPL_DELIM_NONE, __VA_ARGS__)
 
+/**
+ * @param op: one of push, pop, disable, error
+ * @param ...: optional arguments
+*/
 #define $diagnostics(op, ...) RSL_DIAG_##op (__VA_ARGS__)
 
 /// Introduces an explicit template region