From owner-freebsd-doc@FreeBSD.ORG Fri Dec 5 00:07:08 2008 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id D9A2E1065670 for ; Fri, 5 Dec 2008 00:07:08 +0000 (UTC) (envelope-from gabor@FreeBSD.org) Received: from server.mypc.hu (server.mypc.hu [87.229.73.95]) by mx1.freebsd.org (Postfix) with ESMTP id 960208FC0A for ; Fri, 5 Dec 2008 00:07:08 +0000 (UTC) (envelope-from gabor@FreeBSD.org) Received: from localhost (localhost [127.0.0.1]) by server.mypc.hu (Postfix) with ESMTP id B6C1414D7820; Fri, 5 Dec 2008 01:07:07 +0100 (CET) X-Virus-Scanned: amavisd-new at t-hosting.hu Received: from server.mypc.hu ([127.0.0.1]) by localhost (server.mypc.hu [127.0.0.1]) (amavisd-new, port 10024) with LMTP id 5G9kYqSiTE-3; Fri, 5 Dec 2008 01:07:05 +0100 (CET) Received: from [192.168.1.105] (catv-80-98-156-89.catv.broadband.hu [80.98.156.89]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by server.mypc.hu (Postfix) with ESMTPSA id BA40014D7816; Fri, 5 Dec 2008 01:07:05 +0100 (CET) Message-ID: <493870A9.6050604@FreeBSD.org> Date: Fri, 05 Dec 2008 01:07:05 +0100 From: =?ISO-8859-1?Q?G=E1bor_K=F6vesd=E1n?= User-Agent: Thunderbird 2.0.0.18 (Windows/20081105) MIME-Version: 1.0 To: Marc Fonvieille References: <20081201080917.GA1330@gothic.blackend.org> In-Reply-To: <20081201080917.GA1330@gothic.blackend.org> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 8bit Cc: freebsd-doc@FreeBSD.org Subject: Re: [Sort of RFC] Ports and packages for docs X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 05 Dec 2008 00:07:08 -0000 Marc Fonvieille escribió: > Hello, > > Currently, it's difficult for the average user to update his docs. > Most of time, the docs are installed during OS install time and are > never updated. > Another problem is the fact the doc build requires a lot of diskspace > and a lot of time on slow architectures/CPUs/etc which is a problem > during release process. > > To sum up, we're lacking of a simple way to install and update docs > without any compilation operation. Hello Marc, I think it is a very good idea. It can happen that someone can't go online to check the documentation so it would be really useful to have a method to install the docs easily. Thanks for working on this! > > These packages provide html-split version (of course other formats are > possible, I just want to limit the bandwidth) of the 20081130 docset. > Another thing to note, the packages install docs in > /usr/local/share/doc/freebsd > Maybe you could also add an option (like OVERWRITE_BASE or something like that) to install them to the usual /usr/share/doc location. In this way, we could avoid duplication between the base and the ports version and keep using the path we got used to. It is not very smart to install things outside from /usr/local, but I think it can be useful in some cases and this particular is such one. A couple of other ports also do this (like BIND, OpenSSH, etc.). Regards, -- Gabor Kovesdan EMAIL: gabor@FreeBSD.org WWW: http://www.kovesdan.org