Sphinx function declaration syntax highlight issue

[LinuxJedi]

This code breaks highlighting after the initial function declaration (also breaks in vim's own highlighter). GitHub's own Markdown processor for rst highlighting is more in-line with what I would expect.

.. c:function:: int main(int argc, char* argv[])

   .. note::
      This section is not highlighted

   .. code-block:: cpp

      // Neither is this

   :param argc: also no highlight

[gu-fan]

... no not implement that... I think it's better not write this way

[LinuxJedi]

There are many API docs written this way on ReadTheDocs.

But I work somewhere else now and this no longer affects me, it would affect API authors and OpenStack more. Feel free to close.

[gu-fan]

Fine!

[gu-fan]

Keep it open for same user