From owner-freebsd-stable Thu Jun 14 12:57:15 2001 Delivered-To: freebsd-stable@freebsd.org Received: from imr2.ericy.com (imr2.ericy.com [12.34.240.68]) by hub.freebsd.org (Postfix) with ESMTP id 94DF137B401 for ; Thu, 14 Jun 2001 12:56:34 -0700 (PDT) (envelope-from Antoine.Beaupre@ericsson.ca) Received: from mr5.exu.ericsson.se (mr5att.ericy.com [138.85.92.13]) by imr2.ericy.com (8.11.3/8.11.3) with ESMTP id f5EJuZR08838 for ; Thu, 14 Jun 2001 14:56:35 -0500 (CDT) Received: from noah.lmc.ericsson.se (noah.lmc.ericsson.se [142.133.1.1]) by mr5.exu.ericsson.se (8.11.3/8.11.3) with ESMTP id f5EJuXb25624 for ; Thu, 14 Jun 2001 14:56:33 -0500 (CDT) Received: from lmc35.lmc.ericsson.se (lmc35.lmc.ericsson.se [142.133.16.175]) by noah.lmc.ericsson.se (8.11.2/8.9.2) with ESMTP id f5EJuXG25439 for ; Thu, 14 Jun 2001 15:56:33 -0400 (EDT) Received: by lmc35.lmc.ericsson.se with Internet Mail Service (5.5.2653.19) id ; Thu, 14 Jun 2001 15:56:30 -0400 Received: from lmc.ericsson.se (lmcpc100455.pc.lmc.ericsson.se [142.133.23.150]) by LMC37.lmc.ericsson.se with SMTP (Microsoft Exchange Internet Mail Service Version 5.5.2653.13) id M8GVXWKW; Thu, 14 Jun 2001 15:54:36 -0400 From: "Antoine Beaupre (LMC)" To: freebsd-stable@FreeBSD.ORG Message-ID: <3B29167C.3000008@lmc.ericsson.se> Date: Thu, 14 Jun 2001 15:54:36 -0400 Organization: LMC, Ericsson Research Canada User-Agent: Mozilla/5.0 (Windows; U; WinNT4.0; en-US; rv:0.9.1) Gecko/20010607 X-Accept-Language: en,fr-CA,fr MIME-Version: 1.0 Subject: Re: OT: rendered copies of RelnotesNG in the tree (was: RELNOTESng problems) References: <200106121443.KAA18844@world.std.com> <3B2637CA.9050803@lmc.ericsson.se> <200106121629.f5CGTZF27955@bmah-freebsd-0.cisco.com> <3B265047.4060605@lmc.ericsson.se> <200106130352.f5D3qvB37402@bmah-freebsd-0.cisco.com> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 8bit 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 Bruce A. Mah wrote: > If memory serves me right, "Antoine Beaupre (LMC)" wrote: > > >>>How does the Web-available versions differ from putting the TXT >>>rendering in the repository? >>> >> >>Not much. But one might like to consider the idea of having the TXT >>files *implicitly* available along the source code (bundled), instead of >>as a "foreign" reference on a website. I can see many situations where >>one could not have access to the web but only acces to the local machine >>which contains the source code. >> > > I'm trying to picture someone tracking -STABLE (for instance) but not > being able to pull down a Web page...CTM users are the only group of > people who come to mind, potentially. Yes. Or a remote machine placed beyond a few levels of firewalls/proxies. :) >>Another thing which crosses my mind: when someone installs a RELEASE, >>the relnotes TXT/rendered versions come with it and are installed as >>part of the install process, right? > > No, actually I don't think the release documentation gets installed...it > stays on the install media. Someone correct me if this is wrong... I would be nice to make sure. Actually, it depends on the presence of these files in the "src" distro, I guess. :) > I confess that I haven't done a sysinstall for about a year. A year? Much more than that! ;) > cvsup/make world doesn't touch these either (I know that for sure). Ditto. >>>The Web versions will (once the Web >>>Gods make a couple of commits) get built as frequently as the Web site >>>is. >> >>That's about once a day, if I'm not mistaken? > > I *think* it's twice a day for the main server; don't know about the > mirrors. Then that's good. >>How technically feasable would it be to have the TXT files rebuilt on >>the fly, after a commit on the related .sgml file? > > I don't know of any easy way to do this. The problem is that the *.TXT > rebuild requires running a process (OK, a bunch of processes) that may > or not produce successful output. It's a lot for the CVS server to > have to handle, and we can't very well require this on the CVS clients. You're right. Having this on a cvs[up] server would be totally mad/inappropriate. :) Building the release notes is now a pretty heavy activity! > You didn't suggest this, but in case someone *else* thinks of it, no, > we'll never have a policy of requiring manual commits of *.TXT > renderings. Well I kinda suggested that in some way, since there's not really another alternative. But I guess it's zeroed out now. >>>In the meantime, you can look at the version on my Web page. They're >>>updated pretty often, on an unofficial basis. >> >>Assuming I have access to the web. :) That is of course considered >>irrelevent nowadays, but I find that still a considerable requisite to >>have access to notes so tightly integrated (or relevant? I miss the >>proper word) to the source... These things should all be bundled together. > > I think "integrated" is the word you mean. Bundled. It should be the same package. > If I only had intermittent net access, and I couldn't build the release > documentation locally, I'd do a fetch on the Web site at the same time > as a cvsup of my sources. Probably done with a script. Not the most > well-coupled solution, I realize: > > #! /bin/sh > cvsup -g -L2 path/to/my/supfile > fetch http://www.freebsd.org/path/to/relnotes.txt > fetch http://www.freebsd.org/path/to/hardware.txt > fetch http://www.freebsd.org/path/to/install.txt > fetch http://www.freebsd.org/path/to/readme.txt > fetch http://www.freebsd.org/path/to/errata.txt Yah... We should really have a centralized/official "process" regarding that. er.. We do, actually. :) This could be put in the "update" target of the make world makefiles! >>Actually, the release notes are *implicitly* out of date, since we have >>no formal/automated system of updating the relnotes when a major change >>is made. AFAIK, there is someone (you, Bruce?:) that updates them by >>watching cvs-all, but that is also an out of date process. >> >>OTOH, putting the TXT files in the repository would also add to the delay. > > It's usually me who writes these things. It'd be nice if more > developers wrote their own release notes though. gshapiro is actually > really good about doing release note commits at the same time as his > source commits. Good job. :) Regards, Antoine -- La sémantique est la gravité de l'abstraction. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-stable" in the body of the message