docs(pl.class): Clarify what arguments to class constructor are

lua/pl/class.lua

@@ -45,15 +45,15 @@ end
 
 --- initializes an __instance__ upon creation.
 -- @function class:_init
--- @param ... parameters passed to the constructor
+-- @param ... input parameters passed to the constructor
 -- @usage local Cat = class()
 -- function Cat:_init(name)
 --   --self:super(name)   -- call the ancestor initializer if needed
 --   self.name = name
 -- end
 --
--- local pussycat = Cat("pussycat")
--- print(pussycat.name)  --> pussycat
+-- local pussycat = Cat("sparkles")
+-- print(pussycat.name)  --> sparkles
 
 --- checks whether an __instance__ is derived from some class.
 -- Works the other way around as `class_of`. It has two ways of using;
@@ -210,9 +210,9 @@ end
 -- The second form creates a variable `Name` in the current environment set
 -- to the class, and also sets `_name`.
 -- @function class
--- @param base optional base class
--- @param c_arg optional parameter to class constructor
--- @param c optional table to be used as class
+-- @param base optional base class to derive from
+-- @param c_arg optional parameter passed to class constructor
+-- @param c optional table of methods to be used populate the class
 local class
 class = setmetatable({},{
     __call = function(fun,...)