From owner-freebsd-doc  Mon Nov  5  8:31:25 2001
Delivered-To: freebsd-doc@freebsd.org
Received: from blackhelicopters.org (geburah.blackhelicopters.org [209.69.178.18])
	by hub.freebsd.org (Postfix) with ESMTP id E95F037B417
	for <doc@freebsd.org>; Mon,  5 Nov 2001 08:31:21 -0800 (PST)
Received: (from mwlucas@localhost)
	by blackhelicopters.org (8.9.3/8.9.3) id LAA90139
	for doc@freebsd.org; Mon, 5 Nov 2001 11:31:21 -0500 (EST)
	(envelope-from mwlucas)
Date: Mon, 5 Nov 2001 11:31:21 -0500
From: Michael Lucas <mwlucas@blackhelicopters.org>
To: doc@freebsd.org
Subject: more on linking to release notes
Message-ID: <20011105113121.A90077@blackhelicopters.org>
Mime-Version: 1.0
Content-Type: multipart/mixed; boundary="bg08WKrSYDhXBjb5"
Content-Disposition: inline
User-Agent: Mutt/1.2i
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org


--bg08WKrSYDhXBjb5
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

Hello,

I'm wondering how we should link to the relnotes.  In reading the FAQ,
I find several places where, IMHO, we should be doing this.

This is something of a followup on pr doc/30202.  When I opened it we
had a bit of discussion over it, and it quietly died awaiting 4.4-R.

I'm suggesting that we create a docbook entity, &rel.current.notes; ,
that points to the current Release Notes.  This would save us the
trouble of updating this link every time a new release comes out, and
also answer dd's objections IIRC.  I've attached a patch to implement
this, and to follow up doc/30202.  We could also use this
functionality to fix several broken links in the FAQ that have a
similar problem to this PR.

Any comments?

==ml

-- 
Michael Lucas
mwlucas@blackhelicopters.org
http://www.blackhelicopters.org/~mwlucas/
Big Scary Daemons: http://www.oreillynet.com/pub/q/Big_Scary_Daemons

--bg08WKrSYDhXBjb5
Content-Type: text/plain; charset=us-ascii
Content-Disposition: attachment; filename="freebsd.ent"

*** freebsd.ent-dist	Wed Oct 31 11:26:51 2001
--- freebsd.ent	Wed Oct 31 11:28:58 2001
***************
*** 16,21 ****
--- 16,22 ----
       it's really release time -->
  <!ENTITY rel.current CDATA "4.4">
  <!ENTITY rel.current.date CDATA "September, 2001">
+ <!ENTITY rel.current.notes "http://www.freebsd.org/releases/4.4R/notes.html">
  
  <!-- Sections that we don't want to be published -->
  <!ENTITY % not.published 	"IGNORE">

--bg08WKrSYDhXBjb5
Content-Type: text/plain; charset=us-ascii
Content-Disposition: attachment; filename="scsi-supported.diff"

*** book.sgml-dist	Wed Oct 31 11:30:49 2001
--- book.sgml	Wed Oct 31 11:32:32 2001
***************
*** 2354,2360 ****
  
          <answer>
            <para>See the complete list in the <ulink
!             URL="../handbook/install.html#INSTALL-HW">Handbook</ulink>.</para>
          </answer>
        </qandaentry>
  
--- 2354,2360 ----
  
          <answer>
            <para>See the complete list in the <ulink
!             URL="&rel.current.notes">Release Notes</ulink>.</para>
          </answer>
        </qandaentry>
  

--bg08WKrSYDhXBjb5--

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