README: Add header

[etc/awesome.git] / doc / gettime.md

diff --git a/doc/gettime.md b/doc/gettime.md
index 758be60393f9f1656a79a5b194fa47a6dd2476a3..a31e5a09682f465b46b8d2c16038298da8f0bd9d 100644 (file)
--- a/doc/gettime.md
+++ b/doc/gettime.md
@@ -1,11 +1,26 @@
-# `luatz.gettime`
+## `luatz.gettime` <!-- --> {#gettime}
 
 A module to get the current time.
 
+Uses the most precise method available (in order:)
 
-## `gettime ( )`
+  - Use [ljsyscall](http://www.myriabit.com/ljsyscall/) to access
+         - `clock_gettime(2)` called with `CLOCK_REALTIME`
+         - `gettimeofday(2)`
+  - [luasocket](http://w3.impa.br/~diego/software/luasocket/)'s `socket.gettime`
+  - [Openresty](http://openresty.org/)'s [`ngx.now`](http://wiki.nginx.org/HttpLuaModule#ngx.now)
+  - [`os.time`](http://www.lua.org/manual/5.3/manual.html#pdf-os.time)
 
-Uses the most precise method available (in order:)
+### `source` <!-- --> {#gettime.source}
+
+The library/function currently in use by [`gettime()`](#gettime.gettime).
+
+
+### `resolution` <!-- --> {#gettime.resolution}
+
+The smallest time resolution (in seconds) available from [`gettime()`](#gettime.gettime).
+
+
+### `gettime()` <!-- --> {#gettime.gettime}
 
-  - luasocket's `socket.gettime`
-  - `os.time`
+Returns the number of seconds since unix epoch (1970-01-01T00:00:00Z) as a lua number