Merge branch 'master' into onnx_fixes

tools/include/target.hpp

@@ -12,7 +12,30 @@
 
 namespace migraph {
 
-struct program;
+#ifdef DOXYGEN
+
+/// An interface for a compilation target
+struct target
+{
+    /// A unique name used to identify the target
+    std::string name() const;
+    /// The transformation passes to be run
+    /**
+     * @brief The transformation pass to be run during compilation.
+     * @details [long description]
+     *
+     * @param ctx This is the target-dependent context that is created by `get_context`
+     * @return The passes to be ran
+     */
+    std::vector<pass> get_passes(context& ctx) const;
+    /**
+     * @brief Construct a context for the target.
+     * @return The context to be used during compilation and execution.
+     */
+    context get_context() const;
+};
+
+#else
 
 <%
 interface('target',
@@ -22,6 +45,8 @@ interface('target',
 )
 %>
 
+#endif
+
 } // namespace migraph
 
 #endif

tools/te.py

@@ -239,7 +239,8 @@ def convert_member(d, struct_name):
             'member_const': '',
             'friend': '',
             'this': '(*this)',
-            'using': ''
+            'using': '',
+            'brief': ''
         }
         args = []
         params = []
@@ -266,6 +267,8 @@ def convert_member(d, struct_name):
                 member['default'] = t
             elif x == 'using':
                 member['using'] = 'using {};'.format(d[name]['using'])
+            elif x == '__brief__':
+                member['doc'] = '/// ' + t
             elif x.startswith('__') and x.endswith('__'):
                 continue
             else: