From e073ef386898aec8595f7a2db4120b1441f6a31f Mon Sep 17 00:00:00 2001
From: Joseph Wright <joseph.wright@morningstar2.co.uk>
Date: Fri, 30 Jun 2017 19:46:46 +0100
Subject: [PATCH] Suggest a way to test entire pages (see #15)

---
 l3build.dtx | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/l3build.dtx b/l3build.dtx
index aee67068..9d7bbc1c 100644
--- a/l3build.dtx
+++ b/l3build.dtx
@@ -920,6 +920,22 @@
 %   \label{fig:box-log}
 % \end{figure}
 %
+% \subsection{Testing entire pages}
+%
+% There may be occasions where creating entire test pages is necessary
+% to observe the test output required. That is best achieved by applying
+% \cs{showoutput} and forcing a complete page to be produced, for example
+% \begin{Verbatim}[frame=single,fontsize=\small]
+% \input{regression-test.tex}
+% \documentclass{article}
+% \usepackage{expl3}
+% \START
+% \showoutput
+% % Test content here
+% \vfil\break
+% \END
+% \end{Verbatim}
+%
 % \subsection{Additional test tasks}
 %
 % A standard test will run the file \texttt{\meta{name}.lvt} using one