Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[DOCS] Remove inline callouts in SQL Functions/Operators docs for Asciidoctor migration #41309

Merged
merged 1 commit into from
Apr 22, 2019
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 25 additions & 17 deletions docs/reference/sql/functions/aggs.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ Functions for computing a _single_ result from a set of input values.
.Synopsis:
[source, sql]
--------------------------------------------------
AVG(numeric_field<1>)
AVG(numeric_field) <1>
--------------------------------------------------

*Input*:
Expand All @@ -40,7 +40,7 @@ include-tagged::{sql-specs}/docs/docs.csv-spec[aggAvg]
.Synopsis:
[source, sql]
--------------------------------------------------
COUNT(expression<1>)
COUNT(expression) <1>
--------------------------------------------------

*Input*:
Expand Down Expand Up @@ -70,7 +70,7 @@ include-tagged::{sql-specs}/docs/docs.csv-spec[aggCountStar]
.Synopsis:
[source, sql]
--------------------------------------------------
COUNT(ALL field_name<1>)
COUNT(ALL field_name) <1>
--------------------------------------------------

*Input*:
Expand All @@ -95,7 +95,7 @@ include-tagged::{sql-specs}/docs/docs.csv-spec[aggCountAll]
.Synopsis:
[source, sql]
--------------------------------------------------
COUNT(DISTINCT field_name<1>)
COUNT(DISTINCT field_name) <1>
--------------------------------------------------

*Input*:
Expand All @@ -119,7 +119,9 @@ include-tagged::{sql-specs}/docs/docs.csv-spec[aggCountDistinct]
.Synopsis:
[source, sql]
----------------------------------------------
FIRST(field_name<1>[, ordering_field_name]<2>)
FIRST(
field_name <1>
[, ordering_field_name]) <2>
----------------------------------------------

*Input*:
Expand Down Expand Up @@ -214,7 +216,9 @@ the field is also <<before-enabling-fielddata,saved as a keyword>>.
.Synopsis:
[source, sql]
--------------------------------------------------
LAST(field_name<1>[, ordering_field_name]<2>)
LAST(
field_name <1>
[, ordering_field_name]) <2>
--------------------------------------------------

*Input*:
Expand Down Expand Up @@ -309,7 +313,7 @@ the field is also <<before-enabling-fielddata,`saved as a keyword`>>.
.Synopsis:
[source, sql]
--------------------------------------------------
MAX(field_name<1>)
MAX(field_name) <1>
--------------------------------------------------

*Input*:
Expand Down Expand Up @@ -337,7 +341,7 @@ include-tagged::{sql-specs}/docs/docs.csv-spec[aggMax]
.Synopsis:
[source, sql]
--------------------------------------------------
MIN(field_name<1>)
MIN(field_name) <1>
--------------------------------------------------

*Input*:
Expand Down Expand Up @@ -365,7 +369,7 @@ include-tagged::{sql-specs}/docs/docs.csv-spec[aggMin]
.Synopsis:
[source, sql]
--------------------------------------------------
SUM(field_name<1>)
SUM(field_name) <1>
--------------------------------------------------

*Input*:
Expand Down Expand Up @@ -393,7 +397,7 @@ include-tagged::{sql-specs}/docs/docs.csv-spec[aggSum]
.Synopsis:
[source, sql]
--------------------------------------------------
KURTOSIS(field_name<1>)
KURTOSIS(field_name) <1>
--------------------------------------------------

*Input*:
Expand All @@ -417,7 +421,7 @@ include-tagged::{sql-specs}/docs/docs.csv-spec[aggKurtosis]
.Synopsis:
[source, sql]
--------------------------------------------------
MAD(field_name<1>)
MAD(field_name) <1>
--------------------------------------------------

*Input*:
Expand All @@ -441,7 +445,9 @@ include-tagged::{sql-specs}/docs/docs.csv-spec[aggMad]
.Synopsis:
[source, sql]
--------------------------------------------------
PERCENTILE(field_name<1>, numeric_exp<2>)
PERCENTILE(
field_name, <1>
numeric_exp) <2>
--------------------------------------------------

*Input*:
Expand All @@ -467,7 +473,9 @@ include-tagged::{sql-specs}/docs/docs.csv-spec[aggPercentile]
.Synopsis:
[source, sql]
--------------------------------------------------
PERCENTILE_RANK(field_name<1>, numeric_exp<2>)
PERCENTILE_RANK(
field_name, <1>
numeric_exp) <2>
--------------------------------------------------

*Input*:
Expand All @@ -493,7 +501,7 @@ include-tagged::{sql-specs}/docs/docs.csv-spec[aggPercentileRank]
.Synopsis:
[source, sql]
--------------------------------------------------
SKEWNESS(field_name<1>)
SKEWNESS(field_name) <1>
--------------------------------------------------

*Input*:
Expand All @@ -517,7 +525,7 @@ include-tagged::{sql-specs}/docs/docs.csv-spec[aggSkewness]
.Synopsis:
[source, sql]
--------------------------------------------------
STDDEV_POP(field_name<1>)
STDDEV_POP(field_name) <1>
--------------------------------------------------

*Input*:
Expand All @@ -541,7 +549,7 @@ include-tagged::{sql-specs}/docs/docs.csv-spec[aggStddevPop]
.Synopsis:
[source, sql]
--------------------------------------------------
SUM_OF_SQUARES(field_name<1>)
SUM_OF_SQUARES(field_name) <1>
--------------------------------------------------

*Input*:
Expand All @@ -565,7 +573,7 @@ include-tagged::{sql-specs}/docs/docs.csv-spec[aggSumOfSquares]
.Synopsis:
[source, sql]
--------------------------------------------------
VAR_POP(field_name<1>)
VAR_POP(field_name) <1>
--------------------------------------------------

*Input*:
Expand Down
38 changes: 20 additions & 18 deletions docs/reference/sql/functions/date-time.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -146,7 +146,7 @@ include-tagged::{sql-specs}/docs/docs.csv-spec[filterToday]
[source, sql]
--------------------------------------------------
CURRENT_TIME
CURRENT_TIME([precision <1>])
CURRENT_TIME([precision]) <1>
CURTIME
--------------------------------------------------

Expand Down Expand Up @@ -203,7 +203,7 @@ function as the maximum number of second fractional digits returned is 3 (millis
[source, sql]
--------------------------------------------------
CURRENT_TIMESTAMP
CURRENT_TIMESTAMP([precision <1>])
CURRENT_TIMESTAMP([precision]) <1>
--------------------------------------------------

*Input*:
Expand Down Expand Up @@ -254,7 +254,7 @@ function as the maximum number of second fractional digits returned is 3 (millis
.Synopsis:
[source, sql]
--------------------------------------------------
DAY_OF_MONTH(datetime_exp<1>)
DAY_OF_MONTH(datetime_exp) <1>
--------------------------------------------------

*Input*:
Expand All @@ -278,7 +278,7 @@ include-tagged::{sql-specs}/docs/docs.csv-spec[dayOfMonth]
.Synopsis:
[source, sql]
--------------------------------------------------
DAY_OF_WEEK(datetime_exp<1>)
DAY_OF_WEEK(datetime_exp) <1>
--------------------------------------------------

*Input*:
Expand All @@ -302,7 +302,7 @@ include-tagged::{sql-specs}/docs/docs.csv-spec[dayOfWeek]
.Synopsis:
[source, sql]
--------------------------------------------------
DAY_OF_YEAR(datetime_exp<1>)
DAY_OF_YEAR(datetime_exp) <1>
--------------------------------------------------

*Input*:
Expand All @@ -326,7 +326,7 @@ include-tagged::{sql-specs}/docs/docs.csv-spec[dayOfYear]
.Synopsis:
[source, sql]
--------------------------------------------------
DAY_NAME(datetime_exp<1>)
DAY_NAME(datetime_exp) <1>
--------------------------------------------------

*Input*:
Expand All @@ -350,7 +350,7 @@ include-tagged::{sql-specs}/docs/docs.csv-spec[dayName]
.Synopsis:
[source, sql]
--------------------------------------------------
HOUR_OF_DAY(datetime_exp<1>)
HOUR_OF_DAY(datetime_exp) <1>
--------------------------------------------------

*Input*:
Expand All @@ -374,7 +374,7 @@ include-tagged::{sql-specs}/docs/docs.csv-spec[hourOfDay]
.Synopsis:
[source, sql]
--------------------------------------------------
ISO_DAY_OF_WEEK(datetime_exp<1>)
ISO_DAY_OF_WEEK(datetime_exp) <1>
--------------------------------------------------

*Input*:
Expand All @@ -399,7 +399,7 @@ include-tagged::{sql-specs}/docs/docs.csv-spec[isoDayOfWeek]
.Synopsis:
[source, sql]
--------------------------------------------------
ISO_WEEK_OF_YEAR(datetime_exp<1>)
ISO_WEEK_OF_YEAR(datetime_exp) <1>
--------------------------------------------------

*Input*:
Expand All @@ -424,7 +424,7 @@ include-tagged::{sql-specs}/docs/docs.csv-spec[isoWeekOfYear]
.Synopsis:
[source, sql]
--------------------------------------------------
MINUTE_OF_DAY(datetime_exp<1>)
MINUTE_OF_DAY(datetime_exp) <1>
--------------------------------------------------

*Input*:
Expand All @@ -448,7 +448,7 @@ include-tagged::{sql-specs}/docs/docs.csv-spec[minuteOfDay]
.Synopsis:
[source, sql]
--------------------------------------------------
MINUTE_OF_HOUR(datetime_exp<1>)
MINUTE_OF_HOUR(datetime_exp) <1>
--------------------------------------------------

*Input*:
Expand All @@ -472,7 +472,7 @@ include-tagged::{sql-specs}/docs/docs.csv-spec[minuteOfHour]
.Synopsis:
[source, sql]
--------------------------------------------------
MONTH(datetime_exp<1>)
MONTH(datetime_exp) <1>
--------------------------------------------------

*Input*:
Expand All @@ -496,7 +496,7 @@ include-tagged::{sql-specs}/docs/docs.csv-spec[monthOfYear]
.Synopsis:
[source, sql]
--------------------------------------------------
MONTH_NAME(datetime_exp<1>)
MONTH_NAME(datetime_exp) <1>
--------------------------------------------------

*Input*:
Expand Down Expand Up @@ -552,7 +552,7 @@ include-tagged::{sql-specs}/docs/docs.csv-spec[filterNow]
.Synopsis:
[source, sql]
--------------------------------------------------
SECOND_OF_MINUTE(datetime_exp<1>)
SECOND_OF_MINUTE(datetime_exp) <1>
--------------------------------------------------

*Input*:
Expand All @@ -576,7 +576,7 @@ include-tagged::{sql-specs}/docs/docs.csv-spec[secondOfMinute]
.Synopsis:
[source, sql]
--------------------------------------------------
QUARTER(datetime_exp<1>)
QUARTER(datetime_exp) <1>
--------------------------------------------------

*Input*:
Expand Down Expand Up @@ -632,7 +632,7 @@ include-tagged::{sql-specs}/docs/docs.csv-spec[filterToday]
.Synopsis:
[source, sql]
--------------------------------------------------
WEEK_OF_YEAR(datetime_exp<1>)
WEEK_OF_YEAR(datetime_exp) <1>
--------------------------------------------------

*Input*:
Expand All @@ -656,7 +656,7 @@ include-tagged::{sql-specs}/docs/docs.csv-spec[weekOfYear]
.Synopsis:
[source, sql]
--------------------------------------------------
YEAR(datetime_exp<1>)
YEAR(datetime_exp) <1>
--------------------------------------------------

*Input*:
Expand All @@ -680,7 +680,9 @@ include-tagged::{sql-specs}/docs/docs.csv-spec[year]
.Synopsis:
[source, sql]
--------------------------------------------------
EXTRACT(datetime_function<1> FROM datetime_exp<2>)
EXTRACT(
datetime_function <1>
FROM datetime_exp) <2>
--------------------------------------------------

*Input*:
Expand Down
9 changes: 7 additions & 2 deletions docs/reference/sql/functions/grouping.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,13 @@ as part of the <<sql-syntax-group-by, grouping>>.
.Synopsis:
[source, sql]
----
HISTOGRAM(numeric_exp<1>, numeric_interval<2>)
HISTOGRAM(date_exp<3>, date_time_interval<4>)
HISTOGRAM(
numeric_exp, <1>
numeric_interval) <2>

HISTOGRAM(
date_exp, <3>
date_time_interval) <4>
----

*Input*:
Expand Down
6 changes: 4 additions & 2 deletions docs/reference/sql/functions/like-rlike.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,8 @@ or has an exact sub-field, it will use it as is, or it will automatically use th
.Synopsis:
[source, sql]
--------------------------------------------------
expression<1> LIKE constant_exp<2>
expression <1>
LIKE constant_exp <2>
--------------------------------------------------

<1> typically a field, or a constant expression
Expand Down Expand Up @@ -59,7 +60,8 @@ IMPORTANT: Even though `LIKE` is a valid option when searching or filtering in {
.Synopsis:
[source, sql]
--------------------------------------------------
expression<1> RLIKE constant_exp<2>
expression <1>
RLIKE constant_exp <2>
--------------------------------------------------

<1> typically a field, or a constant expression
Expand Down
Loading