cplusplus/draft — pull request #238 by godbyk (2013-11-27 08:31:56+00:00)
Title: Fixed nesting bugs for notes and examples

I replaced `\enterexample` and `\exitexample` with `\begin{example}` and `\end{example}`, respectively. Similarly for `\enternote` and `\exitnote`.

By using environments, LaTeX can detect missing `\end{...}` markers and incorrectly nested environments (i.e., closing the outer environment before closing the inner environment).

The side effects of this change are that any new markup should make the following changes:

* Change `\enterexample` to `\begin{example}`.
* Change `\exitexample` to `\end{example}`.
* Change `\enternote` to `\begin{note}`.
* Change `\exitnote` to `\end{note}`.
* Change `\note` to `\remark`. (Because `\note` conflicts with `\begin{note}`. The output is the same as it was previously.)
* Change `\notes` to `\remarks`. (For consistency. The output is the same as it was previously.)