diff --git a/UserManual.md b/UserManual.md
index b4c6aa4c0b1038f1300c79363a0f39043615977e..e2006a1e8583b320f44cf77e1c377dd9d37c6060 100644
--- a/UserManual.md
+++ b/UserManual.md
@@ -279,6 +279,50 @@ must be for a file name only, not including directory name. Example:
mongoose -hide_files_patterns secret.txt|even_more_secret.txt
+# Lua Server Pages
+Pre-built Windows and Mac mongoose binaries have built-in Lua Server Pages
+support. That means it is possible to write PHP-like scripts with mongoose,
+using Lua programming language instead of PHP. Lua is known
+for it's speed and small size. Mongoose uses Lua version 5.2.1, the
+documentation for it can be found at
+[Lua 5.2 reference manual](http://www.lua.org/manual/5.2/).
+
+To create a Lua Page, make sure a file has `.lp` extension. For example,
+let's say it is going to be `my_page.lp`. The contents of the file, just like
+with PHP, is HTML with embedded Lua code. Lua code must be enclosed in
+`<? ?>` blocks, and can appear anywhere on the page. For example, to
+print current weekday name, one can write:
+
+ <p>
+ <span>Today is:</span>
+ <? print(os.date("%A")) ?>
+ </p>
+
+Note that this example uses function `print()`, which prints data to the
+web page. Using function `print()` is the way to generate web content from
+inside Lua code. In addition to `print()`, all standard library functions
+are accessible from the Lua code (please check reference manual for details),
+and also information about the request is available in `request_info` object,
+like request method, all headers, etcetera. Please refer to
+`struct mg_request_info` definition in
+[mongoose.h](https://github.com/valenok/mongoose/blob/master/mongoose.h)
+to see what kind of information is present in `request_info` object. Also,
+[page.lp](https://github.com/valenok/mongoose/blob/master/test/page.lp)
+contains some example code that uses `request_info`.
+
+
+One substantial difference of mongoose's Lua Pages and PHP is that Mongoose
+expects Lua page to output HTTP headers. Therefore, **at the very beginning of
+every Lua Page must be a Lua block that outputs HTTP headers**, like this:
+
+ <? print('HTTP/1.0 200 OK\r\nContent-Type: text/html\r\n\r\n') ?>
+ <html><body>
+ ... the rest of the web page ...
+
+It is easy to do things like redirects, for example:
+
+ <? print('HTTP/1.0 302 Found\r\nLocation: http://google.com\r\n\r\n') ?>
+
# Common Problems
- PHP doesn't work - getting empty page, or 'File not found' error. The
reason for that is wrong paths to the interpreter. Remember that with PHP,
diff --git a/test/page.lp b/test/page.lp
index 5024acb79e2f5e3a1d891f4bbe343146e90e4859..02be3382458d1ffb4ecd6a3cfebcbe85fc36f745 100644
--- a/test/page.lp
+++ b/test/page.lp
@@ -2,6 +2,7 @@
-- Lua server pages have full control over the output, including HTTP
-- headers they send to the client. Send HTTP headers:
print('HTTP/1.0 200 OK\r\nContent-Type: text/html\r\n\r\n')
+
?><html><body>
<p>This is an example Lua server page served by
@@ -10,6 +11,14 @@ Mongoose has Lua, Sqlite, and other functionality built in the binary.
This example page stores the request in the Sqlite database, and shows
all requests done previously.</p>
+ <p> Today is <? print(os.date("%A")) ?>
+ <p> HTTP headers: <br>
+ <?
+ for name, value in pairs(request_info.http_headers) do
+ print(name, ' : ', value, '<br>')
+ end
+ ?>
+
<pre>
<?
-- Open database