Date: Tue, 9 Jul 2002 14:06:55 +0300 From: Ruslan Ermilov <ru@FreeBSD.ORG> To: Matthew Dillon <dillon@apollo.backplane.com> Cc: cvs-committers@FreeBSD.ORG, cvs-all@FreeBSD.ORG Subject: Re: cvs commit: src Makefile Message-ID: <20020709110655.GA78643@sunbay.com> In-Reply-To: <200207081922.g68JMmGT046616@apollo.backplane.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>
next in thread | previous in thread | raw e-mail | index | archive | help
--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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020709110655.GA78643>