Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 25 Apr 2001 18:27:01 -0700
From:      Dima Dorfman <dima@unixfreak.org>
To:        bmah@FreeBSD.ORG
Cc:        Makoto MATSUSHITA <matusita@jp.FreeBSD.org>, freebsd-doc@FreeBSD.ORG
Subject:   Re: [RFC] RELNOTESng for 5-CURRENT 
Message-ID:  <20010426012701.DF66A3E2A@bazooka.unixfreak.org>
In-Reply-To: <200104260114.f3Q1EN730056@bmah-freebsd-0.cisco.com>; from bmah@FreeBSD.ORG on "Wed, 25 Apr 2001 18:14:23 -0700"

next in thread | previous in thread | raw e-mail | index | archive | help
[ dropping -current; I doubt most people care about the details ]

bmah@FreeBSD.ORG (Bruce A. Mah) writes:
> If memory serves me right, Dima Dorfman wrote:
> 
> > On a slightly related note, do you object, or
> > have plans to, build the release notes with the web site?  It would
> > solve this problem very nicely.
> 
> Hi Dima--
> 
> No objections, but no plans right now either.  Mostly because I don't 
> know enough about the Web site build.  Got any ideas?  :-)

If the release notes have a build procedure that resembles anything
like that of any of the other docs (and I suspect this is the case),
adding it would be trivial.  Once you get it committed I'll see what I
can do.

> I'm not sure if it will *solve* the problem, but at least it will 
> allevitate it somewhat.  And it's aesthetically more pleasing to me (if 
> that counts for anything).

I think it should solve it.  AIUI the complaint was that someone would
now need the docproj port to see the release notes if they're tracking
-stable.  Someone tracking -stable probably has a good enough
connection to view a web page.

> Note that this is a fairly new capability...we currently don't have a 
> link for -CURRENT or 4-STABLE release notes.  There might be some 
> issues with this although I can't think of any off-hand.

At first we can add it as just another docuemnt (list it in
docs.html).  I doubt there are any problems with that.

> > I understand that relnotes will be in
> > src/, so this would have to be an optional part of the build, but at
> > least having them built on www.freebsd.org would suffice.
> 
> Yeah, it should be optional.  The thing-that-generates-the-Web-pages 
> would need the src/release/ module (somewhere in its filesystem, not 
> necessarily in /usr/src/release), plus doc/.  RELNOTESng doesn't need a 
> complete src/.

Of course.  If we're building the web site we have a doc/ (there's an
option not to build docs, but assume we have it).  I guess it would
simply involve a way to set the path to src/release, and run make in
that if it exists.

					Dima Dorfman
					dima@unixfreak.org

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010426012701.DF66A3E2A>