[Docutils-users] Literal blocks within Option Lists (for man pages)

[Thomas A. <tho...@gm...>]

Hi all,

I'm writing a man page using RST and have come across a situation I can't
solve.  I have an option block, and within it, I'd like to have a part of the
text block indented.   To achieve that, I've done the following:

<RST TEXT>
-l, --color-limit limit
	Line1.
	Line2.
	Line3.

	::

		Indented line 1.
		Indented line 2.
		Indented line 3.

		Indented line 4.
		Indented line 5.
		Indented line 6.

</RST TEXT>

This all works fine, and the indented lines are rendered as I'd expect them
to.  However, I also have further lines which are part of the description for
the '-l' option.  However, those lines are not indented at the same level as
lines "Line1", "Line2", etc.

Here's the code as I've written it including the additional text:


<RST TEXT>
-l, --color-limit limit
	Line1.
	Line2.
	Line3.

	::

		Indented line 1.
		Indented line 2.
		Indented line 3.

		Indented line 4.
		Indented line 5.
		Indented line 6.

	More lines 1.
	More lines 2.
	More lines 3.
</RST TEXT>

However, the rest of the text ("More lines 1", etc.) isn't aligned at the same
level as "Line1".  Instead, they're flush left to the screen, which isn't
something I'd expect.

Is what I'm trying to achieve possible?  Am I using the correct means of
indenting the block of lines in the first place?  Or is this type of thing not
supported within option lists?

Any pointers much appreciated.

Kindly,
Thomas Adam