#92 Add indentation to literal blocks in manpage writer

closed-accepted
None
5
2012-07-06
2012-05-16
No

The current manpage writer does not add or maintain any type of indentation on literal blocks.

Example:

$ cat example.rst

Title

:Version: 1.1
:Author: joe.user@example.com

Example

Example::

$ man ls

$ rst2man.py example.rst > example.man
$ man ./example.man
NAME
Title -

EXAMPLE
Example:

$ man ls

AUTHOR
joe.user@example.com

In the above example '$ man ls' starts at the same indentation level as 'Example:', which
seems difficult to read. A solution that has worked well for me is to treat literal blocks
like block quotes in the manpage writer.

Example:

$ rst2man.py example.rst > example.man
$ man ./example.man
NAME
Title -

EXAMPLE
Example:

$ man ls

AUTHOR
joe.user@example.com

Attached is patch to indent literal blocks like block quotes which I hope others may find
useful.

-Josh

Discussion

  • Joshua Graff

    Joshua Graff - 2012-05-16

    patch for manpage.py writer

     
  • engelbert gruber

    • assigned_to: nobody --> grubert
     
  • engelbert gruber

    • status: open --> closed
     
  • engelbert gruber

    • status: closed --> closed-accepted
     

Log in to post a comment.

Get latest updates about Open Source Projects, Conferences and News.

Sign up for the SourceForge newsletter:

JavaScript is required for this form.





No, thanks