doc: moved the document section "ngx.semaphore" to a better place.

Author: agentzh

README.markdown

@@ -2762,14 +2762,14 @@ Nginx API for Lua
 * [ngx.worker.pid](#ngxworkerpid)
 * [ngx.worker.count](#ngxworkercount)
 * [ngx.worker.id](#ngxworkerid)
+* [ngx.semaphore](#ngxsemaphore)
 * [ndk.set_var.DIRECTIVE](#ndkset_vardirective)
 * [coroutine.create](#coroutinecreate)
 * [coroutine.resume](#coroutineresume)
 * [coroutine.yield](#coroutineyield)
 * [coroutine.wrap](#coroutinewrap)
 * [coroutine.running](#coroutinerunning)
 * [coroutine.status](#coroutinestatus)
-* [ngx.semaphore](#ngxsemaphore)
 
 
 [Back to TOC](#table-of-contents)
@@ -7190,6 +7190,27 @@ This API was first introduced in the `0.9.20` release.
 
 [Back to TOC](#nginx-api-for-lua)
 
+ngx.semaphore
+-------------
+**syntax:** *local semaphore = require "ngx.semaphore"*
+
+This is a Lua module that implements a classic-style semaphore API for efficient synchronizations among
+different "light threads". Sharing the same semaphore among different "light threads" created in different (request)
+contexts are also supported as long as the "light threads" reside in the same NGINX worker process
+and the [lua_code_cache](#lua_code_cache) directive is turned on (which is the default).
+
+This Lua module does not ship with this ngx_lua module itself rather it is shipped with
+the
+[lua-resty-core](https://github.com/openresty/lua-resty-core) library.
+
+Please refer to the [documentation](https://github.com/openresty/lua-resty-core/blob/master/lib/ngx/semaphore.md)
+for this `ngx.semaphore` Lua module in [lua-resty-core](https://github.com/openresty/lua-resty-core)
+for more details.
+
+This feature requires at least ngx_lua `v0.9.21`.
+
+[Back to TOC](#nginx-api-for-lua)
+
 ndk.set_var.DIRECTIVE
 ---------------------
 **syntax:** *res = ndk.set_var.DIRECTIVE_NAME*
@@ -7321,27 +7342,6 @@ This API was first enabled in the `v0.6.0` release.
 
 [Back to TOC](#nginx-api-for-lua)
 
-ngx.semaphore
--------------
-**syntax:** *local semaphore = require "ngx.semaphore"*
-
-This is a Lua module that implements a classic-style semaphore API for efficient synchronizations among
-different "light threads". Sharing the same semaphore among different "light threads" created in different (request)
-contexts are also supported as long as the "light threads" reside in the same NGINX worker process
-and the [lua_code_cache](#lua_code_cache) directive is turned on (which is the default).
-
-This Lua module does not ship with this ngx_lua module itself rather it is shipped with
-the
-[lua-resty-core](https://github.com/openresty/lua-resty-core) library.
-
-Please refer to the [documentation](https://github.com/cuiweixie/lua-resty-core/blob/semaphore/lib/ngx/semaphore.md)
-for this `ngx.semaphore` Lua module in [lua-resty-core](https://github.com/openresty/lua-resty-core)
-for more details.
-
-This feature requires at least ngx_lua `v0.9.21`.
-
-[Back to TOC](#nginx-api-for-lua)
-
 Obsolete Sections
 =================
 

doc/HttpLuaModule.wiki

@@ -6081,6 +6081,24 @@ See also [[#ngx.worker.count|ngx.worker.count]].
 
 This API was first introduced in the <code>0.9.20</code> release.
 
+== ngx.semaphore ==
+'''syntax:''' ''local semaphore = require "ngx.semaphore"''
+
+This is a Lua module that implements a classic-style semaphore API for efficient synchronizations among
+different "light threads". Sharing the same semaphore among different "light threads" created in different (request)
+contexts are also supported as long as the "light threads" reside in the same NGINX worker process
+and the [[#lua_code_cache|lua_code_cache]] directive is turned on (which is the default).
+
+This Lua module does not ship with this ngx_lua module itself rather it is shipped with
+the
+[https://github.com/openresty/lua-resty-core lua-resty-core] library.
+
+Please refer to the [https://github.com/openresty/lua-resty-core/blob/master/lib/ngx/semaphore.md documentation]
+for this <code>ngx.semaphore</code> Lua module in [https://github.com/openresty/lua-resty-core lua-resty-core]
+for more details.
+
+This feature requires at least ngx_lua <code>v0.9.21</code>.
+
 == ndk.set_var.DIRECTIVE ==
 '''syntax:''' ''res = ndk.set_var.DIRECTIVE_NAME''
 
@@ -6190,24 +6208,6 @@ This API was first usable in the context of [[#init_by_lua|init_by_lua*]] since
 
 This API was first enabled in the <code>v0.6.0</code> release.
 
-== ngx.semaphore ==
-'''syntax:''' ''local semaphore = require "ngx.semaphore"''
-
-This is a Lua module that implements a classic-style semaphore API for efficient synchronizations among
-different "light threads". Sharing the same semaphore among different "light threads" created in different (request)
-contexts are also supported as long as the "light threads" reside in the same NGINX worker process
-and the [[#lua_code_cache|lua_code_cache]] directive is turned on (which is the default).
-
-This Lua module does not ship with this ngx_lua module itself rather it is shipped with
-the
-[https://github.com/openresty/lua-resty-core lua-resty-core] library.
-
-Please refer to the [https://github.com/openresty/lua-resty-core/blob/master/lib/ngx/semaphore.md documentation]
-for this <code>ngx.semaphore</code> Lua module in [https://github.com/openresty/lua-resty-core lua-resty-core]
-for more details.
-
-This feature requires at least ngx_lua <code>v0.9.21</code>.
-
 = Obsolete Sections =
 
 This section is just holding obsolete documentation sections that have been either renamed or removed so that existing links over the web are still valid.