From owner-p4-projects@FreeBSD.ORG Wed Jan 21 21:12:24 2009 Return-Path: Delivered-To: p4-projects@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 32767) id 824221065672; Wed, 21 Jan 2009 21:12:24 +0000 (UTC) Delivered-To: perforce@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 42615106566B for ; Wed, 21 Jan 2009 21:12:24 +0000 (UTC) (envelope-from rene@FreeBSD.org) Received: from repoman.freebsd.org (repoman.freebsd.org [IPv6:2001:4f8:fff6::29]) by mx1.freebsd.org (Postfix) with ESMTP id 3039A8FC0C for ; Wed, 21 Jan 2009 21:12:24 +0000 (UTC) (envelope-from rene@FreeBSD.org) Received: from repoman.freebsd.org (localhost [127.0.0.1]) by repoman.freebsd.org (8.14.3/8.14.3) with ESMTP id n0LLCOKA077249 for ; Wed, 21 Jan 2009 21:12:24 GMT (envelope-from rene@FreeBSD.org) Received: (from perforce@localhost) by repoman.freebsd.org (8.14.3/8.14.3/Submit) id n0LLCOtu077247 for perforce@freebsd.org; Wed, 21 Jan 2009 21:12:24 GMT (envelope-from rene@FreeBSD.org) Date: Wed, 21 Jan 2009 21:12:24 GMT Message-Id: <200901212112.n0LLCOtu077247@repoman.freebsd.org> X-Authentication-Warning: repoman.freebsd.org: perforce set sender to rene@FreeBSD.org using -f From: Rene Ladan To: Perforce Change Reviews Cc: Subject: PERFORCE change 156500 for review X-BeenThere: p4-projects@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: p4 projects tree changes List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 21 Jan 2009 21:12:25 -0000 http://perforce.freebsd.org/chv.cgi?CH=156500 Change 156500 by rene@rene_self on 2009/01/21 21:12:09 committers-guide: phase 1 of converting CVS to CVS + SVN * comment out CVS commands specific to src, they are to be replaced by their SVN equivalents. src committers welcome to review. * Don't mention ncvs as a commit host anymore, modifying ncvs is strictly forbidden since SVN. * Mention that src converted to SVN in June 2008. * Mention that the SVN repository is automatically exported for CVSup * use 'VCS' (Version Control System) or nothing at all for texts where CVS was used generically. * Mention the SVN equivalents of the Noteworthy CVS tags * No more RELENG_5, change some RELENG_6 to stable/7 * No need for 'vcs status' except for the src tree * Add 2009. Maybe &a.cvsadm; should be changed, it now expands to "CVS Repository Meisters" While here, fix a language nit. Affected files ... .. //depot/projects/docproj_nl/en_US.ISO8859-1/articles/committers-guide/article.sgml#15 edit Differences ... ==== //depot/projects/docproj_nl/en_US.ISO8859-1/articles/committers-guide/article.sgml#15 (text+ko) ==== @@ -26,6 +26,7 @@ 2006 2007 2008 + 2009 The FreeBSD Documentation Project @@ -75,7 +76,7 @@ Main CVSROOT - ncvs.FreeBSD.org:/home/ncvs (although also see ). + ncvs.FreeBSD.org:/home/ncvs (although also see ). @@ -115,11 +116,16 @@ Noteworthy CVS Tags - RELENG_5 (5.X-STABLE), + RELENG_6 (6.X-STABLE), RELENG_7 (7.X-STABLE), HEAD (-CURRENT) + + These tags correspond to the SVN tags + stable/6, stable/7, + and head respectively. + @@ -140,7 +146,7 @@ Commit Bit Types - The FreeBSD CVS repository has a number of components which, + The FreeBSD repository has a number of components which, when combined, support the basic operating system source, documentation, third party application ports infrastructure, and various maintained utilities. When FreeBSD commit bits are @@ -228,20 +234,23 @@ - - CVS Operations + + Version Control System Operations It is assumed that you are already familiar with the basic operation - of CVS. + of the version control systems in use. Traditionally this was + CVS, but as of June 2008 Subversion is used for the src tree. The + generic term VCS (or none at all) will be used + unless the text is specific to CVS or SVN. - The &a.cvsadm; are the owners of the CVS repository and + The &a.cvsadm; are the owners of the repository and are responsible for direct modification of it for the purposes of - cleanup or fixing some grievous abuse of CVS by a committer. - Should you cause some repository accident, say a bad cvs - import or cvs tag operation, mail the + cleanup or fixing some grievous abuse of VCS by a committer. + Should you cause some repository accident, say a bad vcs + import or vcs tag operation, mail the responsible part of &a.cvsadm;, as stated in the table below, (or call one of them) and report the problem. - For very important issues affecting the entire CVS tree—not + For very important issues affecting the entire tree—not just a specific area—you can contact the &a.cvsadm;. Please do not contact the &a.cvsadm; for repocopies or other things that the more specific teams can handle. @@ -251,16 +260,12 @@ no login shells available on the repository machines, except to the repomeisters. - Depending on the affected area of the CVS repository, + Depending on the affected area of the repository, you should send your request for a repocopy to one of the following email addresses. Email sent to these addresses will be forwarded to the appropriate repomeisters. - ncvs@ - regarding - /home/ncvs, the src - repository - pcvs@ - regarding /home/pcvs, the ports repository @@ -275,11 +280,13 @@ - The CVS tree is currently split into four distinct repositories, + The tree is currently split into four distinct repositories, namely doc, ports, projects and src. These are combined under a single CVSROOT when distributed - via CVSup for the convenience of our users. + via CVSup for the convenience of our users. + The src tree is automatically exported to + CVSup. Note that the www module containing sources for the FreeBSD website is @@ -323,12 +330,6 @@ projcvs.FreeBSD.org /home/projcvs - - - src - ncvs.FreeBSD.org - /home/ncvs - @@ -336,7 +337,7 @@ CVS operations are done remotely by setting the CVSROOT environment variable to the appropriate host and top-level directory (for example, - ncvs.FreeBSD.org:/home/ncvs), + dcvs.FreeBSD.org:/home/dcvs), and doing the appropriate check-out/check-in operations. Many committers define aliases which expand to the correct cvs @@ -346,14 +347,13 @@ alias dcvs cvs -d user@dcvs.FreeBSD.org:/home/dcvs alias pcvs cvs -d user@pcvs.FreeBSD.org:/home/pcvs -alias projcvs cvs -d user@projcvs.FreeBSD.org:/home/projcvs -alias scvs cvs -d user@ncvs.FreeBSD.org:/home/ncvs +alias projcvs cvs -d user@projcvs.FreeBSD.org:/home/projcvs This way they can do all CVS operations locally and use Xcvs commit for committing to the official CVS tree. If you wish to add - something which is wholly new (like contrib-ified - sources, etc), cvs import should be used. + something which is wholly new + cvs import should be used. Refer to the &man.cvs.1; manual page for usage. @@ -384,7 +384,7 @@ to their new name and/or location and let you know when it is done. The purpose of a repository copy is to preserve file change history, or logs. We in the FreeBSD Project greatly - value the change history that CVS gives to the project. + value the change history that a VCS gives to the project. CVS reference information, tutorials, and FAQs can be found at: . @@ -438,6 +438,7 @@ Practical FreeBSD examples: + Note that cvs stores metadata in subdirectories named CVS. @@ -597,7 +598,7 @@ This updates the file shazam or the contents of the shazam directory to the latest version along the branch you checked out. If you - checked out a point in time, does nothing + checked out a point in time, it does nothing unless the tags have moved in the repository or some other weird stuff is going on. @@ -616,11 +617,12 @@ Update to head of main branch. - + @@ -722,6 +724,7 @@ > signs and the revision number you updated to. +FreeBSD$) + $FreeBSD$) lines, so you will have to edit the file to resolve the conflict (remove the marker lines and the second $Id$ line, leaving the original $Id$ line intact). +--> @@ -941,7 +945,8 @@ verify which branch you are committing to, using - cvs status. + svn status. This is only needed for + the src tree, as the other trees are not branched. @@ -952,7 +957,7 @@ Also, ALWAYS specify which files to commit explicitly on the command line, so you do not accidentally commit other files - than the ones you intended - cvs commit + than the ones you intended - vcs commit without any arguments will commit every modification in your current working directory and every subdirectory. @@ -1058,9 +1063,7 @@ ssh connection to the repository machine. First, put this configuration into your ~/.ssh/config: - Host ncvs.FreeBSD.org - ControlPath /home/user/.ssh/cvs.cpath -Host dcvs.FreeBSD.org + Host dcvs.FreeBSD.org ControlPath /home/user/.ssh/cvs.cpath Host projcvs.FreeBSD.org ControlPath /home/user/.ssh/cvs.cpath @@ -1325,14 +1328,14 @@ areas, to our shame), the same applies. If, however, you are about to modify something which is clearly being actively maintained by someone else (and it is only by watching the - cvs-committers mailing list that you can + repository-committers mailing list that you can really get a feel for just what is and is not) then consider sending the change to them instead, just as you would have before becoming a committer. For ports, you should contact the listed MAINTAINER in the Makefile. For other parts of the repository, if you are unsure who the active maintainer might - be, it may help to scan the output of cvs log + be, it may help to scan the output of vcs log to see who has committed changes in the past. &a.fenner; has written a nice shell script that can help determine who the active maintainer might be. It lists each person who has @@ -1346,10 +1349,10 @@ If you are unsure about a commit for any reason at all, have it reviewed by -hackers before committing. Better to have it flamed then and there - rather than when it is part of the CVS repository. If you do + rather than when it is part of the repository. If you do happen to commit something which results in controversy erupting, you may also wish to consider backing the change out - again until the matter is settled. Remember – with CVS we + again until the matter is settled. Remember – with VCS we can always change it back. Do not impugn the intentions of someone you disagree with. @@ -1627,7 +1630,7 @@ &a.committers; - cvs-committers is the entity that CVS uses to send you all your + repository-committers is the entity that VCS uses to send you all your commit messages. You should never send email directly to this list. You should only send replies to this list when they are short and are directly related to a commit. @@ -1976,7 +1979,7 @@ Discuss any significant change before committing. - The CVS repository is not where changes should be + The VCS repository is not where changes should be initially submitted for correctness or argued over, that should happen first in the mailing lists and the commit should only happen once something resembling consensus has @@ -2013,7 +2016,7 @@ maintainer need to be reviewed by at least one other maintainer. In cases where the maintainer-ship of something is not clear, - you can also look at the CVS logs for the file(s) in + you can also look at the VCS logs for the file(s) in question and see if someone has been working recently or predominantly in that area. @@ -2035,7 +2038,7 @@ This may be hard to swallow in times of conflict (when each side is convinced that they are in the right, of - course) but CVS makes it unnecessary to have an ongoing + course) but VCS makes it unnecessary to have an ongoing dispute raging when it is far easier to simply reverse the disputed change, get everyone calmed down again and then try to figure out what is the best way to proceed. If the change @@ -2265,7 +2268,7 @@ Do not mix style fixes with new functionality. A style fix is any change which does not modify the functionality of the code. Mixing the changes obfuscates the functionality - change when using cvs diff, which can hide + change when using vcs diff, which can hide any new bugs. Do not include whitespace changes with content changes in commits to doc/ or www/. The extra clutter in the diffs @@ -3239,7 +3242,7 @@ and dedication in working on Problem Reports. Almost all of this document will apply to these developers as - well (except things specific to CVS commits and the mailing list + well (except things specific to VCS commits and the mailing list memberships that go with them). In particular, we recommend that you read: @@ -3357,18 +3360,19 @@ - How do I add a new file to a CVS branch? + How do I add a new file to a VCS branch? To add a file onto a branch, simply checkout or update to the branch you want to add to and then add the file using - cvs add as you normally would. For + vcs add as you normally would. For example, if you wanted to MFC the file - src/sys/alpha/include/smp.h from HEAD - to RELENG_6 and it does not exist in RELENG_6 yet, you would + src/sys/alpha/include/smp.h from head + to stable/7 and it does not exist in stable/7 yet, you would use the following steps: +