Updated API documentation.

Author: orbitalquark

Makefile

@@ -6,8 +6,8 @@ ta = ../..
 cwd = $(shell pwd)
 docs: README.md
 README.md: init.lua
-	cd $(ta)/scripts && ldoc --filter markdowndoc.ldoc $(cwd)/$< > $(cwd)/$@
-	sed -i -e '1,+4d' -e '6c# Lua REPL' -e '7d' -e 's/^##/#/;' $@
+	cd $(ta)/scripts && ldoc --filter markdowndoc.ldoc $(cwd)/$< -- --title="Lua REPL" --single \
+		> $(cwd)/$@
 
 # Releases.
 

README.md

@@ -8,64 +8,61 @@ This is an alternative to the single-line Lua command entry.
 Install this module by copying it into your *~/.textadept/modules/* directory or Textadept's
 *modules/* directory, and then putting the following in your *~/.textadept/init.lua*:
 
-	require('lua_repl')
+```lua
+local lua_repl = require('lua_repl')
+```
 
 Select "Tools > Lua REPL" to open the REPL. Typing the Enter key on any line evaluates that
 line, unless that line is a continuation line. In that case, when finished, select the lines
 to evaluate and type Enter to evaluate the entire chunk.
 
 Lines may be optionally prefixed with '=' (similar to the Lua prompt) to print a result.
 
-## Fields defined by `lua_repl`
-
-<a id="lua_repl.history"></a>
-### `lua_repl.history` &lt;table&gt;
-
-Lua command history.
-It has a numeric `pos` field that indicates where in the history the user currently is.
-
-Fields:
-
-- `pos`: 
-
-<a id="lua_repl.keys"></a>
-### `lua_repl.keys` &lt;table&gt;
-
-Table of key bindings for the REPL.
-
-
-## Functions defined by `lua_repl`
-
 <a id="lua_repl.complete_lua"></a>
-### `lua_repl.complete_lua`()
+## `lua_repl.complete_lua`()
 
 Shows a set of Lua code completions for the current position.
 
 <a id="lua_repl.cycle_history_next"></a>
-### `lua_repl.cycle_history_next`()
+## `lua_repl.cycle_history_next`()
 
 Cycle forward through command history, taking into account commands with multiple lines.
 
 <a id="lua_repl.cycle_history_prev"></a>
-### `lua_repl.cycle_history_prev`()
+## `lua_repl.cycle_history_prev`()
 
 Cycle backward through command history, taking into account commands with multiple lines.
 
 <a id="lua_repl.evaluate_repl"></a>
-### `lua_repl.evaluate_repl`()
+## `lua_repl.evaluate_repl`()
 
 Evaluates as Lua code the current line or the text on the currently selected lines.
+
 If the current line has a syntax error, it is ignored and treated as a line continuation.
 
+<a id="lua_repl.history"></a>
+## `lua_repl.history`
+
+Lua command history.
+
+It has a numeric `pos` field that indicates where in the history the user currently is.
+
+Fields:
+
+- `pos`: 
+
+<a id="lua_repl.keys"></a>
+## `lua_repl.keys`
+
+Table of key bindings for the REPL.
+
 <a id="lua_repl.open"></a>
-### `lua_repl.open`(*new*)
+## `lua_repl.open`([*new*=false])
 
 Creates or switches to a Lua REPL.
-If *new* is `true`, creates a new REPL even if one already exists.
 
 Parameters:
+- *new*:  Create a new REPL even if one already exists.
 
-- *new*:  Flag that indicates whether or not to create a new REPL even if one already exists.
 
 
----

init.lua

@@ -2,13 +2,14 @@
 
 --- A Textadept module for loading an interactive Lua REPL using the editor's Lua State, similar
 -- to Lua's interactive REPL.
---
 -- This is an alternative to the single-line Lua command entry.
 --
 -- Install this module by copying it into your *~/.textadept/modules/* directory or Textadept's
 -- *modules/* directory, and then putting the following in your *~/.textadept/init.lua*:
 --
---	require('lua_repl')
+-- ```lua
+-- local lua_repl = require('lua_repl')
+-- ```
 --
 -- Select "Tools > Lua REPL" to open the REPL. Typing the Enter key on any line evaluates that
 -- line, unless that line is a continuation line. In that case, when finished, select the lines
@@ -175,8 +176,7 @@ end
 events.connect(events.RESET_AFTER, register_keys)
 
 --- Creates or switches to a Lua REPL.
--- If *new* is `true`, creates a new REPL even if one already exists.
--- @param new Flag that indicates whether or not to create a new REPL even if one already exists.
+-- @param[opt=false] new Create a new REPL even if one already exists.
 function M.open(new)
 	local repl_view, repl_buf = nil, nil
 	for i = 1, #_VIEWS do