Add the \sagelisting macro and associated machinery.

[mjotex.git] / examples.tex

diff --git a/examples.tex b/examples.tex
index 6e1c5007abf16c19d48f8eadb7c1a03b85a49cab..b6c4ae1ef56117d0ef0f7f81d9a8d8eaddf35250 100644 (file)
--- a/examples.tex
+++ b/examples.tex
@@ -5,6 +5,13 @@
 
 \begin{document}
 
+  \begin{section}{Algebra}
+    If $R$ is a commutative ring, then $\polyring{R}{X,Y,Z}$ is a
+    multivariate polynomial ring with indeterminates $X$, $Y$, and
+    $Z$, and coefficients in $R$. If $R$ is a moreover an integral
+    domain, then its fraction field is $\Frac{R}$.
+  \end{section}
+
   \begin{section}{Algorithm}
     An example of an algorithm (bogosort) environment.
 
@@ -161,7 +168,7 @@
   \end{section}
 
   \begin{section}{Listing}
-    Here's an interactive sage prompt:
+    Here's an interactive SageMath prompt:
 
     \begin{tcblisting}{listing only,
                        colback=codebg,
@@ -174,6 +181,14 @@
     [0 0], [0 0], [1 0], [0 1]
     ]
     \end{tcblisting}
+
+    However, the smart way to display a SageMath listing is to load it
+    from an external file (under the ``listings'' subdirectory):
+
+    \sagelisting{example}
+
+    Keeping the listings in separate files makes it easy for the build
+    system to test them.
   \end{section}
 
   \begin{section}{Miscellaneous}