From owner-freebsd-doc Fri Jul 19 12:48:29 2002 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 BD05B37B400; Fri, 19 Jul 2002 12:48:20 -0700 (PDT) Received: from chiark.greenend.org.uk (chiark.greenend.org.uk [212.135.138.206]) by mx1.FreeBSD.org (Postfix) with ESMTP id 5E80443E42; Fri, 19 Jul 2002 12:48:19 -0700 (PDT) (envelope-from fanf@chiark.greenend.org.uk) Received: from fanf by chiark.greenend.org.uk with local (Exim 3.12 #1) id 17Vdjd-0005RY-00 (Debian); Fri, 19 Jul 2002 20:48:17 +0100 Date: Fri, 19 Jul 2002 20:48:17 +0100 From: Tony Finch To: cvs@freebsd.org, doc@freebsd.org Cc: dot@dotat.at, dwmalone@freebsd.org Subject: CVSROOT documentation patch Message-ID: <20020719204817.C8238@chiark.greenend.org.uk> References: <20020718163457.D32457@chiark.greenend.org.uk> <20020719202612.B8238@chiark.greenend.org.uk> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <20020719202612.B8238@chiark.greenend.org.uk>; from dot@dotat.at on Fri, Jul 19, 2002 at 08:26:12PM +0100 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org This is an update to the CVSROOT documentation. It removes an unexpanded $Date$ keyword, adds more crossreferences between the various CVSROOT files, adds notes about unused functionality that's broken with remote commits, and explains some compatibility issues related to local FreeBSD CVS hacks in more detail. Should I commit it myself or leave it to a doc committer? Tony. -- f.a.n.finch http://dotat.at/ NORTH UTSIRE SOUTH UTSIRE: NORTH OR NORTHWEST 3 OR 4, OCCASIONALLY 5. FAIR. GOOD. Index: article.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/articles/cvs-freebsd/article.sgml,v retrieving revision 1.5 diff -u -r1.5 article.sgml --- article.sgml 10 Apr 2002 12:54:25 -0000 1.5 +++ article.sgml 19 Jul 2002 19:36:21 -0000 @@ -22,8 +22,6 @@ Stijn Hoop - $Date$ - $FreeBSD: doc/en_US.ISO8859-1/articles/cvs-freebsd/article.sgml,v 1.5 2002/04/10 12:54:25 kuriyama Exp $ @@ -183,8 +181,9 @@ checkoutlist - this files lists all files under control of CVS in this - directory. You should edit this to remove some FreeBSD specific - files. + directory, apart from the standard ones created by + cvs init. You should edit this to + remove some FreeBSD specific files. @@ -196,18 +195,20 @@ commitcheck - this script is invoked - directly from CVS. It first checks if - the committer has access to the specified part of the tree, and - then runs commit_prep.pl for the various - pre-commit checks. If those are OK, CVS - will allow the commit to proceed. You should not have to touch - this file. + directly from CVS. It first checks + if the committer has access to the specified part of the tree + using cvs_acls.pl, and then runs + commit_prep.pl for the various pre-commit + checks. If those are OK, CVS will + allow the commit to proceed. You should not have to touch this + file. commitinfo - this file is used by CVS to determine which script to run - before a commit. You should not have to touch this file. + before a commit—in this case commitcheck. + You should not have to touch this file. @@ -238,13 +239,16 @@ CVS to enable or disable keyword expansion, or whether a file should be considered binary. You can edit this as you wish. More information about this file - is available in the CVS manual. + is available in the CVS manual. + Note that the -t and -f + options don't work correctly with client/server + CVS edithook - this file is not used - any more, but kept for historic reasons. You should not have to - touch this file. + any more, but kept for historic reasons. You can safely + remove this file. @@ -252,49 +256,56 @@ uses this file for editor overrides. FreeBSD does not use this functionality, as parsing the log message is done in the verifymsg and logcheck - files. You should not have to touch this file. + files. This is because the editinfo + functionality doesn't work properly with remote commits, or ones + that use the -m or -F + options. You should not have to touch this file. exclude - this file lists regular - expressions that are used to determine files which cannot contain a - revision header. In the FreeBSD setup, all files under revision - control need to have a revision header (like - $FreeBSD$). All filenames that match one of the lines - in this file are exempted from this check. You should add - expressions to this file as you checkin files that cannot have a - revision header. For the purpose of installing the scripts, it - may be best to exclude CVSROOT/ from header - checks. + expressions that are used by commit_prep.pl + to determine files which cannot contain a revision header. In the + FreeBSD setup, all files under revision control need to have a + revision header (like $FreeBSD$). All filenames that + match one of the lines in this file are exempted from this check. + You should add expressions to this file as you checkin files that + cannot have a revision header. For the purpose of installing the + scripts, it may be best to exclude CVSROOT/ + from header checks. - log_accum.pl - this is a script that - takes the log message as provided by the - logcheck script, and appends it to a log file - in the repository for backup purposes. It also handles mailing out a - message to an email address you provide (in - cfg_local.pm). You should not have to touch - this file. - + log_accum.pl - this is a script that takes + the log message as provided by the logcheck + script, and appends it to a log file in the repository for backup + purposes. It also handles mailing out a message to an email address + you provide (in cfg_local.pm). It hooks into + CVS via loginfo. + You should not have to touch this file. + logcheck - this file parses the commit log message that committers provide, and attempts to sanitize it - somewhat. + somewhat. It hooks into CVS via + verifymsg. You should not have to touch + this file. This script depends on a local FreeBSD hack of CVS: this version reads the log message back in after this script has modified it. The stock version of - CVS apparently does not, which would - make this script useless. + CVS does not do this which makes + logcheck unable to clean up the log message, + although it is still able to check that it is syntactically + OK. loginfo - this file is used by CVS to control where log - information is sent. You should not have to touch this - file. + information is sent; log_accum.pl hooks + in here. You should not have to touch this file. @@ -315,7 +326,8 @@ options - this file is specific to - the FreeBSD version of CVS. It contains + the FreeBSD version of CVS, and is + also supported by the Debian version. It contains the keyword to expand in revision headers. You should alter this to match the keyword you specified in cfg_local.pm (if you use that feature, which @@ -323,10 +335,11 @@ - rcsinfo - this file maps directories in - the repository to template files. By default, FreeBSD uses one - template for the whole repository. You can add others to this file - if you wish. + rcsinfo - this file maps directories + in the repository to template files such as + rcstemplate. By default, FreeBSD uses one + template for the whole repository. You can add others to this + file if you wish. @@ -345,30 +358,34 @@ taginfo - this file maps tag operations - on repository directories to access control scripts. You should not - have to touch this file. + on repository directories to access control scripts such as + tagcheck. You should not have to touch this + file. - unwrap - this script is needed to + unwrap - this script can be used to automatically unwrap binary files (see cvswrappers) on checkout. It is not used in the - current FreeBSD setup. You should not have to touch this - file. + current FreeBSD setup because the functionality it hooks into + doesn't work well with remote commits. You should not have to + touch this file. verifymsg - this file maps repository - directories to post processor scripts of log messages. You should - not have to touch this file. + directories to post processor scripts of log messages such as + logcheck. You should not have to touch + this file. - wrap - this script is needed to + wrap - this script can be used to automatically wrap binary files (see cvswrappers) on checkin. It is not used in the - current FreeBSD setup. You should not have to touch this - file. + current FreeBSD setup because the functionality it hooks into + doesn't work well with remote commits. You should not have to + touch this file. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message