From owner-freebsd-doc@FreeBSD.ORG Tue Mar 30 12:20:15 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id EF58B16A4CE for ; Tue, 30 Mar 2004 12:20:14 -0800 (PST) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id D163443D2F for ; Tue, 30 Mar 2004 12:20:14 -0800 (PST) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) i2UKKEbv055475 for ; Tue, 30 Mar 2004 12:20:14 -0800 (PST) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.10/8.12.10/Submit) id i2UKKEGM055474; Tue, 30 Mar 2004 12:20:14 -0800 (PST) (envelope-from gnats) Date: Tue, 30 Mar 2004 12:20:14 -0800 (PST) Message-Id: <200403302020.i2UKKEGM055474@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: "Simon L. Nielsen" 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 Reply-To: "Simon L. Nielsen" List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 30 Mar 2004 20:20:15 -0000 The following reply was made to PR docs/64144; it has been noted by GNATS. From: "Simon L. Nielsen" To: Mark Linimon Cc: FreeBSD-gnats-submit@FreeBSD.org, freebsd-doc@FreeBSD.org, eik@FreeBSD.org Subject: Re: docs/64144: [patch] document procedure to add a new ports category to Committer's Guide Date: Tue, 30 Mar 2004 22:12:10 +0200 --OgqxwSJOaUobr8KG Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2004.03.30 12:33:26 -0600, Mark Linimon wrote: > Here is a revised patch that incorporates feedback that I got from > eik@, and my own slightly improved knowledge of both the underlying > problems, and of DocBook. Looks good in general, but a few comments : [CUT] > + > + On your own local system, test the proposed > + changes: first, comment out the > + SUBDIR entries in the old > + ports' categories' Makefiles; > + then, enable building the new category in > + ports/Makefile. > + Run make checksubdirs in the > + affected category directories to check the > + SUBDIR entries. Next, in > + the ports/ directory, run Should be : + the ports/ directory, run [CUT] > + > + Update the instructions for > + cvsup(1) by modifying Here you should use &man.cvsup.1;. > + distrib/cvsup/sup/README > + and adding the following files into > + cvsup/sup/ports-categoryname: > + list.cvs and > + releases. > + > + > + > + Submit a PR to add the new category both to the > + url=3D"../../books/porters-handbook/makefile-categories.html#PORTING-CATE= GORIES"> > + Porter's Handbook and to the file > + www/en/ports/categories, > + and assign it to docs. If the category is set to "docs" there is no need to reassign it. It will automatically be assigned to freebsd-doc. > + > + > + > + Submit a PR to request that the web > + page build be updated to reflect the new > + category. The responsibility for doing this > + is not yet well established. > + Shouldn't this just be a "www" PR? I'm not really sure what needs to be changed on the web pages? Of course the issue with the ports/ pages being based on a INDEX still exist... --=20 Simon L. Nielsen FreeBSD Documentation Team --OgqxwSJOaUobr8KG Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.3 (FreeBSD) iD8DBQFAadSah9pcDSc1mlERAtxyAJ4/iyF6Ijqd7HIChWmqG4O7v1s8jgCfXkr/ yRFadwmFGQsIUEEJQpbZA9w= =6K8P -----END PGP SIGNATURE----- --OgqxwSJOaUobr8KG--