From mboxrd@z Thu Jan  1 00:00:00 1970
From: ludo@gnu.org (Ludovic =?utf-8?Q?Court=C3=A8s?=)
Subject: Re: [PATCH] gnu: unison: Add "doc" output.
Date: Mon, 18 Jan 2016 10:49:06 +0100
Message-ID: <87wpr7i5f1.fsf@gnu.org>
References: <20151218194215.50af651c@openmailbox.org> <8737uwu5xg.fsf@gnu.org>
	<20151220220138.1346f5b5@PocketWee> <8760zsozld.fsf@gnu.org>
	<20160108011341.263e863a@openmailbox.org> <87oacwl6fd.fsf@gnu.org>
	<20160117002839.5e2e00bd@openmailbox.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Return-path: <guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:50535)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ludo@gnu.org>) id 1aL6Qx-0003Mg-Qq
	for guix-devel@gnu.org; Mon, 18 Jan 2016 04:49:13 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <ludo@gnu.org>) id 1aL6Qu-0002S2-LQ
	for guix-devel@gnu.org; Mon, 18 Jan 2016 04:49:11 -0500
In-Reply-To: <20160117002839.5e2e00bd@openmailbox.org> (Eric Bavier's message
	of "Sun, 17 Jan 2016 00:28:39 -0600")
List-Id: "Development of GNU Guix and the GNU System distribution."
	<guix-devel.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/guix-devel>,
	<mailto:guix-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/guix-devel>
List-Post: <mailto:guix-devel@gnu.org>
List-Help: <mailto:guix-devel-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/guix-devel>,
	<mailto:guix-devel-request@gnu.org?subject=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: Eric Bavier <ericbavier@openmailbox.org>
Cc: guix-devel@gnu.org

Eric Bavier <ericbavier@openmailbox.org> skribis:

> On Fri, 08 Jan 2016 11:19:34 +0100
> ludo@gnu.org (Ludovic Court=C3=A8s) wrote:

[...]

>> What about installing only HTML?
>>=20
>> I find that HTML (and Info, and man) is more convenient to read on-line
>> than PDFs.  We rarely include PDF documentation in packages.
>
> I sometimes find PDF documentation more visually appealing, but only if
> they having functioning hyperlinks.  Which unison's pdf docs lack,
> so yes, I think we can install just the HTML.

OK.

>> Of course, avoiding PDF/PS/DVI allows us to remove the dependency on
>> TeX=C2=A0Live.  Last, from discussions I heard at the Reproducible Build
>> Summit, I think DVIs and maybe PS/PDFs are not bit-reproducible
>> out-of-the-box.
>
> However, it appears the unison-manual.tex needs to be run through LaTeX
> at least once in order to get a TOC for hevea to include in the html
> output.  So it seems we can't remove TeX Live.  Sigh...

Heh.

> I don't want to spend much more time on this, so I think I'll push a
> slight modification of this patch that just doesn't install the pdf,
> ps, and dvi output for the sake a reproducibility.

OK!  Well maybe you could install the PDF, I haven=E2=80=99t check whether =
our
packages and build environment actually fail to create PDFs in a
reproducible fashion.  Your call.

>> Maybe we should have a policy on how to choose the installed
>> documentation formats.
>
> Info > HTML > man > txt > PDF > PS ?

Roughly, yes.

Thank you!

Ludo=E2=80=99.