From owner-freebsd-doc@FreeBSD.ORG Thu Apr 1 17:40:14 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id B95DA16A4CE; Thu, 1 Apr 2004 17:40:14 -0800 (PST) Received: from shaft.techsupport.co.uk (shaft.techsupport.co.uk [212.250.77.214]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2466D43D1D; Thu, 1 Apr 2004 17:40:14 -0800 (PST) (envelope-from setantae@submonkey.net) Received: from cpc2-cdif3-6-0-cust204.cdif.cable.ntl.com ([81.103.67.204] helo=shrike.submonkey.net ident=mailnull) by shaft.techsupport.co.uk with esmtp (TLSv1:DHE-RSA-AES256-SHA:256) (Exim 4.30; FreeBSD) id 1B9DfI-0008mq-Ng; Fri, 02 Apr 2004 02:40:12 +0100 Received: from setantae by shrike.submonkey.net with local (Exim 4.30; FreeBSD) id 1B9DfF-000KIH-Mn; Fri, 02 Apr 2004 02:40:09 +0100 Date: Fri, 2 Apr 2004 02:40:09 +0100 From: Ceri Davies To: Mark Linimon Message-ID: <20040402014009.GK771@submonkey.net> Mail-Followup-To: Ceri Davies , Mark Linimon , FreeBSD-gnats-submit@FreeBSD.org, freebsd-doc@FreeBSD.org, Oliver Eikemeier References: <200404011413.51013.linimon@lonesome.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="5FDiZl1vRbLRjwwc" Content-Disposition: inline In-Reply-To: <200404011413.51013.linimon@lonesome.com> X-PGP: finger ceri@FreeBSD.org User-Agent: Mutt/1.5.4i Sender: Ceri Davies cc: freebsd-doc@FreeBSD.org cc: FreeBSD-gnats-submit@FreeBSD.org cc: Oliver Eikemeier Subject: Re: docs/64144: [patch] document procedure to add a new ports category to Committer's Guide X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 02 Apr 2004 01:40:15 -0000 --5FDiZl1vRbLRjwwc Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Thu, Apr 01, 2004 at 02:13:51PM -0600, Mark Linimon wrote: > Here is an updated (hopefully final) version of the patch. It is still > vague on the detail of getting http://www.FreeBSD.org/ports/ updated, > but since that seems to be still under discussion, IMHO we should > go ahead and commit what's here and update that detail once that > discussion is resolved. I'm happy for you to commit this, on the proviso that this comma goes away: > + Assign the PR to the &a.portmgr; (as portmgr). > + If they approve it, it will be reassigned to &a.cvs; (as > + cvs), who will do a repository copy from > + the old to the new locations, and reassign the PR back to you. ^^^ And that this becomes a real word: > + Run a make describe. Since > + the top-level make index that > + you will be running in a few steps is an interation ^^^^^^^^^^ > + of make describe over the entire > + ports hierarchy, catching any errors here will > + save you having to re-run that step later on. Not sure about this apostrophe either. Do the right thing (which may be to leave it, it's 2.30 am here): > + On your own local system, test the proposed > + changes: first, comment out the > + SUBDIR entries in the old > + ports' categories' Makefiles; ^^^ I don't like this comma either: > + then, enable building the new category in ^^^ > + ports/Makefile. Think this semicolon should go: > + Once this is done, you can commit the > + updated ports/Makefile to > + connect the new category to the build; and also ^^^ > + commit the Makefile changes > + for the old category or categories. The new > + category's pkg/COMMENT > + can be committed, too. It may or may not be worth mentioning that distrib/ lives in the src repository. > + Update the instructions for &man.cvsup.1; by > + modifying distrib/cvsup/sup/README > + and adding the following files into > + cvsup/sup/ports-categoryname: > + list.cvs and > + releases. s/both to/to both/ perhaps? > + Submit a docs PR to add the new category both to the > + url=3D"../../books/porters-handbook/makefile-categories.html#PORTING-CATE= GORIES"> The FDP says get rid of "the file" below (grep for "Avoid redundant phrases"): > + Porter's Handbook and to the file > + www/en/ports/categories. Ceri --=20 --5FDiZl1vRbLRjwwc Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFAbMR5ocfcwTS3JF8RAiHhAJ9eFqo1mvLgMm4PYxgE9Jb6nC6GPACgvyxA YOtm1EO92FiEISmZl5y3zNg= =KYIZ -----END PGP SIGNATURE----- --5FDiZl1vRbLRjwwc--