Finished converting the Arduino docs

1 files changed, 12 insertions, 9 deletions

diff --git a/docs/source/lang/pointer.rst b/docs/source/lang/pointer.rst
index bc48d7d..0a42270 100644
--- a/docs/source/lang/pointer.rst
+++ b/docs/source/lang/pointer.rst
@@ -1,15 +1,19 @@
 .. _lang-pointer:
 
-The pointer operators: & (reference) and \* (dereference)
-=========================================================
+Pointer Operators (``&``, ``*``)
+================================
 
+The pointer operators ``&`` (reference) and ``*`` (dereference) are
+different from the bitwise math operator :ref:`&
+<lang-bitwisemath-and>` and the arithmetic operator :ref:`*
+<lang-arithmetic>`.
 
 Pointers are one of the more complicated subjects for beginners in
-learning C, and it is possible to write the vast majority of
-Arduino sketches without ever encountering pointers. However for
-manipulating certain data structures, the use of pointers can
-simplify the code, and and knowledge of manipulating pointers is
-handy to have in one's toolkit.
+learning C, and it is possible to write many useful Arduino sketches
+without ever encountering pointers. However, for manipulating certain
+data structures, the use of pointers can simplify the code, improve
+its efficiency, and generally provide many benefits that would be
+difficult to achieve without the use of pointers.
 
 Introducing pointers is somewhat outside the scope of this
 documentation.  However, a good `pointer tutorial
@@ -20,9 +24,8 @@ the section on `pointers in C
 <http://en.wikipedia.org/wiki/Pointer_%28computing%29#C_pointers>`_.
 
 See Also
-========
+--------
 
 - http://xkcd.com/138/
 
-
 .. include:: cc-attribution.txt