From 86dd93e67cf057decf10914c2a4b8b830e052a2e Mon Sep 17 00:00:00 2001
From: steve donovan <steve.j.donovan@gmail.com>
Date: Mon, 19 Sep 2011 15:53:43 +0200
Subject: [PATCH] prepare ldoc.lua for self-documentation

---
 config.ld         |  2 +-
 html/ldoc_ltp.lua |  2 +-
 ldoc.lua          | 22 ++++++++++++++++------
 3 files changed, 18 insertions(+), 8 deletions(-)

diff --git a/config.ld b/config.ld
index e3b49f3..34b198d 100644
--- a/config.ld
+++ b/config.ld
@@ -2,5 +2,5 @@ project='LDoc'
 title='LDoc documentation'
 description='A Lua documentation tool'
 format='markdown'
-file='ldoc.luadoc'
+file='ldoc.lua'
 readme='docs/doc.md'
diff --git a/html/ldoc_ltp.lua b/html/ldoc_ltp.lua
index 9404f6d..29435a8 100644
--- a/html/ldoc_ltp.lua
+++ b/html/ldoc_ltp.lua
@@ -201,7 +201,7 @@ return [==[
 </div> <!-- id="content" -->
 </div> <!-- id="main" -->
 <div id="about">
-<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 0.7</a></i>
+<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.0</a></i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/ldoc.lua b/ldoc.lua
index f9bb7ac..942350c 100644
--- a/ldoc.lua
+++ b/ldoc.lua
@@ -1,8 +1,14 @@
 ---------------
 -- ldoc, a Lua documentation generator.
 -- Compatible with luadoc-style annoations, but providing
--- easier customization options. C/C++ support is provided.
--- Steve Donovan, 2011
+-- easier customization options.
+--
+-- C/C++ support for Lua extensions is provided.
+--
+-- @author Steve Donovan
+-- @copyright 2011
+-- @license MIT/X11
+-- @script ldoc
 
 require 'pl'
 
@@ -13,8 +19,9 @@ local lapp = require 'pl.lapp'
 -- so we can find our private modules
 app.require_here()
 
-local args = lapp [[
-ldoc, a documentation generator for Lua, vs 0.6
+--- @usage
+local usage = [[
+ldoc, a documentation generator for Lua, vs 1.0.0
   -d,--dir (default docs) output directory
   -o,--output  (default 'index') output name
   -v,--verbose          verbose
@@ -32,9 +39,12 @@ ldoc, a documentation generator for Lua, vs 0.6
   -c,--config (default config.ld) configuration name
   --dump                debug output dump
   --filter (default none) filter output as Lua data (e.g pl.pretty.dump)
-  --tags (default none) show all references to a given tag
+  --tags (default none) show all references to given tags, comma-separated
   <file> (string) source file or directory containing source
+
+  `ldoc .` means read options from an `config.ld` file in same directory.
 ]]
+local args = lapp(usage)
 
 local doc = require 'ldoc.doc'
 local lang = require 'ldoc.lang'
@@ -373,7 +383,7 @@ if type(ldoc.readme) == 'string' then
    item.postprocess = function(txt) return ldoc.markup(txt,F) end
 end
 
----- extract modules from the file objects, resolve references and sort appropriately ---
+-- extract modules from the file objects, resolve references and sort appropriately ---
 
 local project = ProjectMap()