Bug 115000

Summary: [PATCH] nits and updates to FAQs (part 1)
Product: Documentation Reporter: minimarmot <minimarmot>
Component: Books & ArticlesAssignee: Gabor Pali <pgj>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff none

Description minimarmot 2007-07-29 03:40:01 UTC
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.

Fix: Patch attached with submission follows:
Comment 1 minimarmot 2007-07-29 03:52:22 UTC
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
Comment 2 minimarmot 2007-09-15 16:12:01 UTC
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
Comment 3 minimarmot 2007-09-22 18:33:49 UTC
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>
Comment 4 Gabor Pali freebsd_committer freebsd_triage 2008-06-06 17:20:27 UTC
Responsible Changed
From-To: freebsd-doc->pgj

Take.
Comment 5 dfilter service freebsd_committer freebsd_triage 2008-06-07 03:19:02 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"
Comment 6 Gabor Pali freebsd_committer freebsd_triage 2008-06-07 03:30:32 UTC
State Changed
From-To: open->closed

Commited with small modifications. Thank you for your submission!