<div dir="ltr">On 14 October 2016 at 10:36,  <span dir="ltr"><<a href="mailto:kevin.rogovin@intel.com" target="_blank">kevin.rogovin@intel.com</a>></span> wrote:<br><div class="gmail_extra"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">From: Kevin Rogovin <<a href="mailto:kevin.rogovin@intel.com">kevin.rogovin@intel.com</a>><br>
<br>
A main page ala Doxygen together with a Doxygen file added.<br>
In addition, documentation for portions of anv_private.h:<br>
 - placing portions into doxygen groups<br>
 - some cross linking doxygen style to other files<br></blockquote><div><br></div><div>Hello Kevin,<br><br></div><div>Thanks for the initial steps to document anv.<br><br></div><div>Can I make two suggestions:<br></div><div>1. Split out into two patches: (a) adding of inline comments to .c/.h files; and (b) the doxygen plumbing.<br></div><div>2. In relation to the doxygen plumbing you can leverage the existing ($top_dir)/doxygen/ to reduce your patch size.<br><br></div><div>Suggest that you look at how i965.doxy and common.doxy interact.<br></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div>
<br>
Signed-off-by: Kevin Rogovin <<a href="mailto:kevin.rogovin@intel.com">kevin.rogovin@intel.com</a>><br>
---<br>
 src/intel/genxml/gen_macros.h           |    4 +-<br>
 src/intel/vulkan/anv_<wbr>allocator.c        |    5 +-<br>
 src/intel/vulkan/anv_private.h          |  287 +++-<br>
 src/intel/vulkan/docs/.<wbr>gitignore        |    1 +<br>
 src/intel/vulkan/docs/Doxyfile          | 2483 ++++++++++++++++++++++++++++++<wbr>+<br>
 src/intel/vulkan/docs/intel_<wbr>vulkan.doxy |   86 ++<br>
 6 files changed, 2845 insertions(+), 21 deletions(-)<br>
 create mode 100644 src/intel/vulkan/docs/.<wbr>gitignore<br>
 create mode 100644 src/intel/vulkan/docs/Doxyfile<br>
 create mode 100644 src/intel/vulkan/docs/intel_<wbr>vulkan.doxy<br>
<font color="#888888"></font></div></blockquote><div><br></div><div><snip><font color="#888888"><br><br></font> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div><span class="HOEnZb"></span><br><span class="HOEnZb"></span></div><div><span class="HOEnZb"><font color="#888888">
<br>
______________________________<wbr>_________________<br>
mesa-dev mailing list<br>
<a href="mailto:mesa-dev@lists.freedesktop.org">mesa-dev@lists.freedesktop.org</a><br>
<a href="https://lists.freedesktop.org/mailman/listinfo/mesa-dev" rel="noreferrer" target="_blank">https://lists.freedesktop.org/<wbr>mailman/listinfo/mesa-dev</a><br>
</font></span></div></blockquote></div><br></div></div>