From ca73b67b1d079b0398892953541020574ad34c1e Mon Sep 17 00:00:00 2001
From: Fredrik Ekre <fredrik.ekre@chalmers.se>
Date: Mon, 23 Apr 2018 09:06:15 +0200
Subject: [PATCH] example of return values and stdout printing

---
 examples/example.jl | 23 +++++++++++++++++++----
 1 file changed, 19 insertions(+), 4 deletions(-)

diff --git a/examples/example.jl b/examples/example.jl
index 55f4f76..1382160 100644
--- a/examples/example.jl
+++ b/examples/example.jl
@@ -44,6 +44,20 @@ x + y
 
 x * y
 
+#' ### Output Capturing
+#' Code chunks are by default placed in Documenter `@example` blocks in the generated
+#' markdown. This means that the output will be captured in a block when Documenter is
+#' building the docs. In notebooks the output is captured in output cells, if the
+#' `execute` keyword argument is set to true. Output to `stdout`/`stderr` is also
+#' captured.
+
+function foo()
+    println("This string is printed to stdout.")
+    return [1, 2, 3, 4]
+end
+
+foo()
+
 #' ### Custom processing
 #'
 #' It is possible to give Literate custom pre- and post-processing functions.
@@ -60,9 +74,10 @@ MYVARIABLE = MYVALUE
 #' For example, [here is a link](@ref documenter-interaction), but it is only
 #' visible as a link if you are reading the markdown output. We can also
 #' use equations:
+#'
 #' ```math
-#' \int f(x) dx
+#' \int_\Omega \nabla v \cdot \nabla u\ \mathrm{d}\Omega = \int_\Omega v f\ \mathrm{d}\Omega
 #' ```
-#' using Documenters math syntax. This is automatically changed to
-#' `\begin{equation} ... \end{equation}` in the notebook output to display
-#' correctly in the notebook too.
+#'
+#' using Documenters math syntax. Documenters syntax is automatically changed to
+#' `\begin{equation} ... \end{equation}` in the notebook output to display correctly.