From owner-freebsd-questions@FreeBSD.ORG Sun Nov 14 22:32:50 2004 Return-Path: Delivered-To: freebsd-questions@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id CEE4916A4CE for ; Sun, 14 Nov 2004 22:32:50 +0000 (GMT) Received: from obsecurity.dyndns.org (CPE0050040655c8-CM00111ae02aac.cpe.net.cable.rogers.com [69.194.102.143]) by mx1.FreeBSD.org (Postfix) with ESMTP id 98B6C43D2F for ; Sun, 14 Nov 2004 22:32:50 +0000 (GMT) (envelope-from kris@obsecurity.org) Received: by obsecurity.dyndns.org (Postfix, from userid 1000) id D279A5125D; Sun, 14 Nov 2004 14:35:34 -0800 (PST) Date: Sun, 14 Nov 2004 14:35:34 -0800 From: Kris Kennaway To: Danny Browne Message-ID: <20041114223534.GA23118@xor.obsecurity.org> References: <20041114171440.80F3743D45@mx1.FreeBSD.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="opJtzjQTFsWo+cga" Content-Disposition: inline In-Reply-To: <20041114171440.80F3743D45@mx1.FreeBSD.org> User-Agent: Mutt/1.4.2.1i cc: FreeBSD Mailing List Subject: Re: Poor Applictaion Documentation X-BeenThere: freebsd-questions@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: User questions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 14 Nov 2004 22:32:50 -0000 --opJtzjQTFsWo+cga Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sun, Nov 14, 2004 at 05:14:39PM +0000, Danny Browne wrote: > More of a general gripe thatn a question, >=20 > Why are most of the ports for BSD soooo poorly documented. This is someth= ig i was very suprised at. >=20 > I am not looking in the right places? >=20 > For example, try and find some page on the web that will tell what the la= test version of gnome fifth toe, (or power tools or whatever) is and what a= ditional packages it will install. Its impossible, because it's not documen= ted.=20 >=20 > And it's not just gnome alot of the open source UNIX/GNU Linux applicati= ons websites are poorly maintained and info is quite often seriously outdat= ed. >=20 > Feel free to bitch at me if i'm wrong here, but as a relatively new user = this has been my biggest problem. Not the techincal side. Complain to the authors of the software that you feel is poorly documented [1]. Remember that the software in ports isn't developed by the FreeBSD project. Kris [1] They'll probably tell you that they know it's under-documented, and ask for your help in remedying the situation. This is a great way that non-coders can contribute to open source projects. --opJtzjQTFsWo+cga Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.6 (FreeBSD) iD8DBQFBl922Wry0BWjoQKURAtDpAJ9ObdcZAZBuuoseO/OE+zpZCDz78wCfVmps rgGSY9y4lxVa7hhfCAQE51g= =8ren -----END PGP SIGNATURE----- --opJtzjQTFsWo+cga--