SQL: functions docs update (#34000)

* Changed the format of the String functions documentation page.
* Adopted the same format for Math functions, but completely changed the examples.
* Added missing documentation for Math functions.

docs/reference/sql/functions/math.asciidoc

@@ -8,68 +8,276 @@ to be numeric.
 
 ==== Generic
 
-* `ABS`
+[[sql-functions-math-abs]]
+===== `ABS`
 
-https://en.wikipedia.org/wiki/Absolute_value[Absolute value], returns \[same type as input]
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+ABS(numeric_exp<1>)
+--------------------------------------------------
+
+*Input*:
+
+<1> numeric expression
+
+*Output*: numeric
+
+.Description:
+
+Returns the https://en.wikipedia.org/wiki/Absolute_value[absolute value] of `numeric_exp`. The return type is the same as the input type.
+
+["source","sql",subs="attributes,macros"]
+--------------------------------------------------
+include-tagged::{sql-specs}/docs.csv-spec[abs]
+--------------------------------------------------
+
+[[sql-functions-math-cbrt]]
+===== `CBRT`
+
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+CBRT(numeric_exp<1>)
+--------------------------------------------------
+
+*Input*:
+
+<1> numeric expression
+
+*Output*: double numeric value
+
+.Description:
+
+Returns the https://en.wikipedia.org/wiki/Cube_root[cube root] of `numeric_exp`.
+
+["source","sql",subs="attributes,macros"]
+--------------------------------------------------
+include-tagged::{sql-specs}/docs.csv-spec[mathInlineCbrtWithNegativeValue]
+--------------------------------------------------
+
+[[sql-functions-math-ceil]]
+===== `CEIL/CEILING`
+
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+CEIL(numeric_exp<1>)
+CEILING(numeric_exp<2>)
+--------------------------------------------------
+
+*Input*:
+
+<1> numeric expression
+<2> numeric expression
+
+*Output*: integer or long numeric value
+
+.Description:
+
+Returns the smallest integer greater than or equal to `numeric_exp`.
+
+["source","sql",subs="attributes,macros"]
+--------------------------------------------------
+include-tagged::{sql-specs}/docs.csv-spec[mathInlineCeiling]
+--------------------------------------------------
+
+[[sql-functions-math-e]]
+===== `E`
+
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+E()
+--------------------------------------------------
+
+*Input*: _none_
+
+*Output*: `2.718281828459045`
+
+.Description:
+
+Returns https://en.wikipedia.org/wiki/E_%28mathematical_constant%29[Euler's number].
+
+["source","sql",subs="attributes,macros"]
+--------------------------------------------------
+include-tagged::{sql-specs}/docs.csv-spec[mathEulersNumber]
+--------------------------------------------------
+
+[[sql-functions-math-exp]]
+===== `EXP`
+
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+EXP(numeric_exp<1>)
+--------------------------------------------------
+
+*Input*:
+
+<1> float numeric expression
+
+*Output*: double numeric value
+
+.Description:
+
+Returns https://en.wikipedia.org/wiki/Exponential_function[Euler's number at the power] of `numeric_exp` e^numeric_exp^.
+
+["source","sql",subs="attributes,macros"]
+--------------------------------------------------
+include-tagged::{sql-specs}/docs.csv-spec[mathExpInline]
+--------------------------------------------------
+
+[[sql-functions-math-expm1]]
+===== `EXPM1`
+
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+EXPM1(numeric_exp<1>)
+--------------------------------------------------
+
+*Input*:
 
-["source","sql",subs="attributes,callouts,macros"]
+<1> float numeric expression
+
+*Output*: double numeric value
+
+.Description:
+
+Returns https://docs.oracle.com/javase/8/docs/api/java/lang/Math.html#expm1-double-[Euler's number at the power] of `numeric_exp` minus 1 (e^numeric_exp^ - 1).
+
+["source","sql",subs="attributes,macros"]
 --------------------------------------------------
-include-tagged::{sql-specs}/math.sql-spec[abs]
+include-tagged::{sql-specs}/docs.csv-spec[mathExpm1Inline]
 --------------------------------------------------
 
-* `CBRT`
+[[sql-functions-math-floor]]
+===== `FLOOR`
 
-https://en.wikipedia.org/wiki/Cube_root[Cube root], returns `double`
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+FLOOR(numeric_exp<1>)
+--------------------------------------------------
 
-// TODO make the example in the tests presentable
+*Input*:
 
-* `CEIL`
+<1> numeric expression
 
-https://en.wikipedia.org/wiki/Floor_and_ceiling_functions[Ceiling], returns `double`
+*Output*: integer or long numeric value
 
-* `CEILING`
+.Description:
 
-Same as `CEIL`
+Returns the largest integer less than or equal to `numeric_exp`.
 
-// TODO make the example in the tests presentable
+["source","sql",subs="attributes,macros"]
+--------------------------------------------------
+include-tagged::{sql-specs}/docs.csv-spec[mathInlineFloor]
+--------------------------------------------------
 
-* `E`
+[[sql-functions-math-log]]
+===== `LOG`
 
-https://en.wikipedia.org/wiki/E_%28mathematical_constant%29[Euler's number], returns `2.7182818284590452354`
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+LOG(numeric_exp<1>)
+--------------------------------------------------
 
-* https://en.wikipedia.org/wiki/Exponential_function[e^x^] (`EXP`)
+*Input*:
 
-["source","sql",subs="attributes,callouts,macros"]
+<1> numeric expression
+
+*Output*: double numeric value
+
+.Description:
+
+Returns the https://en.wikipedia.org/wiki/Natural_logarithm[natural logarithm] of `numeric_exp`.
+
+["source","sql",subs="attributes,macros"]
 --------------------------------------------------
-include-tagged::{sql-specs}/math.sql-spec[exp]
+include-tagged::{sql-specs}/docs.csv-spec[mathInlineLog]
 --------------------------------------------------
 
-* https://docs.oracle.com/javase/8/docs/api/java/lang/Math.html#expm1-double-[e^x^ - 1] (`EXPM1`)
+[[sql-functions-math-log10]]
+===== `LOG10`
 
-["source","sql",subs="attributes,callouts,macros"]
+.Synopsis:
+[source, sql]
 --------------------------------------------------
-include-tagged::{sql-specs}/math.sql-spec[expm1]
+LOG10(numeric_exp<1>)
 --------------------------------------------------
 
-* https://en.wikipedia.org/wiki/Floor_and_ceiling_functions[Floor] (`FLOOR`)
+*Input*:
+
+<1> numeric expression
+
+*Output*: double numeric value
 
-// TODO make the example in the tests presentable
+.Description:
 
-* https://en.wikipedia.org/wiki/Natural_logarithm[Natural logarithm] (`LOG`)
+Returns the https://en.wikipedia.org/wiki/Common_logarithm[base 10 logarithm] of `numeric_exp`.
 
-["source","sql",subs="attributes,callouts,macros"]
+["source","sql",subs="attributes,macros"]
 --------------------------------------------------
-include-tagged::{sql-specs}/math.sql-spec[log]
+include-tagged::{sql-specs}/docs.csv-spec[mathInlineLog10]
 --------------------------------------------------
 
-* https://en.wikipedia.org/wiki/Logarithm[Logarithm] base 10 (`LOG10`)
+[[sql-functions-math-pi]]
+===== `PI`
 
-["source","sql",subs="attributes,callouts,macros"]
+.Synopsis:
+[source, sql]
 --------------------------------------------------
-include-tagged::{sql-specs}/math.sql-spec[log10]
+PI()
 --------------------------------------------------
 
-* `ROUND`
+*Input*: _none_
+
+*Output*: `3.141592653589793`
+
+.Description:
+
+Returns https://en.wikipedia.org/wiki/Pi[PI number].
+
+["source","sql",subs="attributes,macros"]
+--------------------------------------------------
+include-tagged::{sql-specs}/docs.csv-spec[mathPINumber]
+--------------------------------------------------
+
+[[sql-functions-math-power]]
+===== `POWER`
+
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+POWER(numeric_exp<1>, integer_exp<2>)
+--------------------------------------------------
+
+*Input*:
+
+<1> numeric expression
+<2> integer expression
+
+*Output*: double numeric value
+
+.Description:
+
+Returns the value of `numeric_exp` to the power of `integer_exp`.
+
+["source","sql",subs="attributes,macros"]
+--------------------------------------------------
+include-tagged::{sql-specs}/docs.csv-spec[mathInlinePowerPositive]
+--------------------------------------------------
+
+["source","sql",subs="attributes,macros"]
+--------------------------------------------------
+include-tagged::{sql-specs}/docs.csv-spec[mathInlinePowerNegative]
+--------------------------------------------------
+
+[[sql-functions-math-round]]
+===== `ROUND`
 
 .Synopsis:
 [source, sql]
@@ -78,8 +286,8 @@ ROUND(numeric_exp<1>[, integer_exp<2>])
 ----
 *Input*:
 
- <1> numeric expression
- <2> integer expression; optional
+<1> numeric expression
+<2> integer expression; optional
 
 *Output*: numeric 
 
@@ -89,24 +297,67 @@ Returns `numeric_exp` rounded to `integer_exp` places right of the decimal point
 the function will perform as if `integer_exp` would be 0. The returned numeric data type is the same as the data type 
 of `numeric_exp`.
 
-["source","sql",subs="attributes,callouts,macros"]
+["source","sql",subs="attributes,macros"]
 --------------------------------------------------
 include-tagged::{sql-specs}/docs.csv-spec[mathRoundWithPositiveParameter]
 --------------------------------------------------
 
-["source","sql",subs="attributes,callouts,macros"]
+["source","sql",subs="attributes,macros"]
 --------------------------------------------------
 include-tagged::{sql-specs}/docs.csv-spec[mathRoundWithNegativeParameter]
 --------------------------------------------------
 
-* https://en.wikipedia.org/wiki/Square_root[Square root] (`SQRT`)
+[[sql-functions-math-sign]]
+===== `SIGN`
 
-["source","sql",subs="attributes,callouts,macros"]
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+SIGN(numeric_exp<1>)
+--------------------------------------------------
+
+*Input*:
+
+<1> numeric expression
+
+*Output*: [-1, 0, 1]
+
+.Description:
+
+Returns an indicator of the sign of `numeric_exp`. If `numeric_exp` is less than zero, –1 is returned. If `numeric_exp` equals zero, 0 is returned. If `numeric_exp` is greater than zero, 1 is returned.
+
+["source","sql",subs="attributes,macros"]
 --------------------------------------------------
-include-tagged::{sql-specs}/math.sql-spec[sqrt]
+include-tagged::{sql-specs}/docs.csv-spec[mathInlineSign]
 --------------------------------------------------
 
-* `TRUNCATE`
+
+[[sql-functions-math-sqrt]]
+===== `SQRT`
+
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+SQRT(numeric_exp<1>)
+--------------------------------------------------
+
+*Input*:
+
+<1> numeric expression
+
+*Output*: double numeric value
+
+.Description:
+
+Returns https://en.wikipedia.org/wiki/Square_root[square root] of `numeric_exp`.
+
+["source","sql",subs="attributes,macros"]
+--------------------------------------------------
+include-tagged::{sql-specs}/docs.csv-spec[mathInlineSqrt]
+--------------------------------------------------
+
+[[sql-functions-math-truncate]]
+===== `TRUNCATE`
 
 .Synopsis:
 [source, sql]
@@ -115,8 +366,8 @@ TRUNCATE(numeric_exp<1>[, integer_exp<2>])
 ----
 *Input*:
 
- <1> numeric expression
- <2> integer expression; optional
+<1> numeric expression
+<2> integer expression; optional
 
 *Output*: numeric 
 
@@ -126,86 +377,305 @@ Returns `numeric_exp` truncated to `integer_exp` places right of the decimal poi
 the function will perform as if `integer_exp` would be 0. The returned numeric data type is the same as the data type 
 of `numeric_exp`.
 
-["source","sql",subs="attributes,callouts,macros"]
+["source","sql",subs="attributes,macros"]
 --------------------------------------------------
 include-tagged::{sql-specs}/docs.csv-spec[mathTruncateWithPositiveParameter]
 --------------------------------------------------
 
-["source","sql",subs="attributes,callouts,macros"]
+["source","sql",subs="attributes,macros"]
 --------------------------------------------------
 include-tagged::{sql-specs}/docs.csv-spec[mathTruncateWithNegativeParameter]
 --------------------------------------------------
 
 ==== Trigonometric
 
-* Convert from https://en.wikipedia.org/wiki/Radian[radians]
-to https://en.wikipedia.org/wiki/Degree_(angle)[degrees] (`DEGREES`)
+[[sql-functions-math-acos]]
+===== `ACOS`
 
-["source","sql",subs="attributes,callouts,macros"]
+.Synopsis:
+[source, sql]
 --------------------------------------------------
-include-tagged::{sql-specs}/math.sql-spec[degrees]
+ACOS(numeric_exp<1>)
 --------------------------------------------------
 
-* Convert from https://en.wikipedia.org/wiki/Degree_(angle)[degrees]
-to https://en.wikipedia.org/wiki/Radian[radians] (`RADIANS`)
+*Input*:
+
+<1> numeric expression
+
+*Output*: double numeric value
+
+.Description:
 
-["source","sql",subs="attributes,callouts,macros"]
+Returns the https://en.wikipedia.org/wiki/Inverse_trigonometric_functions[arccosine] of `numeric_exp` as an angle, expressed in radians.
+
+["source","sql",subs="attributes,macros"]
 --------------------------------------------------
-include-tagged::{sql-specs}/math.sql-spec[degrees]
+include-tagged::{sql-specs}/docs.csv-spec[mathInlineAcos]
 --------------------------------------------------
 
-* https://en.wikipedia.org/wiki/Trigonometric_functions#sine[Sine] (`SIN`)
+[[sql-functions-math-asin]]
+===== `ASIN`
 
-["source","sql",subs="attributes,callouts,macros"]
+.Synopsis:
+[source, sql]
 --------------------------------------------------
-include-tagged::{sql-specs}/math.sql-spec[sin]
+ASIN(numeric_exp<1>)
 --------------------------------------------------
 
-* https://en.wikipedia.org/wiki/Trigonometric_functions#cosine[Cosine] (`COS`)
+*Input*:
+
+<1> numeric expression
 
-["source","sql",subs="attributes,callouts,macros"]
+*Output*: double numeric value
+
+.Description:
+
+Returns the https://en.wikipedia.org/wiki/Inverse_trigonometric_functions[arcsine] of `numeric_exp` as an angle, expressed in radians.
+
+["source","sql",subs="attributes,macros"]
 --------------------------------------------------
-include-tagged::{sql-specs}/math.sql-spec[cos]
+include-tagged::{sql-specs}/docs.csv-spec[mathInlineAsin]
 --------------------------------------------------
 
-* https://en.wikipedia.org/wiki/Trigonometric_functions#tangent[Tangent] (`TAN`)
+[[sql-functions-math-atan]]
+===== `ATAN`
 
-["source","sql",subs="attributes,callouts,macros"]
+.Synopsis:
+[source, sql]
 --------------------------------------------------
-include-tagged::{sql-specs}/math.sql-spec[tan]
+ATAN(numeric_exp<1>)
 --------------------------------------------------
 
-* https://en.wikipedia.org/wiki/Inverse_trigonometric_functions[Arc sine] (`ASIN`)
+*Input*:
+
+<1> numeric expression
+
+*Output*: double numeric value
+
+.Description:
+
+Returns the https://en.wikipedia.org/wiki/Inverse_trigonometric_functions[arctangent] of `numeric_exp` as an angle, expressed in radians.
 
-["source","sql",subs="attributes,callouts,macros"]
+["source","sql",subs="attributes,macros"]
 --------------------------------------------------
-include-tagged::{sql-specs}/math.sql-spec[asin]
+include-tagged::{sql-specs}/docs.csv-spec[mathInlineAtan]
 --------------------------------------------------
 
-* https://en.wikipedia.org/wiki/Inverse_trigonometric_functions[Arc cosine] (`ACOS`)
+[[sql-functions-math-atan2]]
+===== `ATAN2`
 
-["source","sql",subs="attributes,callouts,macros"]
+.Synopsis:
+[source, sql]
 --------------------------------------------------
-include-tagged::{sql-specs}/math.sql-spec[acos]
+ATAN2(ordinate<1>, abscisa<2>)
 --------------------------------------------------
 
-* https://en.wikipedia.org/wiki/Inverse_trigonometric_functions[Arc tangent] (`ATAN`)
+*Input*:
+
+<1> numeric expression
+<2> numeric expression
+
+*Output*: double numeric value
+
+.Description:
+
+Returns the https://en.wikipedia.org/wiki/Atan2[arctangent of the `ordinate` and `abscisa` coordinates] specified as an angle, expressed in radians.
 
-["source","sql",subs="attributes,callouts,macros"]
+["source","sql",subs="attributes,macros"]
 --------------------------------------------------
-include-tagged::{sql-specs}/math.sql-spec[atan]
+include-tagged::{sql-specs}/docs.csv-spec[mathInlineAtan2]
 --------------------------------------------------
 
-* https://en.wikipedia.org/wiki/Hyperbolic_function[Hyperbolic sine] (`SINH`)
+[[sql-functions-math-cos]]
+===== `COS`
 
-["source","sql",subs="attributes,callouts,macros"]
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+COS(numeric_exp<1>)
+--------------------------------------------------
+
+*Input*:
+
+<1> numeric expression
+
+*Output*: double numeric value
+
+.Description:
+
+Returns the https://en.wikipedia.org/wiki/Trigonometric_functions#cosine[cosine] of `numeric_exp`, where `numeric_exp` is an angle expressed in radians.
+
+["source","sql",subs="attributes,macros"]
+--------------------------------------------------
+include-tagged::{sql-specs}/docs.csv-spec[mathInlineCosine]
+--------------------------------------------------
+
+[[sql-functions-math-cosh]]
+===== `COSH`
+
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+COSH(numeric_exp<1>)
+--------------------------------------------------
+
+*Input*:
+
+<1> numeric expression
+
+*Output*: double numeric value
+
+.Description:
+
+Returns the https://en.wikipedia.org/wiki/Hyperbolic_function[hyperbolic cosine] of `numeric_exp`.
+
+["source","sql",subs="attributes,macros"]
+--------------------------------------------------
+include-tagged::{sql-specs}/docs.csv-spec[mathInlineCosh]
+--------------------------------------------------
+
+[[sql-functions-math-cot]]
+===== `COT`
+
+.Synopsis:
+[source, sql]
 --------------------------------------------------
-include-tagged::{sql-specs}/math.sql-spec[sinh]
+COT(numeric_exp<1>)
 --------------------------------------------------
 
-* https://en.wikipedia.org/wiki/Hyperbolic_function[Hyperbolic cosine] (`COSH`)
+*Input*:
+
+<1> numeric expression
+
+*Output*: double numeric value
+
+.Description:
+
+Returns the https://en.wikipedia.org/wiki/Trigonometric_functions#Cosecant,_secant,_and_cotangent[cotangent] of `numeric_exp`, where `numeric_exp` is an angle expressed in radians.
+
+["source","sql",subs="attributes,macros"]
+--------------------------------------------------
+include-tagged::{sql-specs}/docs.csv-spec[mathInlineCotangent]
+--------------------------------------------------
+
+[[sql-functions-math-degrees]]
+===== `DEGREES`
+
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+DEGREES(numeric_exp<1>)
+--------------------------------------------------
+
+*Input*:
+
+<1> numeric expression
+
+*Output*: double numeric value
+
+.Description:
+
+Convert from https://en.wikipedia.org/wiki/Radian[radians]
+to https://en.wikipedia.org/wiki/Degree_(angle)[degrees].
+
+["source","sql",subs="attributes,macros"]
+--------------------------------------------------
+include-tagged::{sql-specs}/docs.csv-spec[mathInlineDegrees]
+--------------------------------------------------
+
+[[sql-functions-math-radians]]
+===== `RADIANS`
+
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+RADIANS(numeric_exp<1>)
+--------------------------------------------------
+
+*Input*:
+
+<1> numeric expression
+
+*Output*: double numeric value
+
+.Description:
+
+Convert from https://en.wikipedia.org/wiki/Degree_(angle)[degrees]
+to https://en.wikipedia.org/wiki/Radian[radians].
+
+["source","sql",subs="attributes,macros"]
+--------------------------------------------------
+include-tagged::{sql-specs}/docs.csv-spec[mathInlineRadians]
+--------------------------------------------------
+
+[[sql-functions-math-sin]]
+===== `SIN`
+
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+SIN(numeric_exp<1>)
+--------------------------------------------------
+
+*Input*:
+
+<1> numeric expression
+
+*Output*: double numeric value
+
+.Description:
+
+Returns the https://en.wikipedia.org/wiki/Trigonometric_functions#sine[sine] of `numeric_exp`, where `numeric_exp` is an angle expressed in radians.
+
+["source","sql",subs="attributes,macros"]
+--------------------------------------------------
+include-tagged::{sql-specs}/docs.csv-spec[mathInlineSine]
+--------------------------------------------------
+
+[[sql-functions-math-sinh]]
+===== `SINH`
+
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+SINH(numeric_exp<1>)
+--------------------------------------------------
+
+*Input*:
+
+<1> numeric expression
+
+*Output*: double numeric value
+
+.Description:
+
+Returns the https://en.wikipedia.org/wiki/Hyperbolic_function[hyperbolic sine] of `numeric_exp`.
+
+["source","sql",subs="attributes,macros"]
+--------------------------------------------------
+include-tagged::{sql-specs}/docs.csv-spec[mathInlineSinh]
+--------------------------------------------------
+
+[[sql-functions-math-tan]]
+===== `TAN`
+
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+TAN(numeric_exp<1>)
+--------------------------------------------------
+
+*Input*:
+
+<1> numeric expression
+
+*Output*: double numeric value
+
+.Description:
+
+Returns the https://en.wikipedia.org/wiki/Trigonometric_functions#tangent[tangent] of `numeric_exp`, where `numeric_exp` is an angle expressed in radians.
 
-["source","sql",subs="attributes,callouts,macros"]
+["source","sql",subs="attributes,macros"]
 --------------------------------------------------
-include-tagged::{sql-specs}/math.sql-spec[cosh]
+include-tagged::{sql-specs}/docs.csv-spec[mathInlineTanget]
 --------------------------------------------------

docs/reference/sql/functions/string.asciidoc

@@ -8,233 +8,456 @@ Functions for performing string manipulation.
 [[sql-functions-string-ascii]]
 ==== `ASCII`
 
-*Input*: `string`, *Output*: `integer`
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+ASCII(string_exp<1>)
+--------------------------------------------------
 
-Returns the ASCII code value of the leftmost character of string_exp as an integer.
+*Input*:
+
+<1> string expression
+
+*Output*: integer
+
+.Description:
+
+Returns the ASCII code value of the leftmost character of `string_exp` as an integer.
 
 ["source","sql",subs="attributes,callouts,macros"]
-----
+--------------------------------------------------
 include-tagged::{sql-specs}/docs.csv-spec[stringAscii]
-----
+--------------------------------------------------
 
 [[sql-functions-string-bit-length]]
 ==== `BIT_LENGTH`
 
-*Input*: `string`, *Output*: `integer`
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+BIT_LENGTH(string_exp<1>)
+--------------------------------------------------
+*Input*:
 
-Returns the length in bits of the input.
+<1> string expression
+
+*Output*: integer
+
+.Description:
+
+Returns the length in bits of the `string_exp` input expression.
 
 ["source","sql",subs="attributes,callouts,macros"]
-----
+--------------------------------------------------
 include-tagged::{sql-specs}/docs.csv-spec[stringBitLength]
-----
+--------------------------------------------------
 
 [[sql-functions-string-char]]
 ==== `CHAR`
 
-*Input*: `numeric`, *Output*: `string`
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+CHAR(code<1>)
+--------------------------------------------------
+*Input*:
+
+<1> integer expression
+
+*Output*: string
+
+.Description:
 
 Returns the character that has the ASCII code value specified by the numeric input. The value should be between 0 and 255; otherwise, the return value is data source–dependent.
 
 ["source","sql",subs="attributes,callouts,macros"]
-----
+--------------------------------------------------
 include-tagged::{sql-specs}/docs.csv-spec[stringChar]
-----
+--------------------------------------------------
 
 [[sql-functions-string-char-length]]
 ==== `CHAR_LENGTH`
 
-*Input*: `string`, *Output*: `integer`
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+CHAR_LENGTH(string_exp<1>)
+--------------------------------------------------
+*Input*:
+
+<1> string expression
+
+*Output*: integer
+
+.Description:
 
 Returns the length in characters of the input, if the string expression is of a character data type; otherwise, returns the length in bytes of the string expression (the smallest integer not less than the number of bits divided by 8).
 
 ["source","sql",subs="attributes,callouts,macros"]
-----
+--------------------------------------------------
 include-tagged::{sql-specs}/docs.csv-spec[stringCharLength]
-----
+--------------------------------------------------
 
 [[sql-functions-string-concat]]
 ==== `CONCAT`
 
-*Input*: `string1`, `string2`, *Output*: `string`
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+CONCAT(string_exp1<1>,string_exp2<2>)
+--------------------------------------------------
+*Input*:
+
+<1> string expression
+<2> string expression
+
+*Output*: string
 
-turns a character string that is the result of concatenating string1 to string2. If one of the string is `NULL`,
-the other string will be returned.
+.Description:
+
+Returns a character string that is the result of concatenating `string_exp1` to `string_exp2`. If one of the string is `NULL`, the other string will be returned.
 
 ["source","sql",subs="attributes,callouts,macros"]
-----
+--------------------------------------------------
 include-tagged::{sql-specs}/docs.csv-spec[stringConcat]
-----
+--------------------------------------------------
 
 [[sql-functions-string-insert]]
 ==== `INSERT`
 
-*Input*: `string1`, `start`, `length`, `string2`, *Output*: `string`
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+INSERT(source<1>, start<2>, length<3>, replacement<4>)
+--------------------------------------------------
+*Input*:
+
+<1> string expression
+<2> integer expression
+<3> integer expression
+<4> string expression
+
+*Output*: string
+
+.Description:
 
-Returns a string where length characters have been deleted from string1, beginning at start, and where string2 has been inserted into string1, beginning at start.
+Returns a string where `length` characters have been deleted from `source`, beginning at `start`, and where `replacement` has been inserted into `source`, beginning at `start`.
 
 ["source","sql",subs="attributes,callouts,macros"]
-----
+--------------------------------------------------
 include-tagged::{sql-specs}/docs.csv-spec[stringInsert]
-----
+--------------------------------------------------
 
 [[sql-functions-string-lcase]]
 ==== `LCASE`
 
-*Input*: `string`, *Output*: `string`
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+LCASE(string_exp<1>)
+--------------------------------------------------
+*Input*:
+
+<1> string expression
+
+*Output*: string
+
+.Description:
 
-Returns a string equal to that in string, with all uppercase characters converted to lowercase.
+Returns a string equal to that in `string_exp`, with all uppercase characters converted to lowercase.
 
 ["source","sql",subs="attributes,callouts,macros"]
-----
+--------------------------------------------------
 include-tagged::{sql-specs}/docs.csv-spec[stringLCase]
-----
+--------------------------------------------------
 
 [[sql-functions-string-left]]
 ==== `LEFT`
 
-*Input*: `string`, *Output*: `string`
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+LEFT(string_exp<1>, count<2>)
+--------------------------------------------------
+*Input*:
 
-Returns the leftmost count characters of string.
+<1> string expression
+<2> integer expression
+
+*Output*: string
+
+.Description:
+
+Returns the leftmost count characters of `string_exp`.
 
 ["source","sql",subs="attributes,callouts,macros"]
-----
+--------------------------------------------------
 include-tagged::{sql-specs}/docs.csv-spec[stringLeft]
-----
+--------------------------------------------------
 
 [[sql-functions-string-length]]
 ==== `LENGTH`
 
-*Input*: `string`, *Output*: `integer`
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+LENGTH(string_exp<1>)
+--------------------------------------------------
+*Input*:
+
+<1> string expression
 
-Returns the number of characters in string, excluding trailing blanks.
+*Output*: integer
+
+.Description:
+
+Returns the number of characters in `string_exp`, excluding trailing blanks.
 
 ["source","sql",subs="attributes,callouts,macros"]
-----
+--------------------------------------------------
 include-tagged::{sql-specs}/docs.csv-spec[stringLength]
-----
+--------------------------------------------------
 
 [[sql-functions-string-locate]]
 ==== `LOCATE`
 
-*Input*: `string1`, `string2`[, `start`]`, *Output*: `integer`
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+LOCATE(pattern<1>, source<2>[, start]<3>)
+--------------------------------------------------
+*Input*:
+
+<1> string expression
+<2> string expression
+<3> integer expression; optional
 
-Returns the starting position of the first occurrence of string1 within string2. The search for the first occurrence of string1 begins with the first character position in string2 unless the optional argument, start, is specified. If start is specified, the search begins with the character position indicated by the value of start. The first character position in string2 is indicated by the value 1. If string1 is not found within string2, the value 0 is returned.
+*Output*: integer
+
+.Description:
+
+Returns the starting position of the first occurrence of `pattern` within `source`. The search for the first occurrence of `pattern` begins with the first character position in `source` unless the optional argument, `start`, is specified. If `start` is specified, the search begins with the character position indicated by the value of `start`. The first character position in `source` is indicated by the value 1. If `pattern` is not found within `source`, the value 0 is returned.
 
 ["source","sql",subs="attributes,callouts,macros"]
-----
+--------------------------------------------------
 include-tagged::{sql-specs}/docs.csv-spec[stringLocateWoStart]
-----
+--------------------------------------------------
 
 ["source","sql",subs="attributes,callouts,macros"]
-----
+--------------------------------------------------
 include-tagged::{sql-specs}/docs.csv-spec[stringLocateWithStart]
-----
+--------------------------------------------------
 
 [[sql-functions-string-ltrim]]
 ==== `LTRIM`
 
-*Input*: `string`, *Output*: `string`
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+LTRIM(string_exp<1>)
+--------------------------------------------------
+*Input*:
+
+<1> string expression
+
+*Output*: string
 
-Returns the characters of string_exp, with leading blanks removed.
+.Description:
+
+Returns the characters of `string_exp`, with leading blanks removed.
 
 ["source","sql",subs="attributes,callouts,macros"]
-----
+--------------------------------------------------
 include-tagged::{sql-specs}/docs.csv-spec[stringLTrim]
-----
+--------------------------------------------------
 
 [[sql-functions-string-position]]
 ==== `POSITION`
 
-*Input*: `string1`, `string2`, *Output*: `integer`
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+POSITION(string_exp1<1>, string_exp2<2>)
+--------------------------------------------------
+*Input*:
+
+<1> string expression
+<2> string expression
+
+*Output*: integer
+
+.Description:
 
-Returns the position of the string1 in string2. The result is an exact numeric.
+Returns the position of the `string_exp1` in `string_exp2`. The result is an exact numeric.
 
 ["source","sql",subs="attributes,callouts,macros"]
-----
+--------------------------------------------------
 include-tagged::{sql-specs}/docs.csv-spec[stringPosition]
-----
+--------------------------------------------------
 
 [[sql-functions-string-repeat]]
 ==== `REPEAT`
 
-*Input*: `string`, `count`, *Output*: `string`
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+REPEAT(string_exp<1>, count<2>)
+--------------------------------------------------
+*Input*:
 
-Returns a character string composed of string1 repeated count times.
+<1> string expression
+<2> integer expression
+
+*Output*: string
+
+.Description:
+
+Returns a character string composed of `string_exp` repeated `count` times.
 
 ["source","sql",subs="attributes,callouts,macros"]
-----
+--------------------------------------------------
 include-tagged::{sql-specs}/docs.csv-spec[stringRepeat]
-----
+--------------------------------------------------
 
 [[sql-functions-string-replace]]
 ==== `REPLACE`
 
-*Input*: `string1`, `string2`, `string3`, *Output*: `string`
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+REPLACE(source<1>, pattern<2>, replacement<3>)
+--------------------------------------------------
+*Input*:
+
+<1> string expression
+<2> string expression
+<3> string expression
 
-Search string1 for occurrences of string2, and replace with string3.
+*Output*: string
+
+.Description:
+
+Search `source` for occurrences of `pattern`, and replace with `replacement`.
 
 ["source","sql",subs="attributes,callouts,macros"]
-----
+--------------------------------------------------
 include-tagged::{sql-specs}/docs.csv-spec[stringReplace]
-----
+--------------------------------------------------
 
 [[sql-functions-string-right]]
 ==== `RIGHT`
 
-*Input*: `string`, `count`, *Output*: `string`
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+RIGHT(string_exp<1>, count<2>)
+--------------------------------------------------
+*Input*:
+
+<1> string expression
+<2> integer expression
 
-Returns the rightmost count characters of string.
+*Output*: string
+
+.Description:
+
+Returns the rightmost count characters of `string_exp`.
 
 ["source","sql",subs="attributes,callouts,macros"]
-----
+--------------------------------------------------
 include-tagged::{sql-specs}/docs.csv-spec[stringRight]
-----
+--------------------------------------------------
 
 [[sql-functions-string-rtrim]]
 ==== `RTRIM`
 
-*Input*: `string`, *Output*: `string`
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+RTRIM(string_exp<1>)
+--------------------------------------------------
+*Input*:
+
+<1> string expression
+
+*Output*: string
 
-Returns the characters of string with trailing blanks removed.
+.Description:
+
+Returns the characters of `string_exp` with trailing blanks removed.
 
 ["source","sql",subs="attributes,callouts,macros"]
-----
+--------------------------------------------------
 include-tagged::{sql-specs}/docs.csv-spec[stringRTrim]
-----
+--------------------------------------------------
 
 [[sql-functions-string-space]]
 ==== `SPACE`
 
-*Input*: `integer`, *Output*: `string`
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+SPACE(count<1>)
+--------------------------------------------------
+*Input*:
+
+<1> integer expression
+
+*Output*: string
 
-Returns a character string consisting of count spaces.
+.Description:
+
+Returns a character string consisting of `count` spaces.
 
 ["source","sql",subs="attributes,callouts,macros"]
-----
+--------------------------------------------------
 include-tagged::{sql-specs}/docs.csv-spec[stringSpace]
-----
+--------------------------------------------------
 
 [[sql-functions-string-substring]]
 ==== `SUBSTRING`
 
-*Input*: `string`, `start`, `length`, *Output*: `integer`
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+SUBSTRING(source<1>, start<2>, length<3>)
+--------------------------------------------------
+*Input*:
+
+<1> string expression
+<2> integer expression
+<3> integer expression
+
+*Output*: string
+
+.Description:
 
-Returns a character string that is derived from the string, beginning at the character position specified by `start` for `length` characters.
+Returns a character string that is derived from `source`, beginning at the character position specified by `start` for `length` characters.
 
 ["source","sql",subs="attributes,callouts,macros"]
-----
+--------------------------------------------------
 include-tagged::{sql-specs}/docs.csv-spec[stringSubString]
-----
+--------------------------------------------------
 
 [[sql-functions-string-ucase]]
 ==== `UCASE`
 
-*Input*: `string`, *Output*: `string`
+.Synopsis:
+[source, sql]
+--------------------------------------------------
+UCASE(string_exp<1>)
+--------------------------------------------------
+*Input*:
+
+<1> string expression
+
+*Output*: string
+
+.Description:
 
 Returns a string equal to that of the input, with all lowercase characters converted to uppercase.
 
 ["source","sql",subs="attributes,callouts,macros"]
-----
+--------------------------------------------------
 include-tagged::{sql-specs}/docs.csv-spec[stringUCase]
-----
+--------------------------------------------------

x-pack/qa/sql/src/main/resources/docs.csv-spec

@@ -1126,6 +1126,222 @@ SELECT YEAR(CAST('2018-05-19T11:23:45Z' AS TIMESTAMP)) AS year;
 // end::conversionStringToDateCast
 ;
 
+///////////////////////////////
+//
+// Math
+//
+///////////////////////////////
+
+mathInlineAbs
+// tag::abs
+SELECT ABS(-123.5), ABS(55);
+
+  ABS(-123.5)  |    ABS(55)
+---------------+---------------
+123.5          |55
+// end::abs
+;
+
+mathInlineAcos
+// tag::mathInlineAcos
+SELECT ACOS(COS(PI())), PI();
+
+  ACOS(COS(PI))  |       PI
+-----------------+-----------------
+3.141592653589793|3.141592653589793
+// end::mathInlineAcos
+;
+
+mathInlineAsin
+// tag::mathInlineAsin
+SELECT ROUND(DEGREES(ASIN(0.7071067811865475))) AS "ASIN(0.707)", ROUND(SIN(RADIANS(45)), 3) AS "SIN(45)";
+
+  ASIN(0.707)  |    SIN(45)
+---------------+---------------
+45.0           |0.707
+// end::mathInlineAsin
+;
+
+mathInlineAtan
+// tag::mathInlineAtan
+SELECT DEGREES(ATAN(TAN(RADIANS(90))));
+
+DEGREES(ATAN(TAN(RADIANS(90))))
+-------------------------------
+90.0
+// end::mathInlineAtan
+;
+
+mathInlineAtan2
+// tag::mathInlineAtan2
+SELECT ATAN2(5 * SIN(RADIANS(45)), 5 * COS(RADIANS(45))) AS "ATAN2(5*SIN(45), 5*COS(45))", RADIANS(45);
+
+ATAN2(5*SIN(45), 5*COS(45))|   RADIANS(45)
+---------------------------+------------------
+0.7853981633974483         |0.7853981633974483
+// end::mathInlineAtan2
+;
+
+mathInlineCbrtWithNegativeValue
+// tag::mathInlineCbrtWithNegativeValue
+SELECT CBRT(-125.5);
+
+   CBRT(-125.5)
+-------------------
+-5.0066577974783435
+// end::mathInlineCbrtWithNegativeValue
+;
+
+mathInlineCeiling
+// tag::mathInlineCeiling
+SELECT CEIL(125.01), CEILING(-125.99);
+
+ CEIL(125.01)  | CEIL(-125.99)
+---------------+---------------
+126            |-125
+// end::mathInlineCeiling
+;
+
+mathInlineCosine
+// tag::mathInlineCosine
+SELECT COS(RADIANS(180)), POWER(SIN(RADIANS(54)), 2) + POWER(COS(RADIANS(54)), 2) AS pythagorean_identity;
+
+COS(RADIANS(180))|pythagorean_identity
+-----------------+--------------------
+-1.0             |1.0
+// end::mathInlineCosine
+;
+
+mathInlineCosh
+// tag::mathInlineCosh
+SELECT COSH(5), (POWER(E(), 5) + POWER(E(), -5)) / 2 AS "(e^5 + e^-5)/2";
+
+     COSH(5)     | (e^5 + e^-5)/2
+-----------------+-----------------
+74.20994852478785|74.20994852478783
+// end::mathInlineCosh
+;
+
+mathInlineCotangent
+// tag::mathInlineCotangent
+SELECT COT(RADIANS(30)) AS "COT(30)", COS(RADIANS(30)) / SIN(RADIANS(30)) AS "COS(30)/SIN(30)";
+
+     COT(30)      | COS(30)/SIN(30)
+------------------+------------------
+1.7320508075688774|1.7320508075688776
+// end::mathInlineCotangent
+;
+
+mathInlineDegrees
+// tag::mathInlineDegrees
+SELECT DEGREES(PI() * 2), DEGREES(PI());
+
+DEGREES(((PI) * 2))|  DEGREES(PI)
+-------------------+---------------
+360.0              |180.0
+// end::mathInlineDegrees
+;
+
+mathEulersNumber
+// tag::mathEulersNumber
+SELECT E(), CEIL(E());
+
+        E        |    CEIL(E)
+-----------------+---------------
+2.718281828459045|3
+// end::mathEulersNumber
+;
+
+mathExpInline
+// tag::mathExpInline
+SELECT EXP(1), E(), EXP(2), E() * E();
+
+     EXP(1)      |        E        |     EXP(2)     |   ((E) * (E))
+-----------------+-----------------+----------------+------------------
+2.718281828459045|2.718281828459045|7.38905609893065|7.3890560989306495
+// end::mathExpInline
+;
+
+mathExpm1Inline
+// tag::mathExpm1Inline
+SELECT E(), EXP(2), EXPM1(2);
+
+        E        |     EXP(2)     |    EXPM1(2)
+-----------------+----------------+----------------
+2.718281828459045|7.38905609893065|6.38905609893065
+// end::mathExpm1Inline
+;
+
+mathInlineFloor
+// tag::mathInlineFloor
+SELECT FLOOR(125.01), FLOOR(-125.99);
+
+ FLOOR(125.01) |FLOOR(-125.99)
+---------------+---------------
+125            |-126
+// end::mathInlineFloor
+;
+
+mathInlineLog
+// tag::mathInlineLog
+SELECT EXP(3), LOG(20.085536923187668);
+
+      EXP(3)      |LOG(20.085536923187668)
+------------------+-----------------------
+20.085536923187668|3.0
+// end::mathInlineLog
+;
+
+mathInlineLog10
+// tag::mathInlineLog10
+SELECT LOG10(5), LOG(5)/LOG(10);
+
+     LOG10(5)     |((LOG(5)) / (LOG(10)))
+------------------+----------------------
+0.6989700043360189|0.6989700043360187
+// end::mathInlineLog10
+;
+
+mathPINumber
+// tag::mathPINumber
+SELECT PI();
+
+       PI
+-----------------
+3.141592653589793
+// end::mathPINumber
+;
+
+mathInlinePowerPositive
+// tag::mathInlinePowerPositive
+SELECT POWER(3, 2), POWER(3, 3);
+
+  POWER(3,2)   |  POWER(3,3)
+---------------+---------------
+9.0            |27.0
+// end::mathInlinePowerPositive
+;
+
+mathInlinePowerNegative
+// tag::mathInlinePowerNegative
+SELECT POWER(5, -1), POWER(5, -2);
+
+  POWER(5,-1)  |  POWER(5,-2)
+---------------+---------------
+0.2            |0.04
+// end::mathInlinePowerNegative
+;
+
+mathInlineRadians
+// tag::mathInlineRadians
+SELECT RADIANS(90), PI()/2;
+
+   RADIANS(90)    |    ((PI) / 2)
+------------------+------------------
+1.5707963267948966|1.5707963267948966
+// end::mathInlineRadians
+;
+
 mathRoundWithNegativeParameter
 // tag::mathRoundWithNegativeParameter
 SELECT ROUND(-345.153, -1) AS rounded;
@@ -1146,6 +1362,56 @@ SELECT ROUND(-345.153, 1) AS rounded;
 // end::mathRoundWithPositiveParameter
 ;
 
+mathInlineSign
+// tag::mathInlineSign
+SELECT SIGN(-123), SIGN(0), SIGN(415);
+
+  SIGN(-123)   |    SIGN(0)    |   SIGN(415)
+---------------+---------------+---------------
+-1             |0              |1
+// end::mathInlineSign
+;
+
+mathInlineSine
+// tag::mathInlineSine
+SELECT SIN(RADIANS(90)), POWER(SIN(RADIANS(67)), 2) + POWER(COS(RADIANS(67)), 2) AS pythagorean_identity;
+
+SIN(RADIANS(90))|pythagorean_identity
+----------------+--------------------
+1.0             |1.0
+// end::mathInlineSine
+;
+
+mathInlineSinh
+// tag::mathInlineSinh
+SELECT SINH(5), (POWER(E(), 5) - POWER(E(), -5)) / 2 AS "(e^5 - e^-5)/2";
+
+     SINH(5)     | (e^5 - e^-5)/2
+-----------------+-----------------
+74.20321057778875|74.20321057778874
+// end::mathInlineSinh
+;
+
+mathInlineSqrt
+// tag::mathInlineSqrt
+SELECT SQRT(EXP(2)), E(), SQRT(25);
+
+  SQRT(EXP(2))   |        E        |   SQRT(25)
+-----------------+-----------------+---------------
+2.718281828459045|2.718281828459045|5.0
+// end::mathInlineSqrt
+;
+
+mathInlineTanget
+// tag::mathInlineTanget
+SELECT TAN(RADIANS(66)) AS "TAN(66)", SIN(RADIANS(66))/COS(RADIANS(66)) AS "SIN(66)/COS(66)=TAN(66)";
+
+     TAN(66)      |SIN(66)/COS(66)=TAN(66)
+------------------+-----------------------
+2.2460367739042164|2.246036773904216
+// end::mathInlineTanget
+;
+
 mathTruncateWithNegativeParameter
 // tag::mathTruncateWithNegativeParameter
 SELECT TRUNCATE(-345.153, -1) AS trimmed;
@@ -1164,4 +1430,5 @@ SELECT TRUNCATE(-345.153, 1) AS trimmed;
 ---------------
 -345.1
 // end::mathTruncateWithPositiveParameter
-;
+;
+

x-pack/qa/sql/src/main/resources/math.sql-spec

@@ -3,86 +3,50 @@
 //
 
 mathAbs
-// tag::abs
 SELECT ABS(emp_no) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
-// end::abs
 mathACos
-// tag::acos
 SELECT ACOS(emp_no) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
-// end::acos
 mathASin
-// tag::asin
 SELECT ASIN(emp_no) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
-// end::asin
 mathATan
-// tag::atan
 SELECT ATAN(emp_no) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
-// end::atan
 //mathCbrt
 //SELECT CBRT(emp_no) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
 mathCeil
 // H2 returns CEIL as a double despite the value being an integer; we return a long as the other DBs
 SELECT CAST(CEIL(emp_no) AS INT) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
 mathCos
-// tag::cos
 SELECT COS(emp_no) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
-// end::cos
 mathCosh
-// tag::cosh
 SELECT COSH(emp_no) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
-// end::cosh
 mathCot
-// tag::cot
 SELECT COT(emp_no) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
-// end::cot
 mathDegrees
-// tag::degrees
 SELECT DEGREES(emp_no) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
-// end::degrees
 mathExp
-// tag::exp
 SELECT EXP(emp_no) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
-// end::exp
 mathExpm1
-// tag::expm1
 SELECT EXP(emp_no) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
-// end::expm1
 mathFloor
 SELECT CAST(FLOOR(emp_no) AS INT) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
 mathLog
-// tag::log
 SELECT LOG(emp_no) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
-// end::log
 mathLog10
-// tag::log10
 SELECT LOG10(emp_no) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
-// end::log10
 mathRadians
-// tag::radians
 SELECT RADIANS(emp_no) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
-// end::radians
 mathRound
 SELECT CAST(ROUND(emp_no, 0) AS INT) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
 mathSign
-// tag::sign
 SELECT SIGN(emp_no) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
-// end::sign
 mathSin
-// tag::sin
 SELECT SIN(emp_no) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
-// end::sin
 mathSinH
-// tag::sinh
 SELECT SINH(emp_no) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
-// end::sinh
 mathSqrt
-// tag::sqrt
 SELECT SQRT(emp_no) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
-// end::sqrt
 mathTan
-// tag::tan
 SELECT TAN(emp_no) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
-// end::tan
 
 //
 // Combined methods
@@ -125,15 +89,11 @@ SELECT 5 + 2 * 3 / 2 % 2 AS c, PI() as e, first_name FROM "test_emp" WHERE emp_n
 // binary functions
 // 
 mathATan2
-// tag::atan2
 SELECT ATAN2(emp_no, emp_no) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
-// end::atan2
-// tag::power
 mathPowerPositive
 SELECT POWER(emp_no, 2) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
 mathPowerNegative
 SELECT POWER(salary, -1) m, first_name FROM "test_emp" WHERE emp_no < 10010 ORDER BY emp_no;
-// end::power
 
 roundInline1
 SELECT ROUND(-345.123, -2) AS rounded;