Skip site navigation (1)Skip section navigation (2)
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>

next in thread | raw e-mail | index | archive | help

--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




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