From 01e8df2e53cfd31d9c4c88f9854281392ccaf6ed Mon Sep 17 00:00:00 2001
From: Albert Krewinkel <albert@zeitkraut.de>
Date: Sun, 30 Apr 2017 11:24:48 +0200
Subject: [PATCH] Lua module: add example for usage of `read`

---
 data/pandoc.lua | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/data/pandoc.lua b/data/pandoc.lua
index 46155a575..bb79724aa 100644
--- a/data/pandoc.lua
+++ b/data/pandoc.lua
@@ -797,9 +797,19 @@ M.UpperAlpha = "UpperAlpha"
 -- @section helpers
 
 --- Parse the given string into a Pandoc document.
--- @tparam string markup the markup to be parsed
+-- The method used to interpret input is specified by *format*. Acceptable
+-- values for this parameter are equal to those that can be given to the
+-- `--from` command line option.
+-- @tparam      string markup the markup to be parsed
 -- @tparam[opt] string format format specification, defaults to "markdown".
 -- @return Doc pandoc document
+-- @usage
+-- local org_markup = "/emphasis/"  -- Input to be read
+-- local document = pandoc.read(org_markup, "org")
+-- -- Get the first block of the document
+-- local block = document.blocks[1]
+-- -- The inline element in that block is an `Emph`
+-- assert(block.content[1].t == "Emph")
 function M.read(markup, format)
   format = format or "markdown"
   local pd = pandoc.__read(format, markup)