X-Git-Url: http://git.onelab.eu/?a=blobdiff_plain;f=doc%2FPLCAPI.xml.in;fp=doc%2FPLCAPI.xml.in;h=79fb1a8e83fbe32c016e24e9a9e95c618c5f18a0;hb=82bc3a4635f59383dbe0a5544491b200f0363d15;hp=af48f91785876f02ece5da4c54eaea913af58ef2;hpb=b48e3b66786c1c1e97e4dbe5bb1659e3836bfd5f;p=plcapi.git

diff --git a/doc/PLCAPI.xml.in b/doc/PLCAPI.xml.in
index af48f91..79fb1a8 100644
--- a/doc/PLCAPI.xml.in
+++ b/doc/PLCAPI.xml.in
@@ -360,8 +360,8 @@ tagname=arch               category=node/slice/config/ui/header=A/rank=x
 	</para></listitem>
 
 	<listitem><para> 
-	  The current limitation about tags as opposed to native
-	  fields is that, for performance, tags won't get returned
+	  The current limitations about tags, as opposed to native
+	  fields, is that for performance, tags won't get returned
 	  when using the implicit set of columns. So for instance:
 <programlisting>
 # get all details for 'pl1.foo.com' 
@@ -369,6 +369,20 @@ tagname=arch               category=node/slice/config/ui/header=A/rank=x
 # this did not return the 'arch' tag
 >>> 'arch' in node
 False
+</programlisting>
+	</para></listitem>
+
+	<listitem><para>
+	  For a similar reason, any tag used in the filter argument will <emphasis>have to</emphasis> be mentioned in the list of returned columns as well. For example:
+<programlisting>
+# if 'hrn' is not part of the result, this does not work
+>>> ns=GetNodes({'hrn':'ple.*'},['hostname'])
+Database error b59e068c-589a-4ad5-9dd8-63cc38f2a2eb:
+column "hrn" does not exist
+LINE 1: ...M view_nodes WHERE deleted IS False AND (True AND hrn ILIKE ...
+... abridged ...
+# this can be worked around by just returning 'hrn' as well
+>>> ns=GetNodes({'hrn':'ple.*'},['hrn','hostname'])
 </programlisting>
 	</para></listitem>