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
