From owner-freebsd-doc@FreeBSD.ORG Mon Oct 20 09:16:11 2003 Return-Path: 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 DA6C516A4BF; Mon, 20 Oct 2003 09:16:11 -0700 (PDT) Received: from eth0.b.smtp.sonic.net (eth0.b.smtp.sonic.net [64.142.19.4]) by mx1.FreeBSD.org (Postfix) with ESMTP id 54FCB43F85; Mon, 20 Oct 2003 09:16:07 -0700 (PDT) (envelope-from bmah@intruder.kitchenlab.org) Received: from intruder.kitchenlab.org (adsl-64-142-29-77.sonic.net [64.142.29.77])h9KGG6uf006721 (version=TLSv1/SSLv3 cipher=EDH-RSA-DES-CBC3-SHA bits=168 verify=NO); Mon, 20 Oct 2003 09:16:07 -0700 Received: from intruder.kitchenlab.org (bmah@localhost [127.0.0.1]) h9KGG6nB056915; Mon, 20 Oct 2003 09:16:06 -0700 (PDT) (envelope-from bmah@intruder.kitchenlab.org) Received: (from bmah@localhost) by intruder.kitchenlab.org (8.12.9p2/8.12.9/Submit) id h9KGG6tE056914; Mon, 20 Oct 2003 09:16:06 -0700 (PDT) (envelope-from bmah) Date: Mon, 20 Oct 2003 09:16:06 -0700 From: "Bruce A. Mah" To: Ceri Davies , "Bruce A. Mah" , freebsd-doc@FreeBSD.org Message-ID: <20031020161606.GA56817@intruder.kitchenlab.org> References: <200310190613.h9J6DAnB035928@intruder.kitchenlab.org> <200310200414.h9K4EInB049618@intruder.kitchenlab.org> <3F936C7E.9020904@centtech.com> <20031020151209.GA55608@intruder.kitchenlab.org> <20031020152939.GE3708@submonkey.net> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="cNdxnHkX5QqsyA0e" Content-Disposition: inline In-Reply-To: <20031020152939.GE3708@submonkey.net> User-Agent: Mutt/1.4.1i X-Image-Url: http://www.employees.org/~bmah/Images/bmah-cisco-small.gif X-url: http://www.employees.org/~bmah/ Subject: Re: HEADS-UP: doc/ tree slushie X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 20 Oct 2003 16:16:12 -0000 --cNdxnHkX5QqsyA0e Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable If memory serves me right, Ceri Davies wrote: > Could I throw out the idea of committing the attached diff before that > happens? I know that we normally do this after doc/ has been tagged, > but that has always seemed strange to me, as the documentation tagged > as 4.9-RELEASE doesn't contain any references to it. >=20 > Of course, the downside is that the website will reflect things that > don't exist yet. Well, the way I usually like to do this is to tag first (with the doc/ tree in a usable state), then change certain files that have version numbers in them, and then slide the tags on those files. As you correctly implied, it doesn't always work that way. :-) The benefit is that we reduce (OK, just slightly) the amount of time that the doc tree displayed on the Web site reflects things that don't exist yet. On the other hand, I'm not opposed to trying it your way, especially since we should be branching and going to final builds soon anyways. Lemme think about this a bit...my morning (.ca.us time) caffeine hasn't taken effect yet. > Index: en_US.ISO8859-1/articles/hubs/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/hubs/article.sgml,v > retrieving revision 1.36 > diff -u -r1.36 article.sgml > --- en_US.ISO8859-1/articles/hubs/article.sgml 14 Aug 2003 19:54:05 -0000= 1.36 > +++ en_US.ISO8859-1/articles/hubs/article.sgml 20 Oct 2003 15:17:52 -0000 > @@ -79,7 +79,7 @@ > complete. The CVS repository and the web pages should > always be mirrored completely. Also note that the > numbers stated here are reflecting the current > - state (at 4.8-RELEASE/5.1-RELEASE). Further development and > + state (at 4.9-RELEASE/5.1-RELEASE). Further development and > releases will only increase the required amount. > Also make sure to keep some (ca. 10-20%) extra space > around just to be sure. Yeeek, what are those hard-coded version numbers doing in there?!? Actually...are there some other related constants (i.e. amount of disk space) that might need to be changed or otherwise track a version number? I haven't read the hubs article lately. Thanks! Bruce. --cNdxnHkX5QqsyA0e Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.3 (FreeBSD) iD8DBQE/lApG2MoxcVugUsMRAmZGAJ4lcceaUS8LeC0OdimnuIlpZokpfwCfaIaQ 82ImaZ2vgVH8cfEH+Ff1iTo= =F/8B -----END PGP SIGNATURE----- --cNdxnHkX5QqsyA0e--