Re: [PATCH] documentation: Add disclaimer

Peter Zijlstra [off-list ref] wrote:

+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+DISCLAIMER
+=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
+
+This document is not a specification; it is intentionally (for the sake=

 of

+brevity) and unintentionally (due to being human) incomplete. This docu=

ment is

+meant as a guide to using the various memory barriers provided by Linux=

, but

+in case of any doubt (and there are many) please ask.
+
+I repeat, this document is not a specification of what Linux expects fr=

om

+hardware.

The purpose of this document is twofold:

 (1) to specify the minimum functionality that one can rely on for any
     particular barrier, and

 (2) to provide a guide as to how to use the barriers that are available.

Note that an architecture can provide more than the minimum requirement fo=
r
any particular barrier, but if the barrier provides less than that, it is
incorrect.

Note also that it is possible that a barrier may be a no-op for an
architecture because the way that arch works renders an explicit barrier
unnecessary in that case.

+

Can you bung an extra blank line in here if you have to redo this at all?

+=3D=3D=3D=3D=3D=3D=3D=3D
+CONTENTS
+=3D=3D=3D=3D=3D=3D=3D=3D
 =

  (*) Abstract memory access model.
 =

David