title: Doxygen and Objective-C categories
body: <p>Although the latest releases of Doxygen <a href="http://www.doxygen.nl/manual/changelog.html" rel="nofollow noreferrer">claim better handling of Objective-C categories</a>, it still seems to choke on categories in my source code. I'm wondering if someone has gotten it to document categories properly.</p>
  
  <p>As an example, I have a category on NSString defined as:</p>
  
  <pre><code>@interface NSString (CCFExtensions)
  </code></pre>
  
  <p>with an interface file named NSString_CCFExtensions.h and implementation file NSString_CCFExtension.m</p>
  
  <p>Doxygen will reference the file with the superclass; but none of the category methods are documented, despite seemingly valid doxygen syntax.</p>
  
  <p>What is the correct source markup to get Objective-C categories working?  </p>