[GHC] #10342: Convert User Guide from DocBook to AsciiDoc

[GHC]

#10342: Convert User Guide from DocBook to AsciiDoc
-------------------------------------+-------------------------------------
        Reporter:  dmbergey          |                   Owner:  dmbergey
            Type:  task              |                  Status:  new
        Priority:  normal            |               Milestone:
       Component:  Documentation     |                 Version:  7.10.1
      Resolution:                    |                Keywords:
Operating System:  Unknown/Multiple  |            Architecture:
 Type of failure:  Documentation     |  Unknown/Multiple
  bug                                |               Test Case:
      Blocked By:                    |                Blocking:
 Related Tickets:                    |  Differential Revisions:
-------------------------------------+-------------------------------------

Comment (by bgamari):

 I have looked into this in the past and found that asciidoc has a few
 rough edges that make a * conversion of the users guide rather ugly. I
 recently tried a conversion to ReStructuredText and was happy to find that
 a mostly mechanical conversion got quite far.

 I've proposed moving to ReStructuredText in
 [[https://mail.haskell.org/pipermail/ghc-devs/2015-September/010001.html
 this mailing list thread]] (which references my preliminary conversion).

--
Ticket URL: <http://ghc.haskell.org/trac/ghc/ticket/10342#comment:2>
GHC <http://www.haskell.org/ghc/>
The Glasgow Haskell Compiler