From owner-p4-projects@FreeBSD.ORG Fri Mar 27 23:12:00 2009 Return-Path: Delivered-To: p4-projects@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 32767) id 8784510656D5; Fri, 27 Mar 2009 23:11:58 +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 312C810656CC for ; Fri, 27 Mar 2009 23:11:58 +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 07E478FC28 for ; Fri, 27 Mar 2009 23:11:58 +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 n2RNBvC4093890 for ; Fri, 27 Mar 2009 23:11:57 GMT (envelope-from rene@FreeBSD.org) Received: (from perforce@localhost) by repoman.freebsd.org (8.14.3/8.14.3/Submit) id n2RNBvDf093888 for perforce@freebsd.org; Fri, 27 Mar 2009 23:11:57 GMT (envelope-from rene@FreeBSD.org) Date: Fri, 27 Mar 2009 23:11:57 GMT Message-Id: <200903272311.n2RNBvDf093888@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 159936 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: Fri, 27 Mar 2009 23:12:02 -0000 http://perforce.freebsd.org/chv.cgi?CH=159936 Change 159936 by rene@rene_self on 2009/03/27 23:11:35 Replace all instances of "VCS" by a description in natural English. Submitted by: pgj Affected files ... .. //depot/projects/docproj_nl/en_US.ISO8859-1/articles/committers-guide/article.sgml#21 edit Differences ... ==== //depot/projects/docproj_nl/en_US.ISO8859-1/articles/committers-guide/article.sgml#21 (text+ko) ==== @@ -240,15 +240,13 @@ It is assumed that you are already familiar with the basic operation 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. + CVS, but as of June 2008, Subversion is used for the src tree. 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 unfortunate abuse of VCS by a committer. + cleanup or fixing some unfortunate abuse of the version control system by a committer. Should you cause some repository accident, say a bad - import or tag creation, mail the + import or a bad tag creation, 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 tree—not @@ -352,9 +350,7 @@ 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, - cvs import should be used. + to the official CVS tree. Refer to the &man.cvs.1; manual page for usage. @@ -385,7 +381,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 a VCS gives to the project. + value the change history that a version control system gives to the project. CVS reference information, tutorials, and FAQs can be found at: . @@ -447,14 +443,15 @@ &prompt.user; cvs co Tools You now have a directory named ports/Tools - with subdirectories portbuild, scripts, and CVS. + with subdirectories portbuild, + scripts, and + CVS. Check out the same files, but with full path: - &prompt.user; cvs co ports/Tools - + &prompt.user; cvs co ports/Tools You now have a directory named ports, with subdirectories CVS and Tools. The ports/Tools directory has @@ -904,15 +901,14 @@ - review your diffs, using - vcs diff + review your diffs, using the diff command of the version control system. 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 - vcs commit - without any arguments will commit every modification in your + than the ones you intended — a commit operation + without any arguments usually will commit every modification in your current working directory and every subdirectory. @@ -1289,7 +1285,7 @@ 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 vcs log + be, it may help to scan the revision history 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 @@ -1306,7 +1302,7 @@ 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 VCS we + again until the matter is settled. Remember – with a version control system we can always change it back. Do not impugn the intentions of someone you disagree with. @@ -1584,7 +1580,7 @@ &a.committers; - repository-committers is the entity that VCS uses to send you all your + repository-committers is the entity that the version control system 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. @@ -1970,7 +1966,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 VCS logs for the file(s) in + you can also look at the repository logs for the file(s) in question and see if someone has been working recently or predominantly in that area. @@ -1992,7 +1988,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 VCS makes it unnecessary to have an ongoing + course) but a version control system 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 @@ -2222,7 +2218,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 vcs diff, which can hide + change when asking for differences between revisions, 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 @@ -3196,7 +3192,7 @@ and dedication in working on Problem Reports. Almost all of this document will apply to these developers as - well (except things specific to VCS commits and the mailing list + well (except things specific to commits and the mailing list memberships that go with them). In particular, we recommend that you read: @@ -3314,13 +3310,13 @@ - How do I add a new file to a VCS branch? + How do I add a new file to a 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 - vcs add as you normally would. This works + the add operation as you normally would. This works fine for the doc and ports trees. The src tree uses SVN and requires more care because of the