[groovy] branch master updated: Tweak doco

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
1 message Options
Reply | Threaded
Open this post in threaded view
|

[groovy] branch master updated: Tweak doco

Daniel.Sun
This is an automated email from the ASF dual-hosted git repository.

sunlan pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/groovy.git


The following commit(s) were added to refs/heads/master by this push:
     new 1900958  Tweak doco
1900958 is described below

commit 1900958c7a72ef85a5ea3d6425dc5a1ce8d8742a
Author: Daniel Sun <[hidden email]>
AuthorDate: Sun Nov 22 20:19:51 2020 +0800

    Tweak doco
---
 subprojects/groovy-ginq/src/spec/doc/ginq-userguide.adoc | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/subprojects/groovy-ginq/src/spec/doc/ginq-userguide.adoc b/subprojects/groovy-ginq/src/spec/doc/ginq-userguide.adoc
index 2d9deed..bd53843 100644
--- a/subprojects/groovy-ginq/src/spec/doc/ginq-userguide.adoc
+++ b/subprojects/groovy-ginq/src/spec/doc/ginq-userguide.adoc
@@ -22,12 +22,13 @@
 = Querying collections in a SQL-like style
 
 Groovy's `groovy-ginq` module provides a higher-level abstraction over collections.
-Also, querying XML, JSON, YAML, etc. could be supported by GINQ too because they can be parsed into collections.
-As GORM and Hibernate are powerful enough to support DB populating, we will cover collections first.
+It could perform queries against in-memory collections of objects in a SQL-like style.
+Also, querying XML, JSON, YAML, etc. could be also supported because they can be parsed into collections.
+As GORM and jOOQ are powerful enough to support querying DB, we will cover collections first.
 
 == GINQ a.k.a. Groovy-Integrated Query
 
-GINQ is a DSL for querying, which consists of the following structure:
+GINQ is a DSL for querying with SQL-like syntax, which consists of the following structure:
 ```sql
 GINQ
 |__ from
@@ -49,6 +50,8 @@ As we could see, the simplest GINQ consists of a `from` clause and a `select` cl
 ----
 include::../test/org/apache/groovy/ginq/GinqTest.groovy[tags=ginq_simplest,indent=0]
 ----
+[NOTE]
+__ONLY ONE__ `from` clause is required in GINQ. Also, GINQ supports multiple data sources through `from` and the related joins.
 
 As a DSL, GINQ should be wrapped with the following block to be executed:
 ```groovy

Apache Groovy committer & PMC member

Blog: http://blog.sunlan.me
Twitter: @daniel_sun