Bug 78130

Comment 1 Remko Lodder 2005-02-26 22:33:58 UTC

Responsible Changed
From-To: freebsd-doc->remko

Grab this PR

Comment 2 Tom Rhodes 2005-02-26 22:36:42 UTC

On Sat, 26 Feb 2005 15:23:41 -0700 (MST)
Brad Davis <so14k@so14k.com> wrote:

> 
> --- doc-ori/en_US.ISO8859-1/books/handbook/install/chapter.sgml	Fri Feb 25 13:31:41 2005
> +++ doc/en_US.ISO8859-1/books/handbook/install/chapter.sgml	Sat Feb 26 15:11:13 2005
> @@ -2501,7 +2501,7 @@
>        configuration options before booting the new FreeBSD
>        system or after installation using
>        <command>sysinstall</command> (<command>/stand/sysinstall</command>
> -      in &os; versions older than 5.2) and selecting
> +      in &os; versions older than 5.2-RELEASE) and selecting
>        <guimenuitem>Configure</guimenuitem>.</para>
>  
>      <sect2 id="inst-network-dev">
> --- doc-ori/en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml	Fri Feb 25 13:31:42 2005
> +++ doc/en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml	Sat Feb 26 15:15:09 2005
> @@ -2976,9 +2976,9 @@
>  
>        <para>
>          This document refers to BIND 8.x, as it is the stable version
> -	used in &os;.  Versions of &os;&nbsp;5.3 and beyond include
> +	used in &os;.  Versions of &os;&nbsp;5.3-RELEASE and beyond include
>  	<acronym>BIND</acronym>9 and the configuration instructions
> -	may be found later in this chapter.  Users of &os;&nbsp;5.2
> +	may be found later in this chapter.  Users of &os;&nbsp;5.2-RELEASE
>  	and other previous versions may install <acronym>BIND</acronym>9
>  	from the <filename role="package">net/bind9</filename> port.</para>
>  
> @@ -4048,7 +4048,7 @@
>        layout and automated &man.chroot.8; configuration came with the
>        import.  This section has been written in two parts, the first
>        will discuss new features and their configuration; the latter
> -      will cover upgrades to aid in move to &os;&nbsp;5.3.  From this
> +      will cover upgrades to aid in move to &os;&nbsp;5.3-RELEASE.  From this
>        moment on, the server will be referred to simply as
>        &man.named.8; in place of <acronym>BIND</acronym>.  This section
>        skips over the terminology described in the previous section as


This is a bad idea.  5.3 is a 'release' version.  It's unfair
to change only a portion of these and not all of them, and
that change is a bit too much.


-- 
Tom Rhodes

Comment 3 Simon L. B. Nielsen 2005-02-26 22:39:27 UTC

On 2005.02.26 15:23:41 -0700, Brad Davis wrote:
> 
> 	Change bits like "5.2" to "5.2-RELEASE"


Hmm, what's the motivation for this?  I don't really see much
advantage to the later form?

-- 
Simon L. Nielsen

The goal is to be more verbose about what we are referring to so that
when someone is reading they know exactly what we are talking about.

Granted these are just the ones I happened to notice in a sweep over The
Handbook, I think this should be the way it is done.



Regards,
Brad Davis

Comment 5 Remko Lodder 2005-02-26 23:02:25 UTC

State Changed
From-To: open->closed

After discussing this with Tom and Simon it got clear to me that 
x.x means RELEASE (where x is a digit). 
I close this PR after discussing it with Brad. 
Thanks for the submission though!