feat: add documentation for `gears.math`

lua/gears/math/init.lua

@@ -0,0 +1,50 @@
+--- ### Description
+--- Math module for gears.
+---
+--- [View documents](https://awesomewm.org/apidoc/utility_libraries/gears.math.html)
+local GMath = {}
+
+--- ### Description
+--- Return all subsets of a specific set. This function, giving a set, will return all subset it.
+--- For example, if we consider a set with value `{ 10, 15, 34 }`,
+--- it will return a table containing `2^n` set: `{ }, { 10 }, { 15 }, { 34 }, { 10, 15 }, { 10, 34 }`, etc.
+--- ### Parameters
+--- @param set table A set.
+--- ### Returns
+--- @return table result A table with all subset.
+---
+--- [View documents](https://awesomewm.org/apidoc/utility_libraries/gears.math.html#subsets)
+GMath.subsets = function(set) end
+
+--- ### Description
+--- Make i cycle.
+--- ### Parameters
+--- @param t any A length. Must be greater than zero.
+--- @param i any      An absolute index to fit into `t`.
+--- ### Returns
+--- @return integer | nil result An integer in `(1, t)` or `nil` if `t` is less than or equal to zero.
+---
+--- [View documents](https://awesomewm.org/apidoc/utility_libraries/gears.math.html#cycle)
+GMath.cycle = function(t, i) end
+
+--- ### Description
+--- Round a number to an integer.
+--- ### Parameters
+--- @param x integer Undocumented!
+--- ### Returns
+--- @return integer result Undocumented!
+---
+--- [View documents](https://awesomewm.org/apidoc/utility_libraries/gears.math.html#round)
+GMath.round = function(x) end
+
+--- ### Description
+--- Return the sign of the number `x`.
+--- ### Parameters
+--- @param x number Undocumented!
+--- ### Returns
+--- @return integer result Return `1` if `x` is positive, `-1` if negative and `0` if `x` is `0`.
+---
+--- [View documents](https://awesomewm.org/apidoc/utility_libraries/gears.math.html#sign)
+GMath.sign = function(x) end
+
+return GMath