Fix markup

[wouterj]

versionadded directives are quite strange, as it doesn't allow to have empty lines in it. So both code blocks were rendered as a blockquote (using shortcut) and PHP code for the main text (using code-block directive). This fixes it and also fixes some other markup errors.

[xabbuh]

This change looks wrong.

[xabbuh]

Well, actually you just have to remove the second colon.

[xabbuh]

By the way, this seems to be an issue of the build process. Rendering the existing document with the raw template wraps both parts in a div container with a versionadded class.

ping @javiereguiluz

[javiereguiluz]

The limitation of no adding blank lines seem to be a feature instead of a bug (see http://sphinx-doc.org/markup/para.html#directive-versionadded):

.. versionadded:: version

This directive documents the version of the project which added the described 
feature to the library or C API. When this applies to an entire module, it should be 
placed at the top of the module section before any prose.

The first argument must be given and is the version in question; you can add a 
second argument consisting of a brief explanation of the change.

Example:

.. versionadded:: 2.5
   The *spam* parameter.

Note that there must be no blank line between the directive head and the 
explanation; this is to make these blocks visually continuous in the markup.

[xabbuh]

Note that there must be no blank line between the directive head and the
explanation; this is to make these blocks visually continuous in the markup.

@javiereguiluz This only means that you can't do something like this:

.. versionadded:: 2.5

    The *spam* parameter.

[wouterj]

I've merged this one. It would still be nice if we could find the problem.

[xabbuh]

@wouterj We still have to remove one of the two colons.

[wouterj]

@xabbuh I did that in f7d99dd (but forgot to mention it in my comment)

[xabbuh]

@wouterj Thanks, actually I didn't check before commenting.