Re: [PATCH] doc: Fix some typo errors in ras.rst

From: Waiman Long
Date: Wed May 06 2020 - 12:19:44 EST


On 5/5/20 11:48 AM, Matthew Wilcox wrote:
On Tue, May 05, 2020 at 11:10:49AM -0400, Waiman Long wrote:
Fix typo errors.
By reformatting it, you've successfully obscured what typos you've fixed.
As a result I read the whole paragraph, and ...

ECC memory
----------
-As mentioned on the previous section, ECC memory has extra bits to be
-used for error correction. So, on 64 bit systems, a memory module
-has 64 bits of *data width*, and 74 bits of *total width*. So, there are
-8 bits extra bits to be used for the error detection and correction
+As mentioned on the previous section, ECC memory has extra bits to
s/on/in/

+be used for error correction. So, on 64 bit systems, a memory module
+has 64 bits of *data width*, and 72 bits of *total width*.
Usually a 64-bit system refers to the width of a pointer. Here, it's
referring to the width of the memory system, which is rather confusing.
How about "In the above example" instead of "So, on 64 bit systems".

So, there
+are 8 extra bits to be used for the error detection and correction
mechanisms. Those extra bits are called *syndrome*\ [#f1]_\ [#f2]_.
This would read better as:

The extra 8 bits which are used for error detection and correction
are referred to as the *syndrome*\ [#f1]_\ [#f2]_.

Thanks for the suggestion. Will incorporate that in v2.

-Longman