From nobody@FreeBSD.org  Fri May  1 21:23:36 2009
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 12FAB1065675
	for <freebsd-gnats-submit@FreeBSD.org>; Fri,  1 May 2009 21:23:36 +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 EA5318FC0A
	for <freebsd-gnats-submit@FreeBSD.org>; Fri,  1 May 2009 21:23:35 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.3/8.14.3) with ESMTP id n41LNZD8095576
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 1 May 2009 21:23:35 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.3/8.14.3/Submit) id n41LNZKW095575;
	Fri, 1 May 2009 21:23:35 GMT
	(envelope-from nobody)
Message-Id: <200905012123.n41LNZKW095575@www.freebsd.org>
Date: Fri, 1 May 2009 21:23:35 GMT
From: Benedict Reuschling <bcr@doc.bsdgroup.de>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Unclear sentence (perhaps missing a word), suggestions attached
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         134147
>Category:       docs
>Synopsis:       Unclear sentence (perhaps missing a word), suggestions attached
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri May 01 21:30:01 UTC 2009
>Closed-Date:    Fri May 01 22:22:06 UTC 2009
>Last-Modified:  Fri May 01 22:22:06 UTC 2009
>Originator:     Benedict Reuschling
>Release:        7.2-PRERELEASE
>Organization:
The FreeBSD German Documentation Project
>Environment:
FreeBSD atlantis.reuschling.org 7.2-PRERELEASE FreeBSD 7.2-PRERELEASE #18: Thu Apr 23 22:00:35 CEST 2009     root@atlantis.reuschling.org:/tank/obj/usr/src/sys/ATLANTIS  i386
>Description:
The following sentence in the FAQ seems to be missing a word or should be rephrased around the word "causes": 

"There is a known problem when enabling &intel; Enhanced SpeedStep from the BIOS causes the kernel to start printing <errorname>calcru</errorname> messages like this:"

I have attached three suggestions on how to make the sentence more clear.
>How-To-Repeat:
Read the sentence and try to make sense of it as it is. 
>Fix:
Apply one of the following diffs to make the sentence more complete/understandable.

Suggestion 1:
--- book.sgml.orig      2009-05-01 23:04:42.092926621 +0200
+++ book.sgml   2009-05-01 23:05:15.349031797 +0200
@@ -3871,7 +3871,7 @@
        </question>
 
        <answer>
-         <para>There is a known problem when enabling &intel; Enhanced
+         <para>A known problem when enabling &intel; Enhanced
            SpeedStep from the BIOS causes the kernel to start printing
            <errorname>calcru</errorname> messages like this:</para>


Suggestion 2:
--- book.sgml.orig      2009-05-01 23:04:42.092926621 +0200
+++ book.sgml   2009-05-01 23:07:28.640448164 +0200
@@ -3872,7 +3872,7 @@
 
        <answer>
          <para>There is a known problem when enabling &intel; Enhanced
-           SpeedStep from the BIOS causes the kernel to start printing
+           SpeedStep from the BIOS.  It causes the kernel to start printing
            <errorname>calcru</errorname> messages like this:</para>
 
          <screen>calcru: runtime went backwards from 6 usec to 3 usec for pid 37 (pagezero)


Suggestion 3:

--- book.sgml.orig      2009-05-01 23:04:42.092926621 +0200
+++ book.sgml   2009-05-01 23:08:27.557631772 +0200
@@ -3872,7 +3872,7 @@
 
        <answer>
          <para>There is a known problem when enabling &intel; Enhanced
-           SpeedStep from the BIOS causes the kernel to start printing
+           SpeedStep from the BIOS, which causes the kernel to start printing
            <errorname>calcru</errorname> messages like this:</para>
 
          <screen>calcru: runtime went backwards from 6 usec to 3 usec for pid 37 (pagezero)



Patch attached with submission follows:

--- book.sgml.orig	2009-05-01 23:04:42.092926621 +0200
+++ book.sgml	2009-05-01 23:08:27.557631772 +0200
@@ -3872,7 +3872,7 @@
 
 	<answer>
 	  <para>There is a known problem when enabling &intel; Enhanced
-	    SpeedStep from the BIOS causes the kernel to start printing
+	    SpeedStep from the BIOS, which causes the kernel to start printing
 	    <errorname>calcru</errorname> messages like this:</para>
 
 	  <screen>calcru: runtime went backwards from 6 usec to 3 usec for pid 37 (pagezero)


>Release-Note:
>Audit-Trail:

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/134147: commit references a PR
Date: Fri,  1 May 2009 22:18:50 +0000 (UTC)

 manolis     2009-05-01 22:18:36 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/books/faq book.sgml 
   Log:
   Minor language nit
   
   PR:             docs/134147
   Submitted by:   Benedict Reuschling <bcr@doc.bsdgroup.de>
   
   Revision  Changes    Path
   1.1113    +1 -1      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: manolis 
State-Changed-When: Fri May 1 22:21:36 UTC 2009 
State-Changed-Why:  
Committed, thanks! 

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