cvs: phpdoc /fr/functions yaz.xml
| From: | Damien Seguy | Date: | Tue, 31 Jul 2001 08:08:00 +0000 |
| Subject: | cvs: phpdoc /fr/functions yaz.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969336620@lists.php.net to get a copy of this message | ||
dams Tue Jul 31 04:08:00 2001 EDT
Modified files:
/phpdoc/fr/functions yaz.xml
Log:
Moved URL to global.ent
Index: phpdoc/fr/functions/yaz.xml diff -u phpdoc/fr/functions/yaz.xml:1.16 phpdoc/fr/functions/yaz.xml:1.17 --- phpdoc/fr/functions/yaz.xml:1.16 Sat Jul 7 18:22:29 2001 +++ phpdoc/fr/functions/yaz.xml Tue Jul 31 04:08:00 2001 @@ -8,7 +8,7 @@ Cette extension offre à PHP l'interface avec les produits <productname>YAZ</productname>, qui implémentent le protocole Z39.50. Avec cette extension, vous pouvez facilement implémenter - un client Z39.50 qui analyse ou scanne des serveurs Z39.50 en paralelle. + un client Z39.50 qui analyse ou scanne des serveurs Z39.50 en paralléle. </para> <para> <productname>YAZ</productname> est disponible à <ulink @@ -28,7 +28,8 @@ <title>Installation</title> <para> Compilez YAZ et installez le. Compilez PHP avec vos modules et ajoutez l'option - --with-yaz. Les instructions sont : + <link linkend="install.configure.with-yaz"><option role="configure">--with-yaz</option></link>. + Les instructions sont : </para> <para> <informalexample> @@ -54,11 +55,11 @@ représente l'ID d'une connexion particulière. </para> <para> - Le script ci-dessous montre comment effectuer une recherche paralelle. + Le script ci-dessous montre comment effectuer une recherche paralléle. Lorsqu'il est appelé sans paramètre, ce script affiche la requête. Sinon, il effectue la recherche sur les serveurs. <example> - <title>Recherche paralelle, utilisant YAZ</title> + <title>Recherche paralléle utilisant YAZ</title> <programlisting role="php"> <?php $num_hosts = count ($host); @@ -177,7 +178,7 @@ </funcsynopsis> <para> <function>yaz_connect</function> retourne un identifiant positif en cas - de succès, et &false; sinon. + de succès, et <literal>FALSE</literal> sinon. </para> <para> <function>yaz_connect</function> prépare une connexion @@ -207,7 +208,7 @@ <para> <function>yaz_errno</function> retourne le numéro d'erreur de la dernière requête. Une valeur positive est retournée - si le serveur a retournée un diagnostic. La valeur 0 est retournée + si le serveur a retourné un diagnostic. La valeur 0 est retournée si aucune erreur n'est survenue. Une valeur négative indique une erreur sans diagnostic (connexion perdue,...). </para> @@ -234,7 +235,7 @@ </funcsynopsis> <para> <function>yaz_error</function> retourne un message d'erreur pour la - dernière requête. Une chaîicirc;ne vide est + dernière requête. Une chaîne vide est retournée si la dernière requête a réussi. </para> <para> @@ -285,12 +286,12 @@ <function>yaz_element</function> est à utiliser en conjonction avec <function>yaz_search</function> et <function>yaz_present</function> pour spécifier le type d'éléments à lire. - La plupart des serveurs supporte <literal>F</literal> (full, tous), et + La majorité des serveurs supporte <literal>F</literal> (full, tous), et <literal>B</literal> (brief, bref). </para> <para> - <function>yaz_element</function> retourne &true; en - cas de succès, et &false; sinon. + <function>yaz_element</function> retourne <literal>TRUE</literal> en + cas de succès, et <literal>FALSE</literal> sinon. </para> </refsect1> </refentry> @@ -314,7 +315,7 @@ <function>yaz_database</function> spécifie <parameter>databases</parameter>, la ou les bases utilisées lors des recherches, lectures, etc, - en remplacant celles spécifiées lors de la fonction + en remplaçant celles spécifiées lors de la fonction <function>yaz_connect</function>. Pour indiquer plusieurs bases de données, séparez les noms par des <literal>+</literal>. </para> @@ -323,8 +324,8 @@ jeux de bases durant une session. </para> <para> - <function>yaz_database</function> retourne &true; - en cas de succès, ou &false; en cas d'erreur. + <function>yaz_database</function> retourne <literal>TRUE</literal> + en cas de succès, ou <literal>FALSE</literal> en cas d'erreur. </para> </refsect1> </refentry> @@ -378,8 +379,8 @@ et <parameter>number</parameter> vaudra 10. </para> <para> - <function>yaz_range</function> retourne &true; en - cas de succès; &false; en cas d'erreur. + <function>yaz_range</function> retourne <literal>TRUE</literal> en + cas de succès; <literal>FALSE</literal> en cas d'erreur. </para> </refsect1> </refentry> @@ -450,12 +451,12 @@ requêtes de type Type-1, comme définit dans le standard Z39.50. Cependant, dans la représentation textuelle utilisée par YAZ, une notation à préfixage est utilisée, - c'est à dire que l'opérateur précéde + c'est-à-dire que l'opérateur précédent l'opérande. La chaîne de requête est une - séquence de mots reservés, où les espaces sont + séquence de mots réservés, où les espaces sont ignorés, à moins qu'ils n'ai été - mis entre guillemets doubles. Les mots reservés qui commencent - par un arobase (<literal>@</literal>) sont considérés + mis entre guillemets doubles. Les mots réservés qui commencent + par un arobase (<literal>@</literal>) sont considérés comme des opérateurs et traités comme tels. </para> <table> @@ -469,28 +470,28 @@ </thead> <tbody> <row> - <entry><literal>@and query1 query2</literal></entry> + <entry><literal>@and query1 query2</literal></entry> <entry>intersection des requêtes query1 et query2</entry> </row> <row> - <entry><literal>@or query1 query2</literal></entry> + <entry><literal>@or query1 query2</literal></entry> <entry>union des requêtes query1 et query2</entry> </row> <row> - <entry><literal>@not query1 query2</literal></entry> + <entry><literal>@not query1 query2</literal></entry> <entry>requêtes "query1 et non(query2)"</entry> </row> <row> - <entry><literal>@set name</literal></entry> + <entry><literal>@set name</literal></entry> <entry>nomme le résultat</entry> </row> <row> - <entry><literal>@attrset set query</literal></entry> + <entry><literal>@attrset set query</literal></entry> <entry>spécifie le jeu d'attributs de la requête. Cette construction n'est autorisée qu'une seule fois, au début d'une requête.</entry> </row> <row> - <entry><literal>@attr set type=value query</literal></entry> + <entry><literal>@attr set type=value query</literal></entry> <entry>Applique les attributs à une requête. Le type et la valeur sont des entiers indiquant les types et valeurs des attributs, dans cet ordre. Le jeu, si fourni, spécifie le jeu d'attribut utilisé. @@ -515,7 +516,7 @@ </para> <para> <informalexample> - <screen>@attr 1=4 php</screen> + <screen>@attr 1=4 php</screen> </informalexample> L'attribut est de type 1 (Bib-1 use), sa valeur est 4 (Title, titre) : cette requête recherche les documents où le mot "php" @@ -523,7 +524,7 @@ </para> <para> <informalexample> - <screen>@attrset gils @and @attr 1=4 php @attr 1=1003 "Rasmus Lerdorf"</screen> + <screen>@attrset gils @and @attr 1=4 php @attr 1=1003 "Rasmus Lerdorf"</screen> </informalexample> Cette requête utilise tout le jeu d'attributs GILS. Elle recherche les documents dont le titre contient "php", et qui contiennent le @@ -588,8 +589,8 @@ contrôler le comportement de la requête de scan. Actuellement, trois index sont lus dans ce paramètre : <literal>number</literal> (nombre de termes requis), <literal>position</literal> (position préférée du terme) et - <literal>stepSize</literal> (taille du pas préferée). - Pour rééllement envoyer la requête de recherche à l'hôte, et recevoir + <literal>stepSize</literal> (taille du pas préférée). + Pour reéllement envoyer la requête de recherche à l'hôte, et recevoir la réponse, <function>yaz_wait</function> doit être appelée. A la fin de <function>yaz_wait</function>, <function>yaz_error</function> et <function>yaz_scan_result</function> auront les résultats. @@ -598,7 +599,7 @@ La syntaxe de <parameter>startterm</parameter> est similaire aux requêtes RPN, décrites dans <function>yaz_search</function>. <parameter>startterm</parameter> est constitué de zéro ou plus - spécifications, avec les opérateurs <literal>@attr</literal>, suivi par + spécifications, avec les opérateurs <literal>@attr</literal>, suivi par exactement un token. </para> <para> @@ -606,7 +607,7 @@ <title>Fonction PHP qui scanne les titres</title> <programlisting> function scan_titles($id, $starterm) { - yaz_scan($id,"rpn", "@attr 1=4 " . $starterm); + yaz_scan($id,"rpn", "@attr 1=4 " . $starterm); yaz_wait(); $errno = yaz_errno($id); if ($errno == 0) { @@ -735,12 +736,12 @@ Pour définir un champs CCL valide, utilisez la fonction <function>yaz_ccl_conf</function> avant celle-ci. Si la requête <parameter>query</parameter> a pu être convertie en - RPN, <function>yaz_ccl_parse</function> retourne &true;, + RPN, <function>yaz_ccl_parse</function> retourne <literal>TRUE</literal>, et l'index <literal>rpn</literal> du tableau <parameter>result</parameter> contient une requête RPN valide. Si la requête n'a pas pu être convertie, (pour n'importe quelle raison, comme syntaxe invalide, champs inconnu...), - <function>yaz_ccl_parse</function> retourne &false;. - Trois index sont alors créé dans le tableau de résultat : + <function>yaz_ccl_parse</function> retourne <literal>FALSE</literal>. + Trois index sont alors créés dans le tableau de résultat : <literal>errorcode</literal> (code d'erreur CCL, un entier), <literal>errorstring</literal> (message d'erreur CCL), et <literal>errorpos</literal> position estimée de l'erreur dans la @@ -766,11 +767,10 @@ <para> <function>yaz_itemorder</function> prépare une requête de type "Extended Services" en utilisant le "Profile" avec "Use of Z39.50 Item Order Extended Service to - Transport ILL (Profile/1)" (Note du Traducteur : mailes moi de l'aide!). Reportez vous - <ulink url="http://www.nlc-bnc.ca/iso/ill/stanprf.htm">ici</ulink> + Transport ILL (Profile/1)" (Note du Traducteur : mailez moi de l'aide!). Reportez-vous + <ulink url="&url.yaz.ill;">ici</ulink> ou aux - <ulink url="http://www.nlc-bnc.ca/iso/ill/document/standard/z-ill-1a.pdf"> - spécification</ulink>. + <ulink url="&url.yaz.specs">spécification</ulink>. Le paramètre <parameter>args</parameter> doit être un tableau associatif, contenant les informations "Item Order" à envoyer. L'index du tableau est le nom ASN.1 correspondant au tag path. Par exemple, le numéro ISBN sous
Index: phpdoc/fr/functions/yaz.xml diff -u phpdoc/fr/functions/yaz.xml:1.16 phpdoc/fr/functions/yaz.xml:1.17 --- phpdoc/fr/functions/yaz.xml:1.16 Sat Jul 7 18:22:29 2001 +++ phpdoc/fr/functions/yaz.xml Tue Jul 31 04:08:00 2001 @@ -8,7 +8,7 @@ Cette extension offre à PHP l'interface avec les produits <productname>YAZ</productname>, qui implémentent le protocole Z39.50. Avec cette extension, vous pouvez facilement implémenter - un client Z39.50 qui analyse ou scanne des serveurs Z39.50 en paralelle. + un client Z39.50 qui analyse ou scanne des serveurs Z39.50 en paralléle. </para> <para> <productname>YAZ</productname> est disponible à <ulink @@ -28,7 +28,8 @@ <title>Installation</title> <para> Compilez YAZ et installez le. Compilez PHP avec vos modules et ajoutez l'option - --with-yaz. Les instructions sont : + <link linkend="install.configure.with-yaz"><option role="configure">--with-yaz</option></link>. + Les instructions sont : </para> <para> <informalexample> @@ -54,11 +55,11 @@ représente l'ID d'une connexion particulière. </para> <para> - Le script ci-dessous montre comment effectuer une recherche paralelle. + Le script ci-dessous montre comment effectuer une recherche paralléle. Lorsqu'il est appelé sans paramètre, ce script affiche la requête. Sinon, il effectue la recherche sur les serveurs. <example> - <title>Recherche paralelle, utilisant YAZ</title> + <title>Recherche paralléle utilisant YAZ</title> <programlisting role="php"> <?php $num_hosts = count ($host); @@ -177,7 +178,7 @@ </funcsynopsis> <para> <function>yaz_connect</function> retourne un identifiant positif en cas - de succès, et &false; sinon. + de succès, et <literal>FALSE</literal> sinon. </para> <para> <function>yaz_connect</function> prépare une connexion @@ -207,7 +208,7 @@ <para> <function>yaz_errno</function> retourne le numéro d'erreur de la dernière requête. Une valeur positive est retournée - si le serveur a retournée un diagnostic. La valeur 0 est retournée + si le serveur a retourné un diagnostic. La valeur 0 est retournée si aucune erreur n'est survenue. Une valeur négative indique une erreur sans diagnostic (connexion perdue,...). </para> @@ -234,7 +235,7 @@ </funcsynopsis> <para> <function>yaz_error</function> retourne un message d'erreur pour la - dernière requête. Une chaîicirc;ne vide est + dernière requête. Une chaîne vide est retournée si la dernière requête a réussi. </para> <para> @@ -285,12 +286,12 @@ <function>yaz_element</function> est à utiliser en conjonction avec <function>yaz_search</function> et <function>yaz_present</function> pour spécifier le type d'éléments à lire. - La plupart des serveurs supporte <literal>F</literal> (full, tous), et + La majorité des serveurs supporte <literal>F</literal> (full, tous), et <literal>B</literal> (brief, bref). </para> <para> - <function>yaz_element</function> retourne &true; en - cas de succès, et &false; sinon. + <function>yaz_element</function> retourne <literal>TRUE</literal> en + cas de succès, et <literal>FALSE</literal> sinon. </para> </refsect1> </refentry> @@ -314,7 +315,7 @@ <function>yaz_database</function> spécifie <parameter>databases</parameter>, la ou les bases utilisées lors des recherches, lectures, etc, - en remplacant celles spécifiées lors de la fonction + en remplaçant celles spécifiées lors de la fonction <function>yaz_connect</function>. Pour indiquer plusieurs bases de données, séparez les noms par des <literal>+</literal>. </para> @@ -323,8 +324,8 @@ jeux de bases durant une session. </para> <para> - <function>yaz_database</function> retourne &true; - en cas de succès, ou &false; en cas d'erreur. + <function>yaz_database</function> retourne <literal>TRUE</literal> + en cas de succès, ou <literal>FALSE</literal> en cas d'erreur. </para> </refsect1> </refentry> @@ -378,8 +379,8 @@ et <parameter>number</parameter> vaudra 10. </para> <para> - <function>yaz_range</function> retourne &true; en - cas de succès; &false; en cas d'erreur. + <function>yaz_range</function> retourne <literal>TRUE</literal> en + cas de succès; <literal>FALSE</literal> en cas d'erreur. </para> </refsect1> </refentry> @@ -450,12 +451,12 @@ requêtes de type Type-1, comme définit dans le standard Z39.50. Cependant, dans la représentation textuelle utilisée par YAZ, une notation à préfixage est utilisée, - c'est à dire que l'opérateur précéde + c'est-à-dire que l'opérateur précédent l'opérande. La chaîne de requête est une - séquence de mots reservés, où les espaces sont + séquence de mots réservés, où les espaces sont ignorés, à moins qu'ils n'ai été - mis entre guillemets doubles. Les mots reservés qui commencent - par un arobase (<literal>@</literal>) sont considérés + mis entre guillemets doubles. Les mots réservés qui commencent + par un arobase (<literal>@</literal>) sont considérés comme des opérateurs et traités comme tels. </para> <table> @@ -469,28 +470,28 @@ </thead> <tbody> <row> - <entry><literal>@and query1 query2</literal></entry> + <entry><literal>@and query1 query2</literal></entry> <entry>intersection des requêtes query1 et query2</entry> </row> <row> - <entry><literal>@or query1 query2</literal></entry> + <entry><literal>@or query1 query2</literal></entry> <entry>union des requêtes query1 et query2</entry> </row> <row> - <entry><literal>@not query1 query2</literal></entry> + <entry><literal>@not query1 query2</literal></entry> <entry>requêtes "query1 et non(query2)"</entry> </row> <row> - <entry><literal>@set name</literal></entry> + <entry><literal>@set name</literal></entry> <entry>nomme le résultat</entry> </row> <row> - <entry><literal>@attrset set query</literal></entry> + <entry><literal>@attrset set query</literal></entry> <entry>spécifie le jeu d'attributs de la requête. Cette construction n'est autorisée qu'une seule fois, au début d'une requête.</entry> </row> <row> - <entry><literal>@attr set type=value query</literal></entry> + <entry><literal>@attr set type=value query</literal></entry> <entry>Applique les attributs à une requête. Le type et la valeur sont des entiers indiquant les types et valeurs des attributs, dans cet ordre. Le jeu, si fourni, spécifie le jeu d'attribut utilisé. @@ -515,7 +516,7 @@ </para> <para> <informalexample> - <screen>@attr 1=4 php</screen> + <screen>@attr 1=4 php</screen> </informalexample> L'attribut est de type 1 (Bib-1 use), sa valeur est 4 (Title, titre) : cette requête recherche les documents où le mot "php" @@ -523,7 +524,7 @@ </para> <para> <informalexample> - <screen>@attrset gils @and @attr 1=4 php @attr 1=1003 "Rasmus Lerdorf"</screen> + <screen>@attrset gils @and @attr 1=4 php @attr 1=1003 "Rasmus Lerdorf"</screen> </informalexample> Cette requête utilise tout le jeu d'attributs GILS. Elle recherche les documents dont le titre contient "php", et qui contiennent le @@ -588,8 +589,8 @@ contrôler le comportement de la requête de scan. Actuellement, trois index sont lus dans ce paramètre : <literal>number</literal> (nombre de termes requis), <literal>position</literal> (position préférée du terme) et - <literal>stepSize</literal> (taille du pas préferée). - Pour rééllement envoyer la requête de recherche à l'hôte, et recevoir + <literal>stepSize</literal> (taille du pas préférée). + Pour reéllement envoyer la requête de recherche à l'hôte, et recevoir la réponse, <function>yaz_wait</function> doit être appelée. A la fin de <function>yaz_wait</function>, <function>yaz_error</function> et <function>yaz_scan_result</function> auront les résultats. @@ -598,7 +599,7 @@ La syntaxe de <parameter>startterm</parameter> est similaire aux requêtes RPN, décrites dans <function>yaz_search</function>. <parameter>startterm</parameter> est constitué de zéro ou plus - spécifications, avec les opérateurs <literal>@attr</literal>, suivi par + spécifications, avec les opérateurs <literal>@attr</literal>, suivi par exactement un token. </para> <para> @@ -606,7 +607,7 @@ <title>Fonction PHP qui scanne les titres</title> <programlisting> function scan_titles($id, $starterm) { - yaz_scan($id,"rpn", "@attr 1=4 " . $starterm); + yaz_scan($id,"rpn", "@attr 1=4 " . $starterm); yaz_wait(); $errno = yaz_errno($id); if ($errno == 0) { @@ -735,12 +736,12 @@ Pour définir un champs CCL valide, utilisez la fonction <function>yaz_ccl_conf</function> avant celle-ci. Si la requête <parameter>query</parameter> a pu être convertie en - RPN, <function>yaz_ccl_parse</function> retourne &true;, + RPN, <function>yaz_ccl_parse</function> retourne <literal>TRUE</literal>, et l'index <literal>rpn</literal> du tableau <parameter>result</parameter> contient une requête RPN valide. Si la requête n'a pas pu être convertie, (pour n'importe quelle raison, comme syntaxe invalide, champs inconnu...), - <function>yaz_ccl_parse</function> retourne &false;. - Trois index sont alors créé dans le tableau de résultat : + <function>yaz_ccl_parse</function> retourne <literal>FALSE</literal>. + Trois index sont alors créés dans le tableau de résultat : <literal>errorcode</literal> (code d'erreur CCL, un entier), <literal>errorstring</literal> (message d'erreur CCL), et <literal>errorpos</literal> position estimée de l'erreur dans la @@ -766,11 +767,10 @@ <para> <function>yaz_itemorder</function> prépare une requête de type "Extended Services" en utilisant le "Profile" avec "Use of Z39.50 Item Order Extended Service to - Transport ILL (Profile/1)" (Note du Traducteur : mailes moi de l'aide!). Reportez vous - <ulink url="http://www.nlc-bnc.ca/iso/ill/stanprf.htm">ici</ulink> + Transport ILL (Profile/1)" (Note du Traducteur : mailez moi de l'aide!). Reportez-vous + <ulink url="&url.yaz.ill;">ici</ulink> ou aux - <ulink url="http://www.nlc-bnc.ca/iso/ill/document/standard/z-ill-1a.pdf"> - spécification</ulink>. + <ulink url="&url.yaz.specs">spécification</ulink>. Le paramètre <parameter>args</parameter> doit être un tableau associatif, contenant les informations "Item Order" à envoyer. L'index du tableau est le nom ASN.1 correspondant au tag path. Par exemple, le numéro ISBN sous