From owner-freebsd-doc@FreeBSD.ORG Fri Dec 5 06:29:26 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 242EE1065672; Fri, 5 Dec 2008 06:29:26 +0000 (UTC) (envelope-from marc@blackend.org) Received: from abigail.blackend.org (ns0.blackend.org [82.227.222.164]) by mx1.freebsd.org (Postfix) with ESMTP id 6FCB68FC18; Fri, 5 Dec 2008 06:29:24 +0000 (UTC) (envelope-from marc@blackend.org) Received: from abigail.blackend.org (localhost [127.0.0.1]) by abigail.blackend.org (8.13.4/8.13.3) with ESMTP id mB56TM07077380; Fri, 5 Dec 2008 07:29:22 +0100 (CET) (envelope-from marc@abigail.blackend.org) Received: (from marc@localhost) by abigail.blackend.org (8.13.4/8.13.3/Submit) id mB56TM4p077379; Fri, 5 Dec 2008 07:29:22 +0100 (CET) (envelope-from marc) Date: Fri, 5 Dec 2008 07:29:22 +0100 From: Marc Fonvieille To: =?iso-8859-1?Q?G=E1bor_K=F6vesd=E1n?= Message-ID: <20081205062922.GA77328@abigail.blackend.org> Mail-Followup-To: =?iso-8859-1?Q?G=E1bor_K=F6vesd=E1n?= , Hiroki Sato , freebsd-doc@FreeBSD.org References: <20081201080917.GA1330@gothic.blackend.org> <493870A9.6050604@FreeBSD.org> <20081205.101257.142333304.hrs@allbsd.org> <493881F7.9020706@FreeBSD.org> Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <493881F7.9020706@FreeBSD.org> X-Useless-Header: blackend.org X-Operating-System: FreeBSD 4.11-STABLE User-Agent: Mutt/1.5.9i Cc: freebsd-doc@FreeBSD.org, Hiroki Sato 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 06:29:26 -0000 On Fri, Dec 05, 2008 at 02:20:55AM +0100, Gábor Kövesdán wrote: > Hiroki Sato escribió: > >Gábor Kövesdán wrote > > in <493870A9.6050604@FreeBSD.org>: > > > >ga> Marc Fonvieille escribió: > >ga> > These packages provide html-split version (of course other formats > >are > >ga> > possible, I just want to limit the bandwidth) of the 20081130 docset. > >ga> > Another thing to note, the packages install docs in > >ga> > /usr/local/share/doc/freebsd > >ga> > > >ga> Maybe you could also add an option (like OVERWRITE_BASE or something > >ga> like that) to install them to the usual /usr/share/doc location. In > >ga> this way, we could avoid duplication between the base and the ports > >ga> version and keep using the path we got used to. It is not very smart > >ga> to install things outside from /usr/local, but I think it can be > >ga> useful in some cases and this particular is such one. A couple of > >ga> other ports also do this (like BIND, OpenSSH, etc.). > > > > You have a point, but I prefer eliminating our documentation set from > > /usr/share/doc and make the doc set can be installed from the > > pre-compiled packages, not tarball which uses /usr/share/doc, like > > Xorg to avoid such duplication in the future releases. > > > Yes, that seems even better. I agree with your idea. Although it > wouldn't be nice to leave any installed system without documentation if > it is not explicitly intended by the user. Maybe doc packages should be > installed automatically during the installation just like Perl? > We plan to have a selection menu for the docs with en_US language selected by default and the possibility to add more languages, a bit like it was the case for Xorg. -- Marc