From mboxrd@z Thu Jan 1 00:00:00 1970 From: Federico Beffa Subject: Re: [PATCH 5/6] gnu: mit-scheme: Generate and install documentation. Date: Mon, 11 Jan 2016 09:20:56 +0100 Message-ID: References: <87k2nnk73w.fsf@gnu.org> <87vb72a924.fsf@gnu.org> <87bn8t5kw8.fsf@gnu.org> <87wprhqb6v.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:46048) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aIXik-0002gz-0v for guix-devel@gnu.org; Mon, 11 Jan 2016 03:20:59 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aIXij-0003ew-29 for guix-devel@gnu.org; Mon, 11 Jan 2016 03:20:57 -0500 In-Reply-To: <87wprhqb6v.fsf@gnu.org> 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: Mathieu Lirzin Cc: Guix-devel On Mon, Jan 11, 2016 at 12:14 AM, Mathieu Lirzin wrote: > Hi, > > Federico Beffa writes: > >> HTML is not better than Info. Here we only need to keep it for >> 'emacs-mit-scheme-doc' to work. This is functionality for mit-scheme >> whereby Emacs looks up the documentation for the identifier at point. >> >> 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). >> >> This is analogous to making public buildings suitable for people with >> wheel-chairs, ... may people don't care, until they are affected :-( > > Sorry I don't understand your analogy. IIUC the discussion is about > what should be installed with the default output. Putting the PDF > version of the manual in the 'doc' output will not prevent anyone to use > it. Did I miss something? Well, the discussion is about this sentence: 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? I can't find: why don't we put the PDF/PS/DVI in a different output. If I misunderstood then my bad. But being less cryptic and more explicit would prevent that. Regards, Fede