X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=doc%2Fsysdbql.7.txt;h=011da144fc734ab9c005156506b59d523e35fbb3;hb=16ac77248a64a2fc6a0ebfd79d2c4357e95247d8;hp=335918ab59d3473f93f685379b600fe0d51843e6;hpb=cc9bd4ce07d5fa5a324bf9f4e496df0ebf42a9a7;p=sysdb.git

diff --git a/doc/sysdbql.7.txt b/doc/sysdbql.7.txt
index 335918a..011da14 100644
--- a/doc/sysdbql.7.txt
+++ b/doc/sysdbql.7.txt
@@ -1,7 +1,5 @@
 sysdbql(7)
 ==========
-Sebastian "tokkee" Harl <sh@tokkee.org>
-version {package_version}, {build_date}
 :doctype: manpage
 
 NAME
@@ -17,16 +15,7 @@ SYNOPSIS
 
 DESCRIPTION
 -----------
-SysDB stores system and inventory information about hardware and software
-systems. This information is stored in a graph-like hierarchy of generic
-objects. The central object type is a host, which generally represents a
-physical or virtual machine or any other type of physical resource. Hosts, in
-turn, may reference a list of services which represent any kind of logical
-resource like a software system. Both, hosts and services, may reference a
-list of attributes which represent further information about the respective
-host or service object. For example, attributes may specify static information
-like a host's architecture or the software version or snapshots of performance
-data like the current memory utilization or much more.
+include::sysdb-description.txt[]
 
 The SysDB query language is a human-readable format for describing a request
 to retrieve data from a SysDB daemon. It is very remotely similar to the
@@ -91,6 +80,15 @@ The following fields may be queried:
 	The value of the named host attribute. If an attribute of the specified
 	does not exist, each comparison is treated as if the value does not match.
 
+'<value>' may either be a string (when matching by object names) or match the
+type of the attribute's value (when matching attribute values). Attribute
+values may either be a string, integer, or decimal number (booleans and binary
+data are not supported by the frontend yet).
+
+When comparing an attribute's value using a regular expression matcher, the
+value will be cast to a string before doing so. No other casts are supported
+at this time.
+
 The following operators may be used to match field values:
 
 *=*::
@@ -108,6 +106,12 @@ The following operators may be used to match field values:
 	Evalues to true if the field value does not match the specified regular
 	expression.
 
+The following operators may be used, in addition, to match attribute values:
+
+*<*, *\<=*, *>=*, *>*::
+	Evaluates to true if the attribute value is less than, less than or equal
+	to, greater than or equal to or greater than the specified value.
+
 RESPONSE FORMAT
 ---------------
 The JavaScript Object Notation (JSON) format, as specified in RFC 4627, is
@@ -175,7 +179,7 @@ replies look like. The replies are pretty-printed to more easily follow them.
 
 SEE ALSO
 --------
-*sysdb*(1)
+manpage:sysdb[1]
 
 AUTHOR
 ------