From owner-freebsd-doc Sun Aug 18 16: 6:35 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 F41C237B400; Sun, 18 Aug 2002 16:06:24 -0700 (PDT) Received: from genius.tao.org.uk (genius.tao.org.uk [212.135.162.51]) by mx1.FreeBSD.org (Postfix) with ESMTP id 25DC643E65; Sun, 18 Aug 2002 16:06:23 -0700 (PDT) (envelope-from joe@genius.tao.org.uk) Received: by genius.tao.org.uk (Postfix, from userid 100) id 952F5420A; Mon, 19 Aug 2002 00:06:18 +0100 (BST) Date: Mon, 19 Aug 2002 00:06:18 +0100 From: Josef Karthauser To: Tony Finch Cc: cvs@freebsd.org, doc@freebsd.org, dwmalone@freebsd.org Subject: Re: CVSROOT documentation patch Message-ID: <20020818230618.GC603@genius.tao.org.uk> References: <20020718163457.D32457@chiark.greenend.org.uk> <20020719202612.B8238@chiark.greenend.org.uk> <20020719204817.C8238@chiark.greenend.org.uk> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="S1BNGpv0yoYahz37" Content-Disposition: inline In-Reply-To: <20020719204817.C8238@chiark.greenend.org.uk> User-Agent: Mutt/1.5.1i 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 --S1BNGpv0yoYahz37 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Fri, Jul 19, 2002 at 08:48:17PM +0100, Tony Finch wrote: > 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. >=20 > Should I commit it myself or leave it to a doc committer? >=20 Please commit this yourself, and feel free to commit to this file as much as you want. Thanks Joe > Tony. > --=20 > f.a.n.finch http://dotat.at/ > NORTH UTSIRE SOUTH UTSIRE: NORTH OR NORTHWEST 3 OR 4, OCCASIONALLY 5. FAI= R. > GOOD. >=20 >=20 > Index: article.sgml > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > RCS file: /home/ncvs/doc/en_US.ISO8859-1/articles/cvs-freebsd/article.sgm= l,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 > > =20 > - $Date$ > - > $FreeBSD: doc/en_US.ISO8859-1/articles/cvs-freebsd/arti= cle.sgml,v 1.5 2002/04/10 12:54:25 kuriyama Exp $ > =20 > > @@ -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 speci= fic > - files. > + directory, apart from the standard ones created by > + cvs init. You should edit this to > + remove some FreeBSD specific files. > > =20 > > @@ -196,18 +195,20 @@ > =20 > > commitcheck - this script is invoked > - directly from CVS. It first check= s 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 tou= ch > - 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-comm= it > + checks. If those are OK, CVS will > + allow the commit to proceed. You should not have to touch th= is > + file. > > =20 > > 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. > > =20 > > @@ -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 > > =20 > > 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. > > =20 > > @@ -252,49 +256,56 @@ > uses this file for editor overrides. FreeBSD does not use th= is > 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. > > =20 > > exclude - this file lists regular > - expressions that are used to determine files which cannot co= ntain a > - revision header. In the FreeBSD setup, all files under revis= ion > - control need to have a revision header (like > - $FreeBSD$). All filenames that match one of th= e lines > - in this file are exempted from this check. You should add > - expressions to this file as you checkin files that cannot ha= ve a > - revision header. For the purpose of installing the scripts, = it > - may be best to exclude CVSROOT/ from he= ader > - checks. > + expressions that are used by commit_prep.pl > + to determine files which cannot contain a revision header. I= n the > + FreeBSD setup, all files under revision control need to have= a > + revision header (like $FreeBSD$). All filename= s that > + match one of the lines in this file are exempted from this c= heck. > + 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. > > =20 > > - log_accum.pl - this is a script that > - takes the log message as provided by the > - logcheck script, and appends it to a lo= g file > - in the repository for backup purposes. It also handles maili= ng out a > - message to an email address you provide (in > - cfg_local.pm). You should not have to t= ouch > - this file. > - > + log_accum.pl - this is a script tha= t takes > + the log message as provided by the logcheck > + script, and appends it to a log file in the repository for b= ackup > + 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. > + > =20 > > logcheck - this file parses the com= mit > log message that committers provide, and attempts to sanitiz= e it > - somewhat. > + somewhat. It hooks into CVS via > + verifymsg. You should not have to touch > + this file. > =20 > This script depends on a local FreeBSD hack of > CVS: this version reads the log m= essage > back in after this script has modified it. The stock version= of > - CVS apparently does not, which wo= uld > - make this script useless. > + CVS does not do this which makes > + logcheck unable to clean up the log mes= sage, > + although it is still able to check that it is syntactically > + OK. > > =20 > > 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. > > =20 > > @@ -315,7 +326,8 @@ > =20 > > options - this file is specific to > - the FreeBSD version of CVS. It co= ntains > + 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 @@ > > =20 > > - rcsinfo - this file maps directorie= s in > - the repository to template files. By default, FreeBSD uses o= ne > - template for the whole repository. You can add others to thi= s file > - if you wish. > + rcsinfo - this file maps directories > + in the repository to template files such as > + rcstemplate. By default, FreeBSD uses o= ne > + template for the whole repository. You can add others to this > + file if you wish. > > =20 > > @@ -345,30 +358,34 @@ > =20 > > taginfo - this file maps tag operat= ions > - on repository directories to access control scripts. You sho= uld not > - have to touch this file. > + on repository directories to access control scripts such as > + tagcheck. You should not have to touch = this > + file. > > =20 > > - unwrap - this script is needed to > + unwrap - this script can be used to > automatically unwrap binary files (see > cvswrappers) on checkout. It is not use= d 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. > > =20 > > verifymsg - this file maps reposito= ry > - directories to post processor scripts of log messages. You s= hould > - 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. > > =20 > > - 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. > > > --=20 "As far as the laws of mathematics refer to reality, they are not certain; and as far as they are certain, they do not refer to reality." - Albert Einstein, 1921 --S1BNGpv0yoYahz37 Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.7 (FreeBSD) iEYEARECAAYFAj1gKGkACgkQXVIcjOaxUBb8UgCfcjtyMv0ZRw80vecIzU57L+Pm /vcAoN7WFbXuPC1NXlZAt+SzK8p7s74a =UtDo -----END PGP SIGNATURE----- --S1BNGpv0yoYahz37-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message