From owner-cvs-all Tue Jul 9 4: 7:24 2002 Delivered-To: cvs-all@freebsd.org Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 2F4D137B400; Tue, 9 Jul 2002 04:07:19 -0700 (PDT) Received: from whale.sunbay.crimea.ua (whale.sunbay.crimea.ua [212.110.138.65]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4A3D543E42; Tue, 9 Jul 2002 04:07:14 -0700 (PDT) (envelope-from ru@whale.sunbay.crimea.ua) Received: (from ru@localhost) by whale.sunbay.crimea.ua (8.11.6/8.11.2) id g69B6t379388; Tue, 9 Jul 2002 14:06:55 +0300 (EEST) (envelope-from ru) Date: Tue, 9 Jul 2002 14:06:55 +0300 From: Ruslan Ermilov To: Matthew Dillon Cc: cvs-committers@FreeBSD.ORG, cvs-all@FreeBSD.ORG Subject: Re: cvs commit: src Makefile Message-ID: <20020709110655.GA78643@sunbay.com> References: <200206242013.g5OKD9c05646@freefall.freebsd.org> <20020708085310.GB47134@sunbay.com> <200207081547.g68FloJD000401@apollo.backplane.com> <20020708185112.GA67979@sunbay.com> <200207081922.g68JMmGT046616@apollo.backplane.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="vkogqOf2sHV7VnPd" Content-Disposition: inline In-Reply-To: <200207081922.g68JMmGT046616@apollo.backplane.com> User-Agent: Mutt/1.3.99i Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG --vkogqOf2sHV7VnPd Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Mon, Jul 08, 2002 at 12:22:48PM -0700, Matthew Dillon wrote: >=20 > :> to mention the manual page. > :>=3D20 > :> I think it's best to document the most important features in the > :> Makefile since it's the first place people will look. > :>=3D20 > :Why you think that TARGET_ARCH is so important? Most users do not > :need it. I personally would prefer it if src/Makefile would just > :refer to the build(7) manpage. > : > : > :Cheers, > :--=3D20 > :Ruslan Ermilov Sysadmin and DBA, >=20 > I consider anything that takes me more then 10 minutes to figure out > to be a documentation issue. Since there is no reason to intentional= ly > make things more difficult for developers, I try to document those ca= ses > after I've figured out how to use them. >=20 > A major goal of the project is to make things as easy as possible for > developers and users. I do not see it written anywhere that we shou= ld > only document the lowest-common-denominator set of things we think > user will use. I see no reason to intentionally obscure this feature > especially if we want to promote non-i386 architectures. >=20 This is all understandable and appreciated, I just consider the duplication of information (like in this case) a harm; this is an almost guaranteed way to get things not in sync at some point (like in this case). Cheers, --=20 Ruslan Ermilov Sysadmin and DBA, ru@sunbay.com Sunbay Software AG, ru@FreeBSD.org FreeBSD committer, +380.652.512.251 Simferopol, Ukraine http://www.FreeBSD.org The Power To Serve http://www.oracle.com Enabling The Information Age --vkogqOf2sHV7VnPd Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.7 (FreeBSD) iD8DBQE9KsPPUkv4P6juNwoRAjWiAJoCJIOE4K1bCkec0HIKLJBdhZD5GwCfZ3kR OjNO/RlQzEZQwG9ztb6YcCk= =RBdj -----END PGP SIGNATURE----- --vkogqOf2sHV7VnPd-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message