minor doc fixes

spec/helpers.lua

@@ -103,9 +103,9 @@ do
 end
 
 
----------------
+-- ------------
 -- Conf and DAO
----------------
+-- ------------
 _G.kong = kong_global.new()
 kong_global.init_pdk(_G.kong, conf)
 ngx.ctx.KONG_PHASE = kong_global.phases.access
@@ -1123,11 +1123,9 @@ local MAX_RETRY_TIME = 10
 
 --- Set up admin client and proxy client to so that interactions with the proxy client
 -- wait for preceding admin API client changes to have completed.
-
 -- @function make_synchronized_clients
 -- @param clients table with admin_client and proxy_client fields (both optional)
 -- @return admin_client, proxy_client
-
 local function make_synchronized_clients(clients)
   clients = clients or {}
   local synchronized_proxy_client = clients.proxy_client or proxy_client()

spec/helpers/dns.lua

@@ -36,6 +36,7 @@ end
 
 
 --- Expires a record now.
+-- @param client the DNS client
 -- @param record a DNS record previously created
 function _M.dnsExpire(client, record)
   local dnscache = client.getcache()
@@ -53,7 +54,7 @@ end
 -- local host = "konghq.com"  -- must be the same for all entries obviously...
 -- local rec = dnsSRV(dnsCLient, {
 --   -- defaults: weight = 10, priority = 20, ttl = 600
---   { name = host, target = "20.20.20.20", port = 80, weight = 10, priority = 20, ttl = 600 }, 
+--   { name = host, target = "20.20.20.20", port = 80, weight = 10, priority = 20, ttl = 600 },
 --   { name = host, target = "50.50.50.50", port = 80, weight = 10, priority = 20, ttl = 600 },
 -- })
 function _M.dnsSRV(client, records, staleTtl)