Date: Fri, 1 May 2009 21:23:35 GMT From: Benedict Reuschling <bcr@doc.bsdgroup.de> To: freebsd-gnats-submit@FreeBSD.org Subject: docs/134147: Unclear sentence (perhaps missing a word), suggestions attached Message-ID: <200905012123.n41LNZKW095575@www.freebsd.org> Resent-Message-ID: <200905012130.n41LU1FJ026975@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>Number: 134147
>Category: docs
>Synopsis: Unclear sentence (perhaps missing a word), suggestions attached
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Fri May 01 21:30:01 UTC 2009
>Closed-Date:
>Last-Modified:
>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:
>Unformatted:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200905012123.n41LNZKW095575>