Update com_load_typelib (#148)

Author: DavidePastore

reference/com/functions/com-load-typelib.xml

@@ -1,26 +1,90 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!-- splitted from ./it/functions/com.xml, last change in rev 1.1 -->
-<!-- last change to 'com-load-typelib' in en/ tree in rev 1.27 -->
-<!-- EN-Revision: n/a Maintainer: cucinato Status: ready -->
-<!-- OLD-Revision: 1.32/EN.1.27 -->
-  <refentry xml:id='function.com-load-typelib' xmlns="http://docbook.org/ns/docbook">
-   <refnamediv>
-    <refname>com_load_typelib</refname>
-    <refpurpose>Carica una Typelib</refpurpose>
-   </refnamediv>
-   <refsect1>
-    <title>Descrizione</title>
-     <methodsynopsis>
-      <type>void</type><methodname>com_load_typelib</methodname>
-      <methodparam><type>string</type><parameter>nome_typelib</parameter></methodparam>
-      <methodparam choice="opt"><type>int</type><parameter>ignora_maiuscole</parameter></methodparam>
-     </methodsynopsis>
-    <para>
-     &warn.undocumented.func;
-    </para>
-   </refsect1>
-  </refentry>
-
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: b9043112d87ec0ca6db17276d7013acc2368ed33 Maintainer: pastore Status: ready -->
+<!-- CREDITS: cucinato -->
+<refentry xml:id="function.com-load-typelib" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>com_load_typelib</refname>
+  <refpurpose>Carica una Typelib</refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>bool</type><methodname>com_load_typelib</methodname>
+   <methodparam><type>string</type><parameter>typelib</parameter></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>case_insensitive</parameter><initializer>&true;</initializer></methodparam>
+  </methodsynopsis>
+  <para>
+   Carica una type-library e registra le sue costanti nel motore, come se
+   fossero definite usando <function>define</function>.
+  </para>
+  <para>
+   Nota che è molto più efficiente utilizzare l'impostazione <link
+   linkend="ini.com.typelib-file">com.typelib-file</link> in &php.ini; per pre-caricare e
+   registrare le costanti, anche se non è così flessibile.
+  </para>
+  <para>
+   Se <link linkend="ini.com.autoregister-typelib">com.autoregister-typelib</link> è attivo, allora
+   PHP tenterà di registrare automaticamente le costanti associate a un
+   oggetto COM quando lo si istanzia.  Questo dipende dalle interfacce
+   fornite dall’oggetto COM stesso e potrebbe non essere sempre possibile.
+  </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>typelib</parameter></term>
+     <listitem>
+      <para>
+       <parameter>typelib</parameter> può essere uno dei seguenti:
+       <itemizedlist>
+        <listitem>
+         <para>
+          Il nome del file di un <literal>.tlb</literal> o del modulo eseguibile
+          che contiene la type-library.
+         </para>
+        </listitem>
+        <listitem>
+         <para>
+          Il GUID della type-library, seguito dal numero di versione, ad esempio
+          <literal>{00000200-0000-0010-8000-00AA006D2EA4},2,0</literal>.
+         </para>
+        </listitem>
+        <listitem>
+         <para>
+          Il nome della type-library, ad esempio <literal>Microsoft OLE DB ActiveX Data
+          Objects 1.0 Library</literal>.
+         </para>
+        </listitem>
+       </itemizedlist>
+       PHP tenterà di risolvere la type-library in questo ordine, poiché
+       il processo diventa sempre più costoso man mano che si scende nella lista;
+       la ricerca della type-library per nome viene effettuata enumerando fisicamente
+       il registro fino a trovare una corrispondenza.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>case_insensitive</parameter></term>
+     <listitem>
+      <para>
+       Il parametro <parameter>case_insensitive</parameter> si comporta inversamente
+       rispetto al parametro <literal>$case_insensitive</literal> nella funzione
+       <function>define</function>.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.success;
+  </para>
+ </refsect1>
+</refentry>
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
@@ -40,4 +104,4 @@ End:
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
--->
+-->