docs: Update math library docs

Author: statementreply

lib/算經.wy

@@ -166,18 +166,28 @@
 疏曰「「圓周率。同犀之Math.PI也。」」
 今有一數。曰「假圓周率」。名之曰「圓周率」。注曰「「圓周率者。三又一分四釐一毫有奇也。」」
 乘二於「圓周率」。名之曰「假倍圓周率」。
+疏曰「「倍圓周率。同犀之Math.PI * 2也。」」
 今有一數。曰「假倍圓周率」。名之曰「倍圓周率」。
 除二於「圓周率」。名之曰「假半圓周率」。
+疏曰「「半圓周率。同犀之Math.PI / 2也。」」
 今有一數。曰「假半圓周率」。名之曰「半圓周率」。
 除四於「圓周率」。名之曰「假四分圓周率」。
+疏曰「「四分圓周率。同犀之Math.PI / 4也。」」
 今有一數。曰「假四分圓周率」。名之曰「四分圓周率」。
+疏曰「「自然常數。同犀之Math.E也。」」
 今有一數。曰「假自然常數」。名之曰「自然常數」。注曰「「自然常數者。二又七分一釐八毫有奇也。」」
+疏曰「「歐拉常數。同犀之0.5772156649015329也。」」
 今有一數。曰「假歐拉常數」。名之曰「歐拉常數」。注曰「「歐拉常數者。五分七釐七毫二絲有奇也。」」
+疏曰「「黃金分割數。同犀之1.618033988749895也。」」
 今有一數。曰「假黃金分割數」。名之曰「黃金分割數」。注曰「「黃金分割數者。一又六分一釐八毫有奇也。」」
+疏曰「「二之平方根。同犀之Math.SQRT2也。」」
 今有一數。曰「假二之平方根」。名之曰「二之平方根」。注曰「「二之平方根者。一又四分一釐四毫有奇也。」」
+疏曰「「二之對數。同犀之Math.LN2也。」」
 今有一數。曰「假二之對數」。名之曰「二之對數」。注曰「「二之對數者。六分九釐三毫一絲有奇也。」」
+疏曰「「十之對數。同犀之Math.LN10也。」」
 今有一數。曰「假十之對數」。名之曰「十之對數」。注曰「「十之對數者。二又三分零釐二毫有奇也。」」
 
+疏曰「「不可算數乎。同犀之Number.isNaN也。」」
 今有一術。名之曰「不可算數乎」。欲行是術。必先得一數。曰「甲」。乃行是術曰。
 	若「甲」等於「甲」者。乃得陰。
 	若非。乃得陽也。
@@ -379,6 +389,7 @@
 	云云。
 是謂「求多項式」之術也。
 
+疏曰「「浮點移位。同犀之x * Math.pow(2, y), y is integer也。」」
 今有一術。名之曰「浮點移位」。欲行是術。必先得二數。曰「本」。曰「位」。乃行是術曰。
 	注曰「「位正則進位。負則退位。」」
 	若「位」不大於「至大指」者。若「位」不小於「至小指」者。
@@ -414,6 +425,7 @@
 	云云。
 是謂「浮點移位」之術也。
 
+疏曰「「析浮點數。同犀之N/A也。」」
 今有一術。名之曰「析浮點數」。欲行是術。必先得一數。曰「甲」。乃行是術曰。
 	注曰「「是術得一物。物有三數。曰符。曰位。曰本。符者。正負也。位者。進退位也。本者。本數也。」」
 	注曰「「設計算機二進。若施是術於負六。乃得符負一。位二。本一又五分。」」
@@ -600,6 +612,7 @@
 是謂「反正切」之術也。
 
 
+疏曰「「勾股求角。同犀之Math.atan2也。」」
 今有一術。名之曰「勾股求角」。欲行是術。必先得二數曰「甲」。曰「乙」。乃行是術曰。
 	注曰「「反正切之分類討論也」」
 
@@ -617,6 +630,7 @@
 是謂「勾股求角」之術也。
 
 
+疏曰「「勾股求弦。同犀之Math.hypot也。」」
 今有一術。名之曰「勾股求弦」。欲行是術。必先得二數曰「勾」。曰「股」。乃行是術曰。
 	施「絕對」於「勾」。名之曰「甲」。
 	施「絕對」於「股」。名之曰「乙」。
@@ -696,6 +710,7 @@
 	除負一千三百八十二以六億三千八百五十一萬二千八百七十五。充「指數多項式甲」以其。
 注曰「「 x^2 * f(x^2) = x/tanh(x) - 1 」」
 
+疏曰「「指數。同犀之Math.exp也。」」
 今有一術。名之曰「指數」。欲行是術。必先得一數曰「甲」。乃行是術曰。
 	注曰「「自然指數。」」
 	有爻陽。名之曰「非常」。
@@ -841,7 +856,7 @@
 		乃得「甲」也。
 是謂「取底」之術也。
 
-疏曰「「取整。同犀之Math.round也。」」
+疏曰「「取整。同犀之Math.round, but rounded away from zero when the fractional part is exactly 0.5也。」」
 今有一術。名之曰「取整」。欲行是術。必先得一數。曰「甲」。乃行是術曰。
 	施「正負」於「甲」。名之曰「符」。乘「符」於「甲」。名之曰「乙」。
 	除「乙」以一。所餘幾何。名之曰「丙」。
@@ -855,7 +870,7 @@
 		乃得「甲」也。
 是謂「取整」之術也。
 
-疏曰「「取整。同犀之Math.trunc也。」」
+疏曰「「捨餘。同犀之Math.trunc也。」」
 今有一術。名之曰「捨餘」。欲行是術。必先得一數。曰「甲」。乃行是術曰。
 	施「正負」於「甲」。名之曰「符」。乘「符」於「甲」。名之曰「乙」。
 	除「乙」以一。所餘幾何。名之曰「丙」。
@@ -865,6 +880,7 @@
 		乃得「甲」也。
 是謂「捨餘」之術也。
 
+疏曰「「正負。同犀之Math.sign也。」」
 今有一術。名之曰「正負」。欲行是術。必先得一數。曰「甲」。乃行是術曰。
 	若「甲」大於零者。乃得一也。
 	若「甲」小於零者。乃得負一也。

tools/stdlib_doc.js

@@ -32,7 +32,7 @@ This cheatsheet is generated direct from stdlibs. There are still a lot of funct
 
 Add comments in the stdlib files (one line above the function/value), the format should look like this:
 \`\`\`
-疏曰「「下溢。同犀之Math.floor也。」」
+疏曰「「餘弦。同犀之Math.cos也。」」
 \`\`\`
 
 After you fill the comments, you need to run