From mboxrd@z Thu Jan 1 00:00:00 1970 From: ludo@gnu.org (Ludovic =?utf-8?Q?Court=C3=A8s?=) Subject: Re: [PATCH 5/6] gnu: mit-scheme: Generate and install documentation. Date: Sun, 10 Jan 2016 19:50:31 +0100 Message-ID: <87bn8t5kw8.fsf@gnu.org> References: <87k2nnk73w.fsf@gnu.org> <87vb72a924.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:48517) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aIL4Z-0004Y2-3S for guix-devel@gnu.org; Sun, 10 Jan 2016 13:50:40 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aIL4U-0001RW-DI for guix-devel@gnu.org; Sun, 10 Jan 2016 13:50:39 -0500 In-Reply-To: (Federico Beffa's message of "Sat, 9 Jan 2016 23:32:28 +0100") List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org To: Federico Beffa Cc: Guix-devel Federico Beffa skribis: > On Sat, Jan 9, 2016 at 7:42 PM, Ludovic Court=C3=A8s wrote: >> Federico Beffa skribis: >>> MIT Scheme is a complex system and without the documentation it's not >>> possible to use it proficiently. >> >> Agreed, I didn=E2=80=99t mean to imply we should give up on documentatio= n. >> >> 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=E2=80=99m very much in favor of keeping only Info by default, possibly with a few exceptions. WDYT? Ludo=E2=80=99.