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: Mon, 11 Jan 2016 10:09:50 +0100 Message-ID: <87y4bwzdlt.fsf@gnu.org> References: <87k2nnk73w.fsf@gnu.org> <87vb72a924.fsf@gnu.org> <87bn8t5kw8.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]:57365) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aIYUA-0000vV-0A for guix-devel@gnu.org; Mon, 11 Jan 2016 04:09:58 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aIYU5-000780-0L for guix-devel@gnu.org; Mon, 11 Jan 2016 04:09:57 -0500 In-Reply-To: (Federico Beffa's message of "Sun, 10 Jan 2016 22:19:00 +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: > For PDFs, it depends on the type and quality of the manual. If it is > short and/or poor, then nobody will spend hours reading it. But if the > manual is good and long, then there is a chance that people will spend > a lot of time reading it and it would be nice to have a good quality > environment to read it (again, I'm talking about font graphics > rendering). I agree that rendering is much better in PDF. > This is analogous to making public buildings suitable for people with > wheel-chairs, ... may people don't care, until they are affected :-( I disagree with the analogy. On a computer, I find it simply less convenient to browse PDFs than to browse Info, and that outweighs the better rendering quality. (As it turns out, Info is also much more usable for people using a Braille reader.) When I want to read a complete manual, I prefer the paper version, though. > Well, the discussion is about this sentence: > > I just realized that its documentation is in Texinfo format. What abo= ut > simply installing the Info format like we do for other GNU packages, a= nd > not the PDF/PS/DVI version? > > I can't find: why don't we put the PDF/PS/DVI in a different output. You mean systematically? There are several reasons Guix does not systematically provide PDF manuals for GNU packages: 1. We follow the GNU Standards, which is that =E2=80=98make install=E2=80= =99 installs only Info by default. 2. There would be technical complications with building PDFs systematically (TeX Live is huge, has a lot of dependencies, etc.) 3. PDFs are quite big and (so I thought) inconvenient when reading on a screen, though I now understand that not everyone feels the same. 4. Until now there hasn=E2=80=99t been demand for it. So, back to MIT Scheme, what about adding PDFs in a =E2=80=9Cdoc=E2=80=9D o= utput, and installing Info only in =E2=80=9Cout=E2=80=9D? Regarding the rest of GNU packages, I=E2=80=99m very much in favor of the s= tatus quo, possibly with exceptions like this on a case-by-case basis. Let me know if you think this is not explicit enough! Thanks, Ludo=E2=80=99.