Improve lore2sphinx buildbot results for `projects/conch`

[khorn]

Make the lore2sphinx buildbot results for projects/conch look as good as possible by modifying the lore sources.

Things to look for:

1. nested inline markup should be removed
2. whitespace should be added or removed as needed to make ReST markup render properly
3. anything else that you can improve by modifying the Lore sources

Note that you probably want to run lore2sphinx on a local copy for development purposes.

You can get lore2sphinx from: ​http://bitbucket.org/khorn/lore2sphinx

[Screwtape]

A patch that cleans up the Sphinx rendering of the Conch docs.

[khorn]

The lore2sphinx buildbot results can be found at:

​http://buildbot.twistedmatrix.com/builds/sphinx-html-15615/

(or at different directories for different revisions...the containing directory is browseable)

[Screwtape]

Changes in this patch:

• Added trailing spaces to a few lines so that the element on the next line would be correctly rendered, not rendered as raw ReST markup.
• Fixed some links to point to the correct places.
• The link to telnet_echo.tac now shows its description.
• Added descriptions for sshsimpleclient.py and sshsimpleserver.py.
• Filenames and descriptions on the examples page are separated by hyphens, as they are in the Twisted Core examples page

[Screwtape]

Oh, and things that aren't fixed: spaces between inline markup and end-of-sentence punctuation.

[exarkun]

Looks fine, although it's missing a news fragment. One thing I noticed while reviewing this, though, is that code listings no longer have line numbers. Could you file a ticket for that?

[Screwtape]

One thing I noticed while reviewing this, though, is that code listings no longer have line numbers.

Filed as #4586.

[screwtape]

(In [29822]) Create branch improve-lore2sphinx-output-for-projects-conch-4566

[screwtape]

(In [29823]) Apply lore-conch-cleanups.diff

refs #4566

[screwtape]

(In [29824]) Address exarkun's code-review comments.

refs #4566

[Screwtape]

Sphinx output ​here.

[exarkun]

Looks good. Please merge.

[screwtape]

(In [29850]) Merge improve-lore2sphinx-output-for-projects-conch-4566: Tidy conch docs for lore2sphinx conversion.

Author: screwtape Reviewers: exarkun Fixes: #4566

• Added trailing spaces to a few lines so that the element on the next line would be correctly rendered, not rendered as raw ReST markup.
• Fixed some links to point to the correct places.
• The link to telnet_echo.tac now shows its description.
• Added descriptions for sshsimpleclient.py and sshsimpleserver.py.
• Filenames and descriptions on the examples page are separated by hyphens, as they are in the Twisted Core examples page