Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 20 Mar 2000 14:48:10 +0000
From:      Nik Clayton <nik@freebsd.org>
To:        Alexey Zelkin <phantom@FreeBSD.org>
Cc:        nik@FreeBSD.org, doc@FreeBSD.org
Subject:   Re: doc/ tree tagging
Message-ID:  <20000320144810.A4023@catkin.nothing-going-on.org>
In-Reply-To: <20000318120027.A9870@scorpion.crimea.ua>; from Alexey Zelkin on Sat, Mar 18, 2000 at 12:00:27PM %2B0300
References:  <20000318120027.A9870@scorpion.crimea.ua>

next in thread | previous in thread | raw e-mail | index | archive | help
On Sat, Mar 18, 2000 at 12:00:27PM +0300, Alexey Zelkin wrote:
> I took a look to the FAQ and found that a lot of points should be
> fixed for 4.0-RELEASE, but should be left for 3.x branch. For example
> latest changes related in 4.x/5.x config(8) are not relected and FAQ
> give incorrect examples at all. Since 3.x branch will be supported
> until 3.6 release (at least) we need to fix documentation for 4.x
> and leave it as well for 3.x. IMHO much better way is just create
> cvs branch for 3.x docs and continue support of this branch, but
> all new changes should go to HEAD branch.

No.  We don't have the resources to manage multiple branches, and, unlike
code, there are definitely situations where the reader will want to see 
information about more than one version of FreeBSD at a time.

For example, imagine a hardware compatability list that was branched.  There
was a time when -current lacked support for devices in -stable, and there's
no reason why that might not happen again.

There's more, see the list archives for more detail.
 
> I remember about attempt of resolving of this problem by creation
> of new sgml entities, but it looks little junkly for me. 

It's still a prototype.  It needs people other than me to actually try it
out and provide feedback.  I've posted sample code and patches to this list
at least once (and quite probably more) and had very little feedback.

N
-- 
Internet connection, $19.95 a month.  Computer, $799.95.  Modem, $149.95.
Telephone line, $24.95 a month.  Software, free.  USENET transmission,
hundreds if not thousands of dollars.  Thinking before posting, priceless.
Somethings in life you can't buy.  For everything else, there's MasterCard.
  -- Graham Reed, in the Scary Devil Monastery


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?20000320144810.A4023>