DOC-8132-C2-GS -- C Lang Get Started (couchbase#490)

https://issues.couchbase.com/browse/DOC-8132

DOC-8132-C2-G2 -- C Lange get started bits -- initial
https://issues.couchbase.com/browse/DOC-8132

DOC-8132-C2-GS -- C Lang inerim 210809-1816
https://issues.couchbase.com/browse/DOC-8132

DOC-8132-C2-GS -- C Lang inerim 210810-0845
https://issues.couchbase.com/browse/DOC-8132

Author: ibsoln

.gitignore

@@ -104,4 +104,4 @@ modules/android/examples/docsnippets/**
 modules/android/examples/jsonsnippets/**
 temp-bin/**
 
-tempbin/**
+tempbin/**

antora.yml

@@ -12,3 +12,4 @@ nav:
 - modules/swift/nav-swift.adoc
 - modules/ROOT/nav-javascript.adoc
 - modules/ROOT/nav-sync-gateway.adoc
+:prerelease: BETA

modules/ROOT/pages/_partials/_block-caveats.adoc

@@ -1,6 +1,11 @@
+
+// BEGIN ANDROID-CONSTRAINTS
+
 // tag::android-constraints[]
+
 .Android enablers
 [CAUTION]
+
 --
 Allow Unencrypted Network Traffic::
 // tag::android-manifest-cleartext[]
@@ -12,11 +17,16 @@ Use Background Threads::
 // tag::android-threads[]
 As with any network or file I/O activity, CouchbaseLite activities should not be performed on the UI thread.
 *Always* use a *background* thread.
+
 // end::android-threads[]
 
 --
 
 // end::android-constraints[]
+// END ANDROID-CONSTRAINTS
+
+
+// BEGIN IOS-CONSTRAINTS
 
 // tag::ios-constraints[]
 .iOS Restrictions
@@ -28,14 +38,22 @@ You can customize the message presented to the user by editing the description f
 --
 
 // end::ios-constraints[]
+// END IOS-CONSTRAINTS
+
+// BEGIN -- BETA DISCLAIMER
+// tag::not-beta[]
+CAUTION: Not available in BETA release
+
+// end::not-beta[]
+// END -- BETA DISCLAIMER
 
 
 // tag::code-disclaimer[]
 
 .Code Snippets
 [NOTE]
-The code examples are indicative only.
-They demonstrate basic concepts and approaches to using a feature.
+All code examples are indicative only.
+They demonstrate the basic concepts and approaches to using a feature.
 Use them as inspiration and adapt these examples to best practice when developing applications for your platform.
 
 // end::code-disclaimer[]

modules/ROOT/pages/_partials/_get-started-topic-group.adoc

@@ -0,0 +1,52 @@
+// BEGIN -- inclusion -- _gs-topic-group.adoc
+//  Purpose: Show the topic group, allowing easy cycle-through
+//            Do not show current page as a click-through though
+//  Parameter: The current page name
+//  Container: /modules/ROOT/pages/_partials/_gs-topic-group.adoc
+
+// Begin -Local Attributes
+:this-page: {param-page}
+
+// ifeval::["{this-page}"=="{introduction--page}"]
+// :is-intro: Introduction
+// endif::[]
+
+// ifeval::["{this-page}"=="{gs-prereqs--page}"]
+// :is-prereqs: Prepare
+// endif::[]
+
+ifeval::["{this-page}"=="{gs-install--page}"]
+:is-install: Install
+endif::[]
+
+ifeval::["{this-page}"=="{gs-build--page}"]
+:is-build: Build
+endif::[]
+// End -Local Attributes
+
+// Begin -- Output Block
+Steps in Getting Started::
+// ifdef::is-intro[*{is-intro}*]
+// ifndef::is-intro[{introduction--xref}]
+//  |
+// ifdef::is-prereqs[*{is-prereqs}*]
+// ifndef::is-prereqs[{gs-prereqs--xref}]
+//  |
+ifdef::is-install[*{is-install}*]
+ifndef::is-install[{gs-install--xref}]
+ |
+ifdef::is-build[*{is-build}*]
+ifndef::is-build[{gs-build--xref}]
+// End -- Output Block
+
+
+// Begin -- Tidy-up
+:is-intro!:
+:is-prereqs!:
+:is-install!:
+:is-build!:
+:this-page!:
+:param-page!:
+// End -- Tidy-up
+
+// END -- inclusion -- _gs-topic-group.adoc

modules/ROOT/pages/_partials/_related-content.adoc

@@ -147,9 +147,9 @@ Blog Entries
 // end::references-prod[]
 // prod related
 // tag::how-query[]
-* {querybuilder--xref}
+ifndef::is-clang[* {querybuilder--xref}]
+* {querybuilder-n1ql--xref}
 * {query-live--xref}
-* {querybuilder--xref--predictive-query}
 * {fts--xref}
 
 // end::how-query[]

modules/ROOT/pages/_partials/authentication.adoc

@@ -29,7 +29,7 @@ This is the recommended way of using basic authentication.
 .Basic Authentication
 [#ex-base-auth]
 :param-tags: basic-authentication
-include::{root-partials}_block_show_snippet.adoc[]
+include::{root-partials}_block_tabbed_code_example.adoc[]
 :param-tags!:
 
 
@@ -44,5 +44,5 @@ The HTTP response contains a session ID which can then be used to authenticate a
 .Session Authentication
 [#ex-session-auth]
 :param-tags: session-authentication
-include::{root-partials}_block_show_snippet.adoc[]
+include::{root-partials}_block_tabbed_code_example.adoc[]
 :param-tags!:

modules/ROOT/pages/_partials/commons/common-querybuilder-n1ql.adoc

@@ -15,7 +15,7 @@
 :menuitem-delimiter: {nbsp}{nbsp}|{nbsp}{nbsp}
 :count-result-text: The result set representing a count is a key-value pair. The key being the count name, as defined using `SelectResult.as`
 
-
+include::_block-caveats.adoc[tags="code-disclaimer"]
 
 // END::Local page attributes
 
@@ -63,7 +63,7 @@ TIP: We recommend working through the {url-n1ql-tutorial} as a good way to build
 Use the N1QLQuery class to define the N1QL query string on the database to be queried.
 Then run the query using the`.execute()` method -- see
 
-The result set produced by N1QL and {querybuilder--xref)} queries is the same -- see {query-resultsets--xref}.
+The result set produced by N1QL and {querybuilder--xref} queries is the same -- see {query-resultsets--xref}.
 
 
 .Running a N1QL Query
@@ -155,8 +155,9 @@ FROM dataSource  <.>
 
 === Arguments
 
-<.> `dataSource` -- this is the database name against which the query is to run.
-Use `AS` to give the database an alias you can use within the query.
+<.> Here `dataSource` is the database name against which the query is to run.
+Use `AS` to give the database an alias you can use within the query. +
+To use the current database, without specifying a name, use `_` as the datasource.
 
 <.> `JOIN joinclause` -- use this optional argument to link datasources -- see <<lbl-join>>
 
@@ -169,6 +170,9 @@ Use `AS` to give the database an alias you can use within the query.
 SELECT name FROM db
 SELECT store.name FROM db AS store
 SELECT store.name FROM db store
+SELECT name FROM _
+SELECT store.name FROM _ AS store
+SELECT store.name FROM _ store
 ----
 
 ====
@@ -543,6 +547,7 @@ SELECT firstName, lastName FROM db WHERE middleName IS NULL
 
 ===== Purpose
 The MISSING literal represents a missing name-value pair in a document.
+
 ===== Syntax
 
 [source,sql]
@@ -572,9 +577,9 @@ arrayLiteral = '[' _ (expression ( _ ',' _ e2:expression )* )? ']'
 ===== Example
 [source,sql]
 ----
-SELECT [“a”, “b”, “c”] FROM db
-SELECT [ property1, property2, property3] FROM db
-SELECT * FROM db WHERE name IN [“James”, “John”, “Jack”
+SELECT [“a”, “b”, “c”] FROM _
+SELECT [ property1, property2, property3] FROM _
+SELECT * FROM _ WHERE name IN [“James”, “John”, “Jack”]
 ----
 
 [#lbl-lit-dict]
@@ -631,7 +636,7 @@ TIP: To use other characters in the identifier, surround the identifier with the
 
 [source, sql]
 ----
-SELECT * FROM db
+SELECT * FROM _
 
 SELECT * FROM `db-1` <.>
 
@@ -714,7 +719,7 @@ Evaluates expressions over items in an array object.
 ----
 arrayExpression = <.>
   anyEvery _ variableName <.>
-     _ IN <.>  _ expression <.>
+     _ IN  _ expression <.>
        _ SATISFIES _ expression <.>
     END <.>
 
@@ -958,22 +963,22 @@ WHERE v1 <> v2
 a|String wildcard pattern matching ^2^ comparison.
 Two wildcards are supported:
 
-`%` Matches zero or more characters. +
-`_` Matches a single character.
+* `%` Matches zero or more characters. +
+* `_` Matches a single character.
 
 
 |WHERE name LIKE ‘a%’ +
 WHERE name LIKE ‘%a’ +
 WHERE name LIKE ‘%or% +
 WHERE name LIKE ‘a%o%’ +
-WHERE name LIKE ‘%_r%’ +
+WHERE name LIKE ‘%\_r%’ +
 WHERE name LIKE ‘%a_%’ +
 WHERE name LIKE ‘%a__%’ +
 WHERE name LIKE ‘aldo’
 
 
 |MATCH
-|String matching using FTS see <<lbl-ops-match>>
+|String matching using FTS see <<lbl-func-fts>>
 |WHERE v1-index MATCH "value"
 
 |BETWEEN
@@ -1007,7 +1012,7 @@ WHERE name LIKE ‘aldo’
 
 |===
 
-^2^ Matching is case-insensitive for ASCII characters, case-sensitive for non-ASCII (default).
+^2^ Matching is case-insensitive for ASCII characters, case-sensitive for non-ASCII.
 
 
 ^3^ Use of `IS` and `IS NOT` is limited to comparing `NULL` and `MISSING` values (this encompasses `VALUED`).
@@ -1627,7 +1632,7 @@ Returns `NULL` if either or both expressions are `NULL`.+
 |Returns the arctangent in radians.
 
 |ATAN2(expr1,expr2)
-|Returns the arctangent of expr2/expr1.
+|Returns the arctangent of expr1/expr2.
 
 |CEIL(expr)
 |Returns the smallest integer not less than the number.
@@ -1640,11 +1645,6 @@ Returns `NULL` if either or both expressions are `NULL`.+
 Both expr1 and expr2 are cast to a double number before division. +
 The returned result is always a double.
 
-|IDIV(expr1, expr2)
-|Returns integer division of expr1 and expr2. +
-Both expr1 and expr2 are cast to an integer number before division. +
-The returned result is always an integer.
-
 |DEGREES(expr)
 |Converts radians to degrees.
 

modules/ROOT/pages/_partials/database-encryption.adoc

@@ -11,7 +11,7 @@ Provide this encryption key every time the database is opened -- see <<ex-sdb-en
 .Database Encryption
 [#ex-sdb-encrypt]
 :param-tags: database-encryption
-include::{root-partials}_block_show_snippet.adoc[]
+include::{root-partials}_block_tabbed_code_example.adoc[]
 :param-tags!:
 
 

modules/ROOT/pages/_partials/nav-skeleton-start-clang.adoc

@@ -1,6 +1,7 @@
 .xref:couchbase-lite:clang:quickstart.adoc[{param-title}]
 // tag::get-started[]
 * xref:{cbl-pg-prereqs}[Start Here!]
+.Start Here!
 // tag::start[]
 ** {gs-install--xref}
 // end::start[]

modules/ROOT/pages/_partials/nav-skeleton.adoc

@@ -16,7 +16,7 @@ include::{root-partials}nav-skeleton-start-{param-module}.adoc[]
 // end::data-model[]
 // tag::query[]
 * Queries
-** {querybuilder--xref}
+ifndef::is-clang[** {querybuilder--xref}]
 ** {querybuilder-n1ql--xref}
 ** {query-resultsets--xref}
 ** {query-live--xref}