From ce6c7628f8d5ddb8d305e344376caafbb7db30cc Mon Sep 17 00:00:00 2001
From: Timm Fitschen <t.fitschen@indiscale.com>
Date: Tue, 22 Nov 2022 11:15:45 +0100
Subject: [PATCH] DOC: update refs in CaosDB-Query-Language.md
---
src/doc/CaosDB-Query-Language.md | 11 ++++++++++-
src/doc/index.rst | 5 ++---
2 files changed, 12 insertions(+), 4 deletions(-)
diff --git a/src/doc/CaosDB-Query-Language.md b/src/doc/CaosDB-Query-Language.md
index c912e0e2..0c14ac5e 100644
--- a/src/doc/CaosDB-Query-Language.md
+++ b/src/doc/CaosDB-Query-Language.md
@@ -1,6 +1,6 @@
# CaosDB Query Language Examples
-See syntax specification in :doc:`CaosDB Query Language Syntax<query-syntax>`.
+See syntax specification in [CaosDB Query Language Syntax](query-syntax).
## Simple FIND Query
@@ -405,6 +405,15 @@ Since Caosdb 0.2 entities are optionally version controlled. The query language
* Add `(ANY|LATEST|LAST|OLDEST|NEWEST|FIRST) VERSION (BEFORE|AFTER) (<timestamp>|<transaction id>|<entity@version>) OF` modifier.
* Add support for subproperties, e.g. `FIND ANY VERSION OF ENTITY WHICH IS REFERENCED BY ename WITH ...`.
+## Configuration
+
+In CaosDB Server implementations before version 0.9.0, the `FIND ename` query
+would return any entity with that name and all children, regardless of the
+entity's role. Basically, `FIND ename` *was* equivalent to `FIND ENTITY ename`.
+Since 0.9.0 the default behavior has changed and now `FIND ename` is equivalent
+to `FIND RECORD ename`. This default is, however, configurable via the
+`FIND_QUERY_DEFAULT_ROLE` server property. See [Server Configuration](./administration/configuration.rst).
+
## Future
* *Sub Queries* (or *Sub Properties*): `FIND ename WHICH HAS A pname WHICH HAS A subpname=val`. This is like: `FIND AN experiment WHICH HAS A camera WHICH HAS A 'serial number'= 1234567890`
diff --git a/src/doc/index.rst b/src/doc/index.rst
index 3d655648..1a5e4134 100644
--- a/src/doc/index.rst
+++ b/src/doc/index.rst
@@ -11,15 +11,14 @@ Welcome to caosdb-server's documentation!
Getting started <README_SETUP>
Concepts <concepts>
tutorials
- Query Language Examples <CaosDB-Query-Language>
- Query Language Syntax <query-syntax>
+ Query Language <CaosDB-Query-Language>
administration
Development <development/devel>
Dependencies <DEPENDENCIES>
Changelog <CHANGELOG>
specification/index.rst
Glossary
- API documentation<_apidoc/packages>
+ Server Internals<_apidoc/packages>
Welcome to the CaosDB, the flexible semantic data management toolkit!
--
GitLab