Revision 354c4f62
ID | 354c4f6292b9bbc110122f080d045819f6e596ea |
man: Man page reference cleanup
Sphinx is stricter than pandoc when parsing reST and does not allow an
opening parenthesis to directly follow inline markup. [1] describes the
rules. A backslash, as described in [2], can be used to separate the
two.
Additionally, there were different forms for referring to man pages.
Sometimes it was a plain “ganeti(7)”, sometimes “**ganeti**(7)” and
other times “**ganeti(7)**” (of course with different names and
numbers).
Commit 7acbda7b added a new paragraph and used the Sphinx-specific
“:manpage:…” markup, which isn't supported by pandoc. It is replaced
with a standard reference.
[1]
http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#
inline-markup-recognition-rules
[2]
http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#
character-level-inline-markup
Signed-off-by: Michael Hanselmann <hansmi@google.com>
Reviewed-by: Guido Trotter <ultrotter@google.com>
Files
- added
- modified
- copied
- renamed
- deleted
- man
- footer.rst (diff)
- ganeti-listrunner.rst (diff)
- ganeti-noded.rst (diff)
- ganeti.rst (diff)
- gnt-backup.rst (diff)
- gnt-cluster.rst (diff)
- gnt-debug.rst (diff)
- gnt-group.rst (diff)
- gnt-instance.rst (diff)
- gnt-job.rst (diff)
- gnt-network.rst (diff)
- gnt-node.rst (diff)
- gnt-os.rst (diff)
- hail.rst (diff)
- hbal.rst (diff)
- hcheck.rst (diff)
- hinfo.rst (diff)
- hroller.rst (diff)
- hscan.rst (diff)
- hspace.rst (diff)
- htools.rst (diff)