From owner-freebsd-current Wed Apr 25 11:18:25 2001 Delivered-To: freebsd-current@freebsd.org Received: from post.mail.nl.demon.net (post-11.mail.nl.demon.net [194.159.73.21]) by hub.freebsd.org (Postfix) with ESMTP id ED26237B423; Wed, 25 Apr 2001 11:18:16 -0700 (PDT) (envelope-from wkb@freebie.demon.nl) Received: from [212.238.54.101] (helo=freebie.demon.nl) by post.mail.nl.demon.net with smtp (Exim 3.22 #1) id 14sTre-00005l-00; Wed, 25 Apr 2001 18:18:10 +0000 Received: (from wkb@localhost) by freebie.demon.nl (8.11.3/8.11.2) id f3PIM4901351; Wed, 25 Apr 2001 20:22:04 +0200 (CEST) (envelope-from wkb) Date: Wed, 25 Apr 2001 20:22:04 +0200 From: Wilko Bulte To: "Bruce A. Mah" Cc: Makoto MATSUSHITA , freebsd-current@freebsd.org, freebsd-doc@freebsd.org Subject: Re: [RFC] RELNOTESng for 5-CURRENT Message-ID: <20010425202204.A1311@freebie.demon.nl> References: <200104241603.f3OG3AB06290@bmah-freebsd-0.cisco.com> <20010425211805N.matusita@jp.FreeBSD.org> <200104251658.f3PGwe220619@bmah-freebsd-0.cisco.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <200104251658.f3PGwe220619@bmah-freebsd-0.cisco.com>; from bmah@freebsd.org on Wed, Apr 25, 2001 at 09:58:40AM -0700 X-OS: FreeBSD 4.3-STABLE X-PGP: finger wilko@freebsd.org Sender: owner-freebsd-current@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG On Wed, Apr 25, 2001 at 09:58:40AM -0700, Bruce A. Mah wrote: > [Please keep me as one of the explicit recipients of this email. > > Removing *.TXT files also makes some difficulties when ordinally "make > > buildworld/installworld" users want to know what changes are made > > (they should change their CVSup configulation file, checkout doc if > > the repository is CVSuped, install DocBook via ports, and run make(1) > > to get a plaintext of release notes). > > I think the only recurring cost that people are going to have to do is > to keep a reasonably current copy of doc/. Building the docproj port is Reasonably current effectively means "not current" . Aka out of date. > Umm, no, it's not just like the current doc distribution. If you build > a release with NODOC=YES, you don't get any rendition of the FAQ, > Handbook, etc. There's no *.TXT files to fall back on. > > Here's my thoughts...for the record, I'm weakly opposed to regen-ing > *.TXT versions: First, I don't want to bloat the repository with oodles > of builds to the *.TXT files. If we do this, it ought to be be fairly > infrequently, like maybe once or twice a month. Bad idea.. RELNOTES, HARDWARE etc are things that should be up to date. Not 'a bit uptodate' or 'slightly outdated'. I really would not like to see the idea being bloated by going this route. If people think getting the Docbook infrastructure in place is too much work/time they should accustom themselves to reading the raw Docboot source files. > Like I said, I'm weakly opposed to doing this, but I'm also quite > willing to be swayed. Please don't be swayed.. ;) W/ -- | / o / / _ Arnhem, The Netherlands email: wilko@freebsd.org |/|/ / / /( (_) Bulte Powered by FreeBSD/alpha http://www.freebsd.org To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-current" in the body of the message