From 178c967e20c3217d1db66abdb8ad27e0b3965c5c Mon Sep 17 00:00:00 2001
From: "alessia.bardi" <alessia.bardi@isti.cnr.it>
Date: Tue, 11 Nov 2014 18:43:18 +0000
Subject: [PATCH] Fixed documentation for publications

git-svn-id: https://svn.driver.research-infrastructures.eu/driver/dnet40/modules/dnet-api-http-doc/src@32469 d315682c-612b-4755-9ff5-7f18f6832af3
---
 docbkx/overview.xml              |  1 -
 docbkx/sections/publications.xml | 29 +++++++++++++++++------------
 2 files changed, 17 insertions(+), 13 deletions(-)

diff --git a/docbkx/overview.xml b/docbkx/overview.xml
index 471191f..774a17e 100644
--- a/docbkx/overview.xml
+++ b/docbkx/overview.xml
@@ -10,7 +10,6 @@
         <member><xref linkend="cha_oai_pmh"/></member>
         <member><xref linkend="cha_projects_http"/></member>
       </simplelist>
-      
     </listitem>
     <listitem>
       <para>Selective access via <xref linkend="cha_http-api"/></para>
diff --git a/docbkx/sections/publications.xml b/docbkx/sections/publications.xml
index e984fdb..bcd030b 100644
--- a/docbkx/sections/publications.xml
+++ b/docbkx/sections/publications.xml
@@ -17,65 +17,63 @@
     <varlistentry>
       <term>doi</term>
       <listitem>
-        <para>Allowed values: comma separated list of DOIs.Gets the publications with the given DOIs, if any.</para>
+        <para>Gets the publications with the given DOIs, if any. Allowed values: comma separated list of DOIs. Alternatevely, it is possible to repeat the paramater for each requested doi.</para>
        <!--<para><code>here goes the sample query</code></para> -->
       </listitem>
     </varlistentry>
     <varlistentry>
       <term>openairePublicationID</term>
       <listitem>
-        <para>Gets the publication with the given openaire identifier, if any.</para>
+        <para>Gets the publication with the given openaire identifier, if any. Allowed values: comma separated list of openaire identifiers. Alternatevely, it is possible to repeat the paramater for each requested identifier.</para>
        <!--<para><code>here goes the sample query</code></para> -->
       </listitem>
     </varlistentry>
     <varlistentry>
       <term>fromDateAccepted</term>
       <listitem>
-        <para>Allowed values: date formatted as <code>YYYY-MM-DD</code>. Gets the publications whose date of acceptance is greater than or equal the given
-          date.</para>
+        <para>Gets the publications whose date of acceptance is greater than or equal the given date. Allowed values: date formatted as <code>YYYY-MM-DD</code>.</para>
        <!--<para><code>here goes the sample query</code></para> -->
       </listitem>
     </varlistentry>
     <varlistentry>
       <term>toDateAccepted</term>
       <listitem>
-        <para>Allowed values: date formatted as <code>YYYY-MM-DD</code>. Gets the publications whose date of acceptance is less than or equal the given date.</para>
+        <para>Gets the publications whose date of acceptance is less than or equal the given date. Allowed values: date formatted as <code>YYYY-MM-DD</code>.</para>
        <!--<para><code>here goes the sample query</code></para> -->
       </listitem>
     </varlistentry>
     <varlistentry>
       <term>title</term>
       <listitem>
-        <para>Allowed values: white-space separated list of keywords. Gets the publications whose titles contain the given list of keywords.</para>
+        <para>Gets the publications whose titles contain the given list of keywords. Allowed values: white-space separated list of keywords.</para>
        <!--<para><code>here goes the sample query</code></para> -->
       </listitem>
     </varlistentry>
     <varlistentry>
       <term>author</term>
       <listitem>
-        <para>Search for publications by authors. Allowed value is a white-space separated list of
-          names and/or surnames.</para>
+        <para>Search for publications by authors. Allowed value is a white-space separated list of names and/or surnames.</para>
        <!--<para><code>here goes the sample query</code></para> -->
       </listitem>
     </varlistentry>
     <varlistentry>
       <term>openaireAuthorID</term>
       <listitem>
-        <para>Search for publications by openaire author identifier.</para>
+        <para>Search for publications by openaire author identifier. Allowed values: comma separated list of identifiers. Alternatevely, it is possible to repeat the paramater for each author id. In both cases, author identifiers will form a query with OR semantics.</para>
        <!--<para><code>here goes the sample query</code></para> -->
       </listitem>
     </varlistentry>
     <varlistentry>
       <term>openaireProviderID</term>
       <listitem>
-        <para>Search for publications by openaire data provider identifier.</para>
+        <para>Search for publications by openaire data provider identifier. Allowed values: comma separated list of identifiers. Alternatevely, it is possible to repeat the paramater for each provider id. In both cases, provider identifiers will form a query with OR semantics.</para>
        <!--<para><code>here goes the sample query</code></para> -->
       </listitem>
     </varlistentry>
     <varlistentry>
       <term>openaireProjectID</term>
       <listitem>
-        <para>Search for publications by openaire project identifier.</para>
+        <para>Search for publications by openaire project identifier. Allowed values: comma separated list of identifiers. Alternatevely, it is possible to repeat the paramater for each provider id. In both cases, provider identifiers will form a query with OR semantics.</para>
        <!--<para><code>here goes the sample query</code></para> -->
       </listitem>
     </varlistentry>
@@ -88,10 +86,17 @@
        <!--<para><code>here goes the sample query</code></para> -->
       </listitem>
     </varlistentry>
+    <varlistentry>
+      <term>projectID</term>
+      <listitem>
+        <para>Search for publications associated to a project with the given grant identifier.</para>
+        <!--<para><code>here goes the sample query</code></para> -->
+      </listitem>
+    </varlistentry>
     <varlistentry>
       <term>FP7ProjectID</term>
       <listitem>
-        <para>Search for publications associated to a FP7 project with the given grant number.</para>
+        <para>Search for publications associated to a FP7 project with the given grant number. It is equivalent to a query by <code>funder=FP7&amp;projectID=grantID</code></para>
         <!--<para><code>here goes the sample query</code></para> -->
       </listitem>
     </varlistentry>