From owner-freebsd-doc Mon Nov 26 4:35:20 2001 Delivered-To: freebsd-doc@freebsd.org Received: from blueyonder.co.uk (pcow028o.blueyonder.co.uk [195.188.53.124]) by hub.freebsd.org (Postfix) with ESMTP id 2FAB537B428; Mon, 26 Nov 2001 04:35:12 -0800 (PST) Received: from pcow028m.blueyonder.net ([127.0.0.1]) by blueyonder.co.uk with Microsoft SMTPSVC(5.5.1877.687.68); Mon, 26 Nov 2001 12:35:11 +0000 Received: from fluoxetine.lan (unverified) by pcow028m.blueyonder.net (Content Technologies SMTPRS 4.2.5) with ESMTP id ; Mon, 26 Nov 2001 12:35:10 +0000 Date: Mon, 26 Nov 2001 12:37:17 +0000 (GMT) From: Andrew McKay X-Sender: andy@fluoxetine.lan To: Cyrille Lefevre Cc: Nik Clayton , Murray Stokely , Mike Harding , freebsd-doc@freebsd.org Subject: Re: empty index.html in /usr/www? In-Reply-To: <008401c17621$d57fb7c0$91e5c6d4@cybercable.fr> Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org On Mon, 26 Nov 2001, Cyrille Lefevre wrote: CL> not sure it is really needed to refer it since libxslt is probably CL> required by some other package referenced. libxslt is installed by the /textproc/docproj meta-port. If people use this port then there is no need for them to do anything else. If, as happened to me some months ago, the installation of the meta-port fails then people will do one of three things: 1) refer to the Makefile to see what they actually need to install Obviously if someone knows what they are doing with regards troubleshooting port installation this is the logical choice. This does not apply to everyone. 2) they will refer to the docs which told them to install it Again, a logical choice. This is what I did when my installation failed (some months ago, before XSL was even mentioned) and it worked fine. 3) they will give up An annoying percentage of people fall into this latter category and there's actually nothing that can be done about it. libxslt has been required for website builds since August and is not a dependency for any of the other required ports. The people in group 1 will know this and install it when they view the Makefile. The people in group 2 will not know this because it is not documented. Documentation builds will not be affected but website builds will fail. Clearly this is not likely to affect a great number of people. To have the docproj meta-port fail, to install it according to the docs, and to want to build the website will hopefully apply to very few people. That doesn't change the fact that the documentation is out of date. Out of date documentation is only slightly more useful than no documentation at all. So that is my view as to why it is indeed necessary to add libxslt to the FDP primer documentation. As I said I am willing to write this up and submit it (once the apparent problem with requiring a certain version of libxslt is sorted out, of course) if no one else wishes to do this. Andy -- Andrew McKay To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message