Add the \sagelisting macro and associated machinery.

[mjotex.git] / examples.tex

diff --git a/examples.tex b/examples.tex
index a43b26ef3fb89c9a341c6b57b8af3127112a3781..b6c4ae1ef56117d0ef0f7f81d9a8d8eaddf35250 100644 (file)
--- a/examples.tex
+++ b/examples.tex
@@ -168,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,
@@ -181,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}