From 5180efcbeba66cdf7f9c7297f78484b16a21d703 Mon Sep 17 00:00:00 2001 From: Mark Linimon Date: Wed, 9 Nov 2005 01:25:27 +0000 Subject: [PATCH] Update the section on creating new categories. Some of the information was redundant with text in the Porter's Handbook. Add text about what portmgr is supposed to do. Provide links to documentation that needs to be changed. Mention the CVSup examples. Reviewed for content by: pav --- .../articles/committers-guide/article.sgml | 84 ++++++++++++------- 1 file changed, 56 insertions(+), 28 deletions(-) diff --git a/en_US.ISO8859-1/articles/committers-guide/article.sgml b/en_US.ISO8859-1/articles/committers-guide/article.sgml index 05d42c209a..173b560d26 100644 --- a/en_US.ISO8859-1/articles/committers-guide/article.sgml +++ b/en_US.ISO8859-1/articles/committers-guide/article.sgml @@ -729,11 +729,11 @@ alias scvs env CVS_RSH=ssh cvs -d user@ncvs.FreeBSD.o You will almost certainly get a conflict because - of the $Id: article.sgml,v 1.229 2005-09-11 08:14:08 joel Exp $ (or in FreeBSD's case, + of the $Id: article.sgml,v 1.230 2005-11-09 01:25:27 linimon Exp $ (or in FreeBSD's case, $FreeBSD$) lines, so you will have to edit the file to resolve the conflict - (remove the marker lines and the second $Id: article.sgml,v 1.229 2005-09-11 08:14:08 joel Exp $ line, - leaving the original $Id: article.sgml,v 1.229 2005-09-11 08:14:08 joel Exp $ line intact). + (remove the marker lines and the second $Id: article.sgml,v 1.230 2005-11-09 01:25:27 linimon Exp $ line, + leaving the original $Id: article.sgml,v 1.230 2005-11-09 01:25:27 linimon Exp $ line intact). @@ -2666,16 +2666,29 @@ docs:Documentation Bug:freebsd-doc: - A developer who wishes to propose a new category - should submit a detailed rationale for the new category, - including why existing categories are not sufficient, - and the list of ports proposed to move. + Please see + + Proposing a New Category in the Porter's Handbook. + Once that procedure has been followed and the PR has been + assigned to &a.portmgr;, it is their decision whether or + not to approve it. If they do, it is their responsibility + to do the following: - Before submitting, keep in mind that there is a fair - amount of work involved from multiple parties; that the - changes affect everyone who wants to keep up-to-date with - the entire ports tree; and that such proposals tend to - attract controversy. + + + Perform any needed repocopies. + + + + Update the VALID_CATEGORIES + definition in ports/Mk/bsd.port.mk. + + + + + Assign the PR back to you. + + @@ -2688,18 +2701,6 @@ docs:Documentation Bug:freebsd-doc: The procedure is a strict superset of the one to repocopy individual ports (see above). - File a PR in GNATS, listing the - reasons for the category request. Preferably, this should - also include patches for Makefiles for - the old ports, the Makefiles for their - old categories, and the VALID_CATEGORIES - definition in ports/Mk/bsd.port.mk. - Assign the PR to the &a.portmgr; (as portmgr). - If they approve it, it will be reassigned to &a.cvsadm; (as - cvs), who will do a repository copy from - the old to the new locations and reassign the PR back to you. - Once everything is done, perform the following steps: - Upgrade each copied port's @@ -2797,14 +2798,41 @@ docs:Documentation Bug:freebsd-doc: cvsup/sup/ports-categoryname: list.cvs and releases. (Note: these are - in the src, not the ports, repository). + in the src, not the ports, repository). If you + are not a src committer, you will need to submit + a PR for this. - Submit a docs PR to add the new category to both the + Update the documentation by modifying the + following: + + + + the - Porter's Handbook and to - www/en/ports/categories. + list of categories in the Porter's Handbook + + + + + www/en/ports/categories. + Note that these are now displayed by sub-groups, + as specified in + www/en/ports/categories.descriptions. + + + + + the section of the Handbook that lists the + + cvsup collections. + + + (Note: these are + in the docs, not the ports, repository). If you + are not a docs committer, you will need to submit + a PR for this.