title: How to add non-commented code blocks to numbered documentation sections
body: <p>I need to produce documentation that has a numbered list of reference blocks that contains a tag, an incrementing number, and a real block of code (preferably with links). I can deal with at minimum a tag, unique number, and a real block of code.</p>
  
  <p>So take this:</p>
  
  <p><strong>C++ code</strong>:</p>
  
  <pre><code>    int a = 5;
      int b = 10;
      int c, d;
      /**
       * @method{} Multiply
       */
      c = a*b;
      /** @endmethod */
      /**
       * @method{} Divide
       */
      d = a/b;
      /** @endmethod */
  </code></pre>
  
  <p>And turn it into a Doxygen page under "Related Pages" called "Methods" that lists these two methods WITH the titles, something like:</p>
  
  <p><strong>Doxygen output - Related Pages - Methods</strong>:</p>
  
  <pre><code>Function foobar
  
  Method 1: Multiply      &lt;-- {} First argument turns to a number?
  c = a*b;                &lt;-- More important: This gets pulled from the code?
  
  Method 2: Divide
  d = a/b;
  </code></pre>
  
  <p>Maybe there's a better tool for this? </p>
  
  <p>I've gotten so far as to produce the "Methods" page under "Related Pages" with my comments by adding this alias to the Doxyfile:</p>
  
  <p><strong>Doxyfile</strong>:</p>
  
  <pre><code>ALIASES += "method=\xrefitem method \"Method \" \"Methods\" "
  </code></pre>
  
  <p>BUT I cannot figure out a way to grab actual code to insert into the documentation...OR how to auto or manually number them (which I could preprocess)...closest I've gotten is <strong>@code</strong> and <strong>groups</strong> which was hacky and didn't work?</p>