From nobody@FreeBSD.org  Sun Jul 29 02:36:06 2007
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 7F7E116A41A
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 29 Jul 2007 02:36:06 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id 4FD2E13C46B
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 29 Jul 2007 02:36:06 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.1/8.14.1) with ESMTP id l6T2a6Iw047182
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 29 Jul 2007 02:36:06 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.1/8.14.1/Submit) id l6T2a6KE047181;
	Sun, 29 Jul 2007 02:36:06 GMT
	(envelope-from nobody)
Message-Id: <200707290236.l6T2a6KE047181@www.freebsd.org>
Date: Sun, 29 Jul 2007 02:36:06 GMT
From: Ben Kaduk <minimarmot@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: [PATCH] nits and updates to FAQs (part 1)
X-Send-Pr-Version: www-3.0

>Number:         115000
>Category:       docs
>Synopsis:       [PATCH] nits and updates to FAQs (part 1)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    pgj
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Jul 29 02:40:01 GMT 2007
>Closed-Date:    Sat Jun 07 02:35:14 UTC 2008
>Last-Modified:  Sat Jun 07 02:35:14 UTC 2008
>Originator:     Ben Kaduk
>Release:        7.0-CURRENT
>Organization:
>Environment:
the world-wide web.
>Description:
itemized (but not enumerated) changelist:

o monthly, not daily, snapshots are made available at freebsd.org/snapshots/

o all monthly snapshots (not just the occasional one) are made available

o the paren of the smiley doesn't close the parenthetical expression.  do so

o we're heading towards 6.3 now, not 6.2

o eight months between 5.5 and 6.2 (june 2006 to january 2007 -- see newvers.sh commit log)

o the linked snapshots are monthly, not daily

o query-pr-summary and query-pr are functionally equivalent now; linking to query-pr is semantically closer to the active text of the link (and I think -summary is deprecated?)

I am not sure why this text refers to daily snapshots.  Perhaps the author was thinking of the tinderboxen?  If so, I didn't think their releases were made available, and they certainly aren't on the page that the FAQ links to.
>How-To-Repeat:

>Fix:


Patch attached with submission follows:

--- book.sgml.orig	2007-07-23 20:26:10.000000000 -0500
+++ book.sgml	2007-07-28 21:29:54.000000000 -0500
@@ -367,11 +367,11 @@
             groups</quote> on the -CURRENT mailing list may be
             treated with contempt.</para>
 
-          <para>Every day, <ulink
+          <para>Every month, <ulink
 	    url="&url.base;/snapshots/">snapshot
             </ulink> releases are made based on the current state of the
-            -CURRENT and -STABLE branches.  Distributions of the
-            occasional snapshot are made available. The goals
+            -CURRENT and -STABLE branches.
+            The goals
             behind each snapshot release are:</para>
 
           <itemizedlist>
@@ -391,7 +391,7 @@
               <para>To preserve a fixed reference point for the code in
                 question, just in case we break something really badly
                 later.  (Although CVS normally prevents anything horrible
-                like this happening :)</para>
+                like this happening :)&nbsp;)</para>
             </listitem>
 
             <listitem>
@@ -432,7 +432,7 @@
             only well-tested bug fixes and other small incremental
             enhancements.  FreeBSD-CURRENT, on the other hand, has
             been one unbroken line since 2.0 was released, leading
-            towards 6.2-RELEASE and beyond.  Just before 6.0-RELEASE, the
+            towards 6.3-RELEASE and beyond.  Just before 6.0-RELEASE, the
             6-STABLE branch was created, and
             &os.current; became 7-CURRENT.  For more detailed information,
             see <quote><ulink url="&url.articles.releng;/release-proc.html#REL-BRANCH">
@@ -467,7 +467,7 @@
 
         <answer>
 	  <para>The &a.re; releases a new version of FreeBSD about every
-	    four months, on average.  Release dates are announced well in
+	    eight months, on average.  Release dates are announced well in
 	    advance, so that the people working on the system know
 	    when their projects need to be finished and tested.  
 	    A testing period precedes each release, in order to ensure
@@ -532,7 +532,7 @@
             <listitem>
               <para><ulink
 		url="&url.base;/snapshots/">
-                Snapshot</ulink> releases are made daily for the
+                Snapshot</ulink> releases are made monthly for the
 		<link linkend="current">-CURRENT</link> and <link
 		linkend="stable">-STABLE</link> branch, these being
                 of service purely to bleeding-edge testers and
@@ -561,7 +561,7 @@
           <para>The Problem Report database of all user change requests
             may be queried by using our web-based PR
             <ulink
-            url="http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query">
+            url="http://www.FreeBSD.org/cgi/query-pr.cgi?query">
             query</ulink>
             interface.</para>
 


>Release-Note:
>Audit-Trail:

From: "Ben Kaduk" <minimarmot@gmail.com>
To: freebsd-gnats-submit@freebsd.org
Cc:  
Subject: Re: docs/115000: [PATCH] nits and updates to FAQs (part 1)
Date: Sat, 28 Jul 2007 21:52:22 -0500

 Forgot to mention, this is the FAQ here:
 http://www.freebsd.org/doc/en_US.ISO8859-1/books/faq/
 
 i.e. that url is the how-to-repeat field

From: "Ben Kaduk" <minimarmot@gmail.com>
To: bug-followup@freebsd.org
Cc:  
Subject: Re: docs/115000 [patch] updates/nits to faqs
Date: Sat, 15 Sep 2007 15:12:01 +0000

 A recent mail to -current from danger@ (in a different context)
 alerted me that there are, in fact, daily snapshots that are being
 built and made available.  However, they are on
 snapshots.us.freebsd.org , not snapshots.freebsd.org.  In theory, I
 will be working to update the patch soon, but I am sending this now
 for the PR audit trail.
 
 -Ben Kaduk

From: "Ben Kaduk" <minimarmot@gmail.com>
To: bug-followup@freebsd.org
Cc:  
Subject: Re: docs/115000: [PATCH] nits and updates to FAQs (part 1)
Date: Sat, 22 Sep 2007 13:33:49 -0400

 An updated diff is inlined below, but I think gmail may mangle the whitespace,
 so a text file is also available at
 http://web.mit.edu/kaduk/www/freebsd/patches/faq/book.sgml.diff.0.txt
 
 -Ben Kaduk
 
 --------- begin inline patch ------------
 --- book.sgml.orig      2007-07-23 21:26:10.000000000 -0400
 +++ book.sgml   2007-09-22 13:29:06.000000000 -0400
 @@ -367,11 +367,11 @@
              groups</quote> on the -CURRENT mailing list may be
              treated with contempt.</para>
 
 -          <para>Every day, <ulink
 +          <para>Every month, <ulink
             url="&url.base;/snapshots/">snapshot
              </ulink> releases are made based on the current state of the
 -            -CURRENT and -STABLE branches.  Distributions of the
 -            occasional snapshot are made available. The goals
 +            -CURRENT and -STABLE branches.
 +            The goals
              behind each snapshot release are:</para>
 
            <itemizedlist>
 @@ -391,7 +391,7 @@
                <para>To preserve a fixed reference point for the code in
                  question, just in case we break something really badly
                  later.  (Although CVS normally prevents anything horrible
 -                like this happening :)</para>
 +                like this happening :)&nbsp;)</para>
              </listitem>
 
              <listitem>
 @@ -410,8 +410,11 @@
           <para>Snapshot releases are directly available from <ulink
             url="&url.base;/snapshots/">snapshot</ulink>.</para>
 
 -          <para>Snapshots are generated, on the average, daily for
 -            all actively developed branches.</para>
 +          <para>Official snapshots are generated, on the average, monthly for
 +            all actively developed branches.  There are also
 +            daily snapshot builds of the popular &arch.i386;
 +            and &arch.amd64 branches, hosted on
 +            <ulink
 url=http://snapshots.us.freebsd.org/>snapshots.us.freebsd.org</ulink>.</para>
          </answer>
        </qandaentry>
 
 @@ -432,7 +435,7 @@
              only well-tested bug fixes and other small incremental
              enhancements.  FreeBSD-CURRENT, on the other hand, has
              been one unbroken line since 2.0 was released, leading
 -            towards 6.2-RELEASE and beyond.  Just before 6.0-RELEASE, the
 +            towards 6.3-RELEASE and beyond.  Just before 6.0-RELEASE, the
              6-STABLE branch was created, and
              &os.current; became 7-CURRENT.  For more detailed information,
              see <quote><ulink
 url="&url.articles.releng;/release-proc.html#REL-BRANCH">
 @@ -467,7 +470,7 @@
 
          <answer>
           <para>The &a.re; releases a new version of FreeBSD about every
 -           four months, on average.  Release dates are announced well in
 +           eight months, on average.  Release dates are announced well in
             advance, so that the people working on the system know
             when their projects need to be finished and tested.
             A testing period precedes each release, in order to ensure
 @@ -532,7 +535,7 @@
              <listitem>
                <para><ulink
                 url="&url.base;/snapshots/">
 -                Snapshot</ulink> releases are made daily for the
 +                Snapshot</ulink> releases are made monthly for the
                 <link linkend="current">-CURRENT</link> and <link
                 linkend="stable">-STABLE</link> branch, these being
                  of service purely to bleeding-edge testers and
 @@ -561,7 +564,7 @@
            <para>The Problem Report database of all user change requests
              may be queried by using our web-based PR
              <ulink
 -            url="http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query">
 +            url="http://www.FreeBSD.org/cgi/query-pr.cgi?query">
              query</ulink>
              interface.</para>
Responsible-Changed-From-To: freebsd-doc->pgj 
Responsible-Changed-By: pgj 
Responsible-Changed-When: Fri Jun 6 16:20:27 UTC 2008 
Responsible-Changed-Why:  
Take. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=115000 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/115000: commit references a PR
Date: Sat,  7 Jun 2008 02:19:02 +0000 (UTC)

 pgj         2008-06-07 02:18:58 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/books/faq book.sgml 
   Log:
   Update the FAQ:
   - Change the frequency of snapshots from a day to a month
   - Fix a missing closing parenthesis
   - Add snapshot site http://snapshots.us.freebsd.org
   - Generalize the paragraph about development branches
   - Add an 18 months release interval for major versions and
     8 months for minor versions
   - Fix link for the PR query interface
   
   PR:             docs/115000
   Submitted by:   Ben Kaduk <minimarmot at gmail dot com>
   Reviewed by:    danger, trhodes
   Approved by:    gabor (mentor)
   
   Revision  Changes    Path
   1.883     +18 -14    doc/en_US.ISO8859-1/books/faq/book.sgml
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: open->closed 
State-Changed-By: pgj 
State-Changed-When: Sat Jun 7 02:30:32 UTC 2008 
State-Changed-Why:  
Commited with small modifications. Thank you for your submission! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=115000 
>Unformatted:
