Bug 38771 - Documentation error in FAQ.
Summary: Documentation error in FAQ.
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: Normal Affects Only Me
Assignee: freebsd-doc (Nobody)
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2002-05-31 19:00 UTC by Arthur Munn
Modified: 2002-06-10 22:13 UTC (History)
0 users

See Also:


Attachments
file.diff (547 bytes, patch)
2002-05-31 19:00 UTC, Arthur Munn
no flags Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Arthur Munn 2002-05-31 19:00:07 UTC
Simple error, "release", should be "releases".
Comment 1 Bruce A. Mah freebsd_committer freebsd_triage 2002-05-31 19:07:58 UTC
If memory serves me right, Arthur Munn wrote:

> --- book.sgml.orig	Fri May 31 13:24:05 2002
> +++ book.sgml   Fri May 31 13:25:59 2002
> @@ -432,7 +432,7 @@
>          </question>
>  
>          <answer>
> -          <para>As a general principle, the FreeBSD core team only 
>              release
> +          <para>As a general principle, the FreeBSD core team only 
>              releases a new version of FreeBSD when they believe that  
>              there are sufficient new features and/or bug fixes to 
>              justify one, and are satisfied that these new developments 
>              have been tested

Whomever decides to fix this should note that the core team doesn't 
decide to do releases, the RE team does.  I don't know what the 
question was, but the answer doesn't seem to reflect reality.

Bruce.
Comment 2 Giorgos Keramidas freebsd_committer freebsd_triage 2002-06-01 03:25:19 UTC
On 2002-05-31 11:10 -0700, Bruce A. Mah wrote:
> If memory serves me right, Arthur Munn wrote:
> >
> > -          <para>As a general principle, the FreeBSD core team only 
> >              release
> > +          <para>As a general principle, the FreeBSD core team only 
> >              releases a new version of FreeBSD when they believe that  
> >              there are sufficient new features and/or bug fixes to 
> >              justify one, and are satisfied that these new developments 
> >              have been tested
>  
> Whomever decides to fix this should note that the core team doesn't 
> decide to do releases, the RE team does.  I don't know what the 
> question was, but the answer doesn't seem to reflect reality.

The patch of this PR doesn't apply to the FAQ.  It's not very clear to
me what needs to be changed either.  We can change "core" to
"release-engineering" though.

How about this?

%%%
Index: book.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/faq/book.sgml,v
BBBBBretrieving revision 1.445
diff -u -r1.445 book.sgml
--- book.sgml	30 May 2002 21:11:55 -0000	1.445
+++ book.sgml	1 Jun 2002 02:20:54 -0000
@@ -432,7 +432,7 @@
         </question>
 
         <answer>
-          <para>As a general principle, the FreeBSD core team only release
+          <para>As a general principle, the FreeBSD release-engineering team only release
             a new version of FreeBSD when they believe that there are
             sufficient new features and/or bug fixes to justify one, and
             are satisfied that these new developments have been tested
%%%
Comment 3 Arthur Munn 2002-06-01 06:59:09 UTC
> The patch of this PR doesn't apply to the FAQ. It's not very clear to me
> what needs to be changed either. We can change "core" to 
> "release-engineering" though.

I think we should change "core" to "release-engineering" too. The original PR
was that "release" should be "releases". The reason for that seems clear to me.
Since they are going to be releasing more than one version, we say "The RE
team only releases when...", instead of "The RE team only release when...".
Comment 4 Peter Pentchev 2002-06-03 10:10:26 UTC
On Fri, May 31, 2002 at 07:30:03PM -0700, Giorgos Keramidas wrote:
>  
>  How about this?
>  
>  %%%
>  Index: book.sgml
>  ===================================================================
>  RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/faq/book.sgml,v
>  BBBBBretrieving revision 1.445
>  diff -u -r1.445 book.sgml
>  --- book.sgml	30 May 2002 21:11:55 -0000	1.445
>  +++ book.sgml	1 Jun 2002 02:20:54 -0000
>  @@ -432,7 +432,7 @@
>           </question>
>   
>           <answer>
>  -          <para>As a general principle, the FreeBSD core team only release
>  +          <para>As a general principle, the FreeBSD release-engineering team only release
>               a new version of FreeBSD when they believe that there are
>               sufficient new features and/or bug fixes to justify one, and
>               are satisfied that these new developments have been tested
>  %%%

And while we are here, why not just use &a.re; instead? :)

G'luck,
Peter

-- 
Peter Pentchev	roam@ringlet.net	roam@FreeBSD.org
PGP key:	http://people.FreeBSD.org/~roam/roam.key.asc
Key fingerprint	FDBA FD79 C26F 3C51 C95E  DF9E ED18 B68D 1619 4553
This sentence claims to be an Epimenides paradox, but it is lying.
Comment 5 Bruce A. Mah freebsd_committer freebsd_triage 2002-06-10 22:12:59 UTC
State Changed
From-To: open->closed

I ended up rewriting about half of the FAQ in question, but it does 
have your grammatical fix in it.  :-) 

Thanks!