aboutsummaryrefslogtreecommitdiffstats
path: root/docs/source/lang/pointer.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/source/lang/pointer.rst')
-rw-r--r--docs/source/lang/pointer.rst21
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