[PATCH] LangRef: Clarify expectations of volatile ld/st vs volatile intrinsics.

[Sean Silva]

On Wed, Jan 30, 2013 at 4:20 PM, Andrew Trick <atrick at apple.com> wrote:
> Thanks for the feedback. I moved the commentary to the commit log with your edits.
> Committed r173974.
> -Andy

Please keep the rationale with it!

reStructuredText does have footnotes, see
<http://sphinx-doc.org/rest.html#footnotes>.

Another possibility is to use:

.. admonition:: Rationale

   Explanation of the rationale.

You can see that in action in
<http://clang.llvm.org/docs/AutomaticReferenceCounting.html#retainable-object-pointers>
(although LLVM's stylesheet is different and makes the plain
admonition stand out a bit more).

-- Sean Silva