Item9680: differentiate QUERY and FORMFIELD

git-svn-id: http://svn.foswiki.org/trunk@9116 0b4bb1d4-4e5a-0410-9cc4-b2b747904278

core/data/System/ReleaseNotes01x01.txt

@@ -68,7 +68,11 @@ Also added are the new =ADDTOZONE= and =RENDERZONE= macros that manage dependenc
 See %SYSTEMWEB%.JQueryPlugin for details.
 
 ---+++ Powerful new =QUERY= macro
-A number of new features have been added with the goal of improving support  for wiki applications. These include the powerful new =QUERY= macro,  which supports formatted access to formfields and other meta-data in  topics using the same syntax as is used in =IF= and =SEARCH= statements.
+A number of new features have been added with the goal of improving support  for wiki applications. These include the powerful new =QUERY= macro, which:
+   * supports formatted access to formfields and other meta-data in  topics using the same syntax as is used in =IF= and =SEARCH= statements,
+   * gives access to *all* meta-data, including that added by extensions,
+   * supports reporting values using JSON and other standards, simplifying the retrieval of meta-data for REST applications,
+   * replaces the =FORMFIELD= macro for most applications.
 
 Use of the ="formfield"= parameter to the =META= macro has been deprecated (it is still available, but use is discouraged and it will be removed at some point in the future).
 

core/data/System/VarQUERY.txt

@@ -3,6 +3,10 @@
 #VarQUERY
 ---+++ QUERY -- get the value of meta-data
    * Uses the query syntax described in [[System.QuerySearch][QuerySearch]] to get information about meta-data.
+      * supports formatted access to formfields and other meta-data in  topics using the same syntax as is used in =IF= and =SEARCH= statements,
+      * gives access to *all* meta-data, including that added by extensions,
+      * supports reporting values using JSON and other standards, simplifying the retrieval of meta-data for REST applications,
+      * replaces the =[[VarFORMFIELD][FORMFIELD]]= macro for most applications.
    * Syntax: =%<nop>QUERY{ "query" }%=
    * See !QuerySearch for more details of how to write queries
    * Parameters: