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>
index | next in thread | previous in thread | raw e-mail
[-- Attachment #1 --] On Mon, Jul 08, 2002 at 12:22:48PM -0700, Matthew Dillon wrote: > > :> to mention the manual page. > :>=20 > :> I think it's best to document the most important features in the > :> Makefile since it's the first place people will look. > :>=20 > :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, > :--=20 > :Ruslan Ermilov Sysadmin and DBA, > > I consider anything that takes me more then 10 minutes to figure out > to be a documentation issue. Since there is no reason to intentionally > make things more difficult for developers, I try to document those cases > after I've figured out how to use them. > > 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 should > 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. > 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, -- 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 [-- Attachment #2 --] -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.7 (FreeBSD) iD8DBQE9KsPPUkv4P6juNwoRAjWiAJoCJIOE4K1bCkec0HIKLJBdhZD5GwCfZ3kR OjNO/RlQzEZQwG9ztb6YcCk= =RBdj -----END PGP SIGNATURE-----help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020709110655.GA78643>