From owner-cvs-all Mon Jul 8 12:22:53 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 D8AE837B400; Mon, 8 Jul 2002 12:22:48 -0700 (PDT) Received: from apollo.backplane.com (apollo.backplane.com [216.240.41.2]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8AA0943E42; Mon, 8 Jul 2002 12:22:48 -0700 (PDT) (envelope-from dillon@apollo.backplane.com) Received: from apollo.backplane.com (localhost [127.0.0.1]) by apollo.backplane.com (8.12.5/8.12.4) with ESMTP id g68JMmLA046617; Mon, 8 Jul 2002 12:22:48 -0700 (PDT) (envelope-from dillon@apollo.backplane.com) Received: (from dillon@localhost) by apollo.backplane.com (8.12.5/8.12.4/Submit) id g68JMmGT046616; Mon, 8 Jul 2002 12:22:48 -0700 (PDT) (envelope-from dillon) Date: Mon, 8 Jul 2002 12:22:48 -0700 (PDT) From: Matthew Dillon Message-Id: <200207081922.g68JMmGT046616@apollo.backplane.com> To: Ruslan Ermilov Cc: cvs-committers@FreeBSD.ORG, cvs-all@FreeBSD.ORG Subject: Re: cvs commit: src Makefile References: <200206242013.g5OKD9c05646@freefall.freebsd.org> <20020708085310.GB47134@sunbay.com> <200207081547.g68FloJD000401@apollo.backplane.com> <20020708185112.GA67979@sunbay.com> 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 :> 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. -Matt To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message