Readthedocs and markdown manpages

[darosior]

As per #2928 (comment), fixes #2918.

This completely moves on from asciidoc to Markdown for manpages thanks to a tweaked version of a Python Markdown->Roff converter. That way, manpages can be completely written in Markdown, displayed in readthedocs, and converted to Roff.

There are still some little things to be fixed with final Roff manpages (WIP) but I wanted to get some feedbacks (for example, is the huge number of insertions/deletions due to file creation/deletion/regeneration a problem ?). Here is a sample of a Markdown manpage : https://gist.github.com/darosior/48bfdf65017ad4a10811be5f00adc32d .

Closes #2928

[rustyrussell]

Yeah, happy with this. I grabbed asciidoc because I'd used it before for man pages; happy to change to any sane format, like another markdown.

Would be tempted to split into one commit which replaced the .txt with .md files, and another which replaced the generated man pages. But that's a minor issue, to help review. Someone has to read all the man pages though...

[darosior]

Would be tempted to split into one commit which replaced the .txt with .md files, and another which replaced the generated man pages. But that's a minor issue, to help review.

It's already what's done ? 547b0c0 for txt replacement by md and eb09276 for manpage replacement

Someone has to read all the man pages though...

I've read most of them yesterday and will finish today once I've fixed some typos

[darosior]

I've fixed the Markdown lists inconsistence at roff generation, regenerated manpages, adapted check-manpages, stole @rustyrussell's recipe to update readthedocs pages from #2928, and (more importantly) reviewed all generated md files and manpages.

[darosior]

Here is another Markdown manpage sample : https://gist.github.com/darosior/05e6c9da8d2bb0f55b8c15ca217b6499 (took disconnect because there are multiple text formatting : code, errors, bold, italic, ..)
And here is the corresponding man :

[cdecker]

ACK e007a9f

[darosior]

Rebased to resolve conflicts.

[cdecker]

I'm afraid we missed the freeze window by a tiny bit, so we'll merge this directly after the 0.7.2.

[rustyrussell]

Rebased, a bit tricky since listforards had been significantly reworked. but we have the whole dev window to fixup :)

Ack 4b9e3c9

[darosior]

Thank you for the rebase! :-)