Re: [PATCH 5/6] gnu: mit-scheme: Generate and install documentation.

[ludo@gnu.org (Ludovic Courtès)]

Federico Beffa <beffa@ieee.org> skribis:

> On Sat, Jan 9, 2016 at 7:42 PM, Ludovic Courtès <ludo@gnu.org> wrote:
>> Federico Beffa <beffa@ieee.org> skribis:
>>> MIT Scheme is a complex system and without the documentation it's not
>>> possible to use it proficiently.
>>
>> Agreed, I didn’t mean to imply we should give up on documentation.
>>
>> I just realized that its documentation is in Texinfo format.  What about
>> simply installing the Info format like we do for other GNU packages, and
>> not the PDF/PS/DVI version?
>
> Texinfo is great for looking up pieces of information in a reference
> manual.

You mean Info, right?

> However, when it comes to reading a sizable part, I much prefer PDFs
> with a much superior graphic quality and scaling capability and would
> like to keep it (my eyes aren't in great conditions). I think we can
> drop PS. DVI is not installed. HTML is required by
> 'emacs-mit-scheme-doc'.

One can choose the font family and size for Info documents viewed in
Emacs (or even in a terminal.)  :-)  I find that Info is much more
convenient when reading on a computer because of its interface to
navigate the document, search the indexes, and search for words.

The thing is, we could make an exception for MIT Scheme and provide PDF
and/or HTML in addition to Info.

However, what should we do with the whole set of GNU packages?  I’m
very much in favor of keeping only Info by default, possibly with a few
exceptions.

WDYT?

Ludo’.