cleaning up previous commits.

note that addition of new files under docs/source/lang/api and
docs/source/lang/cpp which were just copies of files in
docs/source/lang/ imply that change history is lost to git.

1 files changed, 0 insertions, 127 deletions

diff --git a/docs/source/lang/arithmetic.rst b/docs/source/lang/arithmetic.rst
deleted file mode 100644
index 91fe22e..0000000
--- a/docs/source/lang/arithmetic.rst
+++ /dev/null
@@ -1,127 +0,0 @@
-.. highlight:: cpp
-
-.. _lang-arithmetic:
-
-Arithmetic Operators (``+``, ``-``, ``*``, ``/``)
-=================================================
-
-The operators ``+``, ``-``, ``*``, and ``/`` respectively evaluate to
-the sum, difference, product, or quotient (respectively) of the two
-operands. The operation is conducted using the data type of the
-operands, so, for example, ``9 / 4`` gives ``2`` since 9 and 4 are
-:ref:`int variables <lang-int>`.
-
-This also means that the operation can overflow if the result is
-larger than that which can be stored in the data type (e.g. adding 1
-to an :ref:`lang-int` with the value 2,147,483,647 gives
--2,147,483,648).
-
-.. _lang-arithmetic-typeconversion:
-
-If the operands are of different types, the "larger" type is used for
-the calculation.  If one of the numbers (operands) are of the type
-**float** or of type **double**, floating point math will be used for
-the calculation.
-
-.. note:: The specifics of these rules are beyond the scope of this
-   documentation; for more information, see `The C++ Programming
-   Language <http://www2.research.att.com/~bs/3rd.html>`_\ , by Bjarne
-   Stroustroup, Appendix C, especially §§C.4-C.6, or `this WikiBooks
-   entry on C++ type conversion
-   <http://en.wikibooks.org/wiki/C%2B%2B_Programming/Programming_Languages/C%2B%2B/Code/Statements/Variables/Type_Casting#Automatic_type_conversion>`_.
-
-.. note:: For more information on how computers represent integers,
-   see the Wikipedia page on `two's complement
-   <http://en.wikipedia.org/wiki/Two's_complement>`_.
-
-.. contents:: Contents
-   :local:
-
-Examples
---------
-
- ::
-
-    y = y + 3;
-    x = x - 7;
-    i = j * 6;
-    r = r / 5;
-
-
-Syntax
-------
-
- ::
-
-    result = value1 + value2;
-    result = value1 - value2;
-    result = value1 * value2;
-    result = value1 / value2;
-
-
-Parameters
-----------
-
-**value1**: any numeric variable or constant
-
-**value2**: any numeric variable or constant
-
-Programming Tips
-----------------
-
-- Know that :ref:`integer constants <lang-constants-integers>`
-  default to :ref:`int <lang-int>`, so some constant calculations
-  may overflow (e.g., 200000 * 5000000 will yield a negative result).
-
-- Choose variable sizes that are large enough to hold the largest
-  results from your calculations.
-
-- Know at what point your variable will "roll over" and also what
-  happens in the other direction e.g. (0 - 1) for unsigned arithmetic,
-  or (0 - -2,147,483,648) for signed arithmetic.
-
-- For math that requires fractions, float variables may be used, but
-  be aware of their drawbacks: large size and slow computation speeds
-  (the STM32 has no floating point hardware, so all floating point
-  calculations have to be done in software).
-
-- Use cast operator, e.g. ``(int)myFloat`` to convert one variable type
-  to another on the fly.
-
-Arduino Compatibility
----------------------
-
-Since the STM32 processor on the Maple is a 32-bit machine, the int
-type overflows at a much higher value on Maple than on Arduino.  In
-particular, on Maple, ints do not overflow (become negative) until
-they reach 2,147,483,648; on the Arduino, they overflow at 32,767.
-Because of this, programs running on Maple are much less likely to run
-into overflow issues.  The following table summarizes the sizes and
-ranges of integer datatypes on the Maple (the ranges of long long
-types are approximate):
-
-.. _lang-arithmetic-int-sizes:
-
-.. csv-table::
-   :header: Datatype, Unsigned range, Signed range, Size (bytes)
-   :widths: 8, 12, 17, 8
-
-   ``char``, 0 --- 255, -128 --- 127, 1
-   ``short``, "0 --- 65,535", "-32,768 --- 32,767", 2
-   ``int``,  "0 --- 4,294,967,295", "-2,147,483,648 --- 2,147,483,647", 4
-   ``long``, "0 --- 4,294,967,295", "-2,147,483,648 --- 2,147,483,647", 4
-   ``long long``, "0 --- 1.8*10\ :sup:`19`\ " (approx.), "-9.2*10\ :sup:`18` --- 9.2*10\ :sup:`18` (approx.)", 8
-
-
-See Also
---------
-
-- The individual sizes (in bits) of various available types are
-  defined in `libmaple_types.h
-  <http://github.com/leaflabs/libmaple/blob/master/libmaple/libmaple_types.h>`_\
-  .
-
-- :ref:`sizeof <lang-sizeof>`\ ()
-
-
-.. include:: cc-attribution.txt