From owner-freebsd-stable Tue Jun 12 9:15:49 2001 Delivered-To: freebsd-stable@freebsd.org Received: from sj-msg-core-3.cisco.com (sj-msg-core-3.cisco.com [171.70.157.152]) by hub.freebsd.org (Postfix) with ESMTP id 8CAD737B411 for ; Tue, 12 Jun 2001 09:14:57 -0700 (PDT) (envelope-from bmah@cisco.com) Received: from bmah-freebsd-0.cisco.com (bmah-freebsd-0.cisco.com [171.70.84.42]) by sj-msg-core-3.cisco.com (8.11.3/8.9.1) with ESMTP id f5CGDMF16965; Tue, 12 Jun 2001 09:13:22 -0700 (PDT) Received: (from bmah@localhost) by bmah-freebsd-0.cisco.com (8.11.3/8.11.3) id f5CGDdl27734; Tue, 12 Jun 2001 09:13:39 -0700 (PDT) (envelope-from bmah) Message-Id: <200106121613.f5CGDdl27734@bmah-freebsd-0.cisco.com> X-Mailer: exmh version 2.4+ 06/08/2001 with nmh-1.0.4 To: Kenneth W Cochran Cc: freebsd-stable@FreeBSD.ORG Subject: Re: RELNOTESng problems In-Reply-To: <200106121443.KAA18844@world.std.com> References: <200106121443.KAA18844@world.std.com> Comments: In-reply-to Kenneth W Cochran message dated "Tue, 12 Jun 2001 10:43:47 -0400." From: "Bruce A. Mah" Reply-To: bmah@FreeBSD.ORG X-Face: g~c`.{#4q0"(V*b#g[i~rXgm*w;:nMfz%_RZLma)UgGN&=j`5vXoU^@n5v4:OO)c["!w)nD/!!~e4Sj7LiT'6*wZ83454H""lb{CC%T37O!!'S$S&D}sem7I[A 2V%N&+ X-Image-Url: http://www.employees.org/~bmah/Images/bmah-cisco-small.gif X-Url: http://www.employees.org/~bmah/ Mime-Version: 1.0 Content-Type: multipart/signed; boundary="==_Exmh_1859110700P"; micalg=pgp-sha1; protocol="application/pgp-signature" Content-Transfer-Encoding: 7bit Date: Tue, 12 Jun 2001 09:13:39 -0700 Sender: owner-freebsd-stable@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG --==_Exmh_1859110700P Content-Type: text/plain; charset=us-ascii If memory serves me right, Kenneth W Cochran wrote: > With the recent move of RELNOTESng to -stable, what do we need > to do to build/maintain this documentation along with source? If you want to build a copy locally, install the textproc/docproj port and bring in the doc-all collection from current. You got that right as far as I can tell. > For example, does {build,install}world take care of this? > (Apparently not, but I'd appreciate The Official Word(tm). :) Well, I'm the guy who designed RELNOTESng, so I guess I count as "official" (?!?). buildworld/installworld doesn't do this. I didn't even consider this, because this would make buildworld and installworld take even longer than they do now. :-) > I tried going to /usr/src/release/doc & then "make" & I'm > getting what appear to be build-errors. Attached are the last > several output lines from that make. As per instructions in > /usr/src/release/doc/README, I have built textproc/docproj > from fresh -ports & additionally brought doc-all current. We're kind of at a strange state right now; RELNOTESng for 4-STABLE is broken (see my earlier heads-up) due to some other commits that took me rather by surprise. I hope it'll get fixed soon (I know how to fix it, but the fix depends on one or two decisions that are out of my hands.) I think I know what problem you're seeing, and I can fix it after this other (bigger) breakage gets fixed. I have no idea why earlier testing didn't catch this problem. Sorry about that! > So, to restate my question: > 1. How do I build/maintain -stable documentation? So far you seem to be doing the right thing. > 2. How (where) do I go to look at said documentation? When the build is done, you can point a Web browser at the subdirectorie s under /usr/src/release/doc/en_US.ISO_8859-1/ and read the HTML files there. If you did the build with additional document FORMATS (i.e "make 'FORMATS=html pdf txt'") you'll see the other output files there as well. Alternatively you can just read the Web versions at: http://people.freebsd.org/~bmah/relnotes/ The plan is for these to be moved into a more "official" spot on the FreeBSD web site and automatically generated along with the Web site build. > Commentary: > While I think the move to RELNOTESng is probably a Good Thing, > I think deletion/removal of the ascii-plaintext versions from > src/release/texts/* is probably Not Such A Good Thing. > Additionally, I "question" the necessity of requiring tools > "outside" the base-OS solely for reading the relevant release > notes/errata. Noted. We debated this at some length on -doc when I was working on it. The outcome of this debate was that we decided to put frequently-updated versions of the release notes on the Web site (the URL I gave above is a part of my testing process). I'd rather not rehash all the arguments for this...you can see them in the -doc archives. Bruce. --==_Exmh_1859110700P Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.6 (FreeBSD) Comment: Exmh version 2.3.1+ 05/14/2001 iD8DBQE7Jj+z2MoxcVugUsMRAqamAKCoQ5c7S84/4XOYoHbne2BOjSOe/wCgyLvf LEduyo5sgwOIQU+oxFWZL5c= =6TOb -----END PGP SIGNATURE----- --==_Exmh_1859110700P-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-stable" in the body of the message