tools/gen-cpydiff: Use case description as 3rd-level heading.

pfalcon · pfalcon · commit ad5e7a0e6f99 · 2017-07-09T13:51:40.000+03:00
This is required to easily giving links to a particular difference case.
Also, add RST anchors to allow cases to cross-reference each other.
diff --git a/tools/gen-cpydiff.py b/tools/gen-cpydiff.py
@@ -185,7 +185,9 @@ def gen_rst(results):
                     rst.write(RSTCHARS[min(i, len(RSTCHARS)-1)] * len(section[i]))
                     rst.write('\n\n')
         class_ = section
-        rst.write('**' + output.desc + '**\n\n')
+        rst.write('.. _cpydiff_%s:\n\n' % output.name.rsplit('.', 1)[0])
+        rst.write(output.desc + '\n')
+        rst.write('~' * len(output.desc) + '\n\n')
         if output.cause != 'Unknown':
             rst.write('**Cause:** ' + output.cause + '\n\n')
         if output.workaround != 'Unknown':
