Support exporting README to Texinfo format

[nnicandro]

So that the README contents can be converted into info pages available in Emacs.

[dcherian]

I could try to help with this. Are you thinking of using pandoc and making changes to make sure it renders nicely?

[nnicandro]

I was thinking more along the lines of using org-modes builtin texinfo exporter and using magits manual and the org-mode example as templates for all of the texinfo stuff.

Here are a few things that I think need to be done at the moment

• Add the proper file headers for texinfo exporting.
• Add an index of functions and variables, ensure that the function/variable sections are properly marked for the index.
• Suppress export of some headings
  • Table of contents since this is mainly for Github
  • How do I install this package? since, if you are reading the info page, the package is already installed
• Ensure all exported tables and lists look right in the info page
• Ensure all links are working properly in the info page

Note, you can already export an org file to a compiled info file using C-c C-e i i, not sure if you need to (require 'ox-texinfo) first or not.

[nnicandro]

An even better example of how to use the texinfo exporter would be the org-mode manual itself.