[Doc-SIG] ReST: how to break at the end of each line?

[David Goodger]

Pijus Virketis wrote:
> What I've got in the way of ReST is:
> 
> `Python <http://www.python.org>`__ favourite scripting language.
> `ReST <http://docutils.sf.net>`__ neat text processing system.
> 
> So far, so good. The only problem is that when html.py renders the 
> text, it puts everything on one line:
...
> now I would like to insert breaks at the end of each
> line in a nice ReST-like way, without resorting to hacks.

The way to do this is with line blocks.  For now, use the line-block
directive:

.. line-block::

    `Python <http://www.python.org>`__ favourite scripting language.
    `ReST <http://docutils.sf.net>`__ neat text processing system.

Soon, there will be specialized syntax for this.  It's on the to-do
list with a high priority:

| `Python <http://www.python.org>`__ favourite scripting language.
| `ReST <http://docutils.sf.net>`__ neat text processing system.

-- David Goodger