[PHP-DOC] cvs: phpdoc /fr/functions pspell.xml From: Egon Schmid (eschmid <email protected>)
Date: 07/22/00

eschmid Sat Jul 22 07:00:19 2000 EDT

  Added files:
    /phpdoc/fr/functions pspell.xml
  Log:
  Added missing file.
  

Index: phpdoc/fr/functions/pspell.xml
+++ phpdoc/fr/functions/pspell.xml
 <reference id="ref.pspell">
  <title>Pspell Functions</title>
  <titleabbrev>Pspell</titleabbrev>

  <partintro>
   <simpara>
    The <function>pspell</function> functions allows you to check the
    spelling on a word and offer suggestions.
   </simpara>
   <simpara>
    You need the aspell and pspell libraries, available from: <ulink
    url="&url.pspell;">&url.pspell;</ulink>.
   </simpara>
  </partintro>

  <refentry id="function.pspell-new">
   <refnamediv>
    <refname>pspell_new</refname>
    <refpurpose>Load a new dictionary</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>int <function>pspell_new</function></funcdef>
      <paramdef>string <parameter>language</parameter></paramdef>
      <paramdef>string
       <parameter>
        <optional>spelling</optional>
       </parameter>
      </paramdef>
      <paramdef>string
       <parameter>
        <optional>jargon</optional>
       </parameter>
      </paramdef>
      <paramdef>string
       <parameter>
        <optional>encoding</optional>
       </parameter>
      </paramdef>
     </funcprototype>
    </funcsynopsis>
    <simpara>
     <function>Pspell_new</function> opens up a new dictionary and
     returns the dictionary link identifier for use in other pspell
     functions.
    </simpara>
    <para>
     The language parameter is the language code which consists of the
     two letter ISO 639 language code and an optional two letter ISO
     3166 country code after a dash or underscore. The spelling
     parameter is the requested spelling for languages with more than
     one spelling such as English. Known values are ``american'',
     ``britsh'', and ``canadian''. The jargon parameter contains extra
     information two distinguish two different words lists that have
     the same language-tag and spelling. The encoding parameter is the
     encoding that words are expected to be in. Valid values are
     'utf-8', 'iso8859-*', 'koi8-r', 'viscii', 'cp1252', 'machine
     unsigned 16', 'machine unsigned 32'. This parameter is largely
     untested, so be careful when using. For more information and
     examples, check out inline manual pspell website:<ulink
     url="&url.pspell;">&url.pspell;</ulink>.
    </para>
    <para>
     <example>
      <title><function>Pspell_new</function></title>
      <programlisting role="php">
$pspell_link = pspell_new ("english");
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.pspell-mode">
   <refnamediv>
    <refname>pspell_mode</refname>
    <refpurpose>Change spellchecking mode</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>boolean <function>pspell_mode</function></funcdef>
      <paramdef>int <parameter>dictionary_link</parameter></paramdef>
      <paramdef>int <parameter>mode</parameter></paramdef>
     </funcprototype>
    </funcsynopsis>
    <simpara>
     <function>Pspell_mode</function> changes the spellchecking mode.
    </simpara>
    <para>There are three modes available:
     <itemizedlist>
      <listitem>
       <simpara>
        PSPELL_FAST - Fast mode (least number of suggestions)
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        PSPELL_NORMAL - Normal mode (more suggestions)
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        PSPELL_BAD_SPELLERS - Slow mode (a lot of suggestions)
       </simpara>
      </listitem>
     </itemizedlist>
    </para>
    <para>
     <example>
      <title><function>Pspell_mode</function></title>
      <programlisting role="php">
$pspell_link = pspell_new ("english");
pspell_mode (PSPELL_FAST);

if (!pspell_check ($pspell_link, "testt")) {
    $suggestions = pspell_suggest ($pspell_link, "testt");
}
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.pspell-runtogether">
   <refnamediv>
    <refname>pspell_runtogether</refname>
    <refpurpose>
     Consider run-together words as legal compounds
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>boolean <function>pspell_runtogether</function></funcdef>
      <paramdef>int <parameter>dictionary_link</parameter></paramdef>
      <paramdef>int <parameter>mode</parameter></paramdef>
     </funcprototype>
    </funcsynopsis>
    <simpara>
     <function>Pspell_runtogether</function> Consider run-together
     words as legal compounds. That is, "thecat" will be a legal
     compound, athough there should be a space between the two
     words. Changing this setting only affects the results returned by
     <function>pspell_check</function>;
     <function>pspell_suggest</function> will still return
     suggestions, and they are not affected by the calls to
     <function>php_runtogether</function>.
    </simpara>
    <para>
     <example>
      <title><function>Pspell_runtogether</function></title>
      <programlisting role="php">
$pspell_link = pspell_new ("english");
pspell_runtogether (true);
echo pspell_runtogether ($pspell_link, "thecat") ? "correct" : "wrong";
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.pspell-check">
   <refnamediv>
    <refname>pspell_check</refname>
    <refpurpose>Check a word</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>boolean <function>pspell_check</function></funcdef>
      <paramdef>int <parameter>dictionary_link</parameter></paramdef>
      <paramdef>string <parameter>word</parameter></paramdef>
     </funcprototype>
    </funcsynopsis>
    <simpara>
     <function>Pspell_check</function> checks the spelling of a word
     and returns true if the spelling is correct, false if not.
    </simpara>
    <para>
     <example>
      <title><function>Pspell_check</function></title>
      <programlisting role="php">
$pspell_link = pspell_new ("english");

if (pspell_check ($pspell_link, "testt")) {
    echo "This is a valid spelling";
} else {
    echo "Sorry, wrong spelling";
}
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.pspell-suggest">
   <refnamediv>
    <refname>pspell_suggest</refname>
    <refpurpose>Suggest spellings of a word</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
    <funcsynopsis>
     <funcprototype>
      <funcdef>array <function>pspell_suggest</function></funcdef>
      <paramdef>int <parameter>dictionary_link</parameter></paramdef>
      <paramdef>string <parameter>word</parameter></paramdef>
     </funcprototype>
    </funcsynopsis>
    <simpara>
     <function>Pspell_suggest</function> returns an array of possible
     spellings for the given word.
    </simpara>
    <para>
     <example>
      <title><function>Pspell_suggest</function></title>
      <programlisting role="php">
$pspell_link = pspell_new ("english");

if (!pspell_check ($pspell_link, "testt")){
    $suggestions = pspell_suggest ($pspell_link, "testt");

    for ($i=0; $i &lt; count ($suggestions); $i++) {
        echo "Possible spelling: " . $suggestions[$i] . "&lt;br>";
    }
}
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

 </reference>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->