Fix some docstrings

command.lua

@@ -27,17 +27,19 @@ local format_usage = function(cmd)
 end
 
 
---- Manages shops config.
+--- Manages shops & config.
 --
 --  @chatcmd server_shop
+--  @param command Command to execute.
+--  @param[opt] params Parameters associated with command.
 --  @usage
---  /server_shop command [params]
+--  /server_shop <command> [<params>]
 --
 --  Commands:
 --  - reload
 --    - Reloads shops configuration.
 --  - register
---    - Registers new shop & adds to configuration.
+--    - Registers new shop & updates configuration.
 --    - parameters: <id> <sell/buy> <name> [product1=value,product2=value,...]
 --  - unregister
 --    - Unregisters shop & updates configuration.

formspec.lua

@@ -154,7 +154,7 @@ end
 --
 --  @function server_shop.get_formspec
 --  @tparam vector pos Shop node coordinates.
---  @tparam player ObjectRef Player to whom the formspec is shown.
+--  @tparam ObjectRef player Player to whom the formspec is shown.
 --  @tparam[opt] bool buyer `true` if the shop in question is a buyer shop (default: false).
 --  @treturn string Formspec formatted string.
 ss.get_formspec = function(id, player, buyer)
@@ -274,7 +274,7 @@ end
 --
 --  @function server_shop.show_formspec
 --  @tparam vector pos Shop node coordinates.
---  @tparam player ObjectRef Player to whom the formspec is shown.
+--  @tparam ObjectRef player Player to whom the formspec is shown.
 --  @tparam[opt] bool buyer (deprecated)
 ss.show_formspec = function(pos, player, buyer)
 	if buyer ~= nil then