Skip to content

Commit

Permalink
initial translation in enchant/functions
Browse files Browse the repository at this point in the history
  • Loading branch information
leonardolara committed Feb 24, 2025
1 parent d3080b3 commit fc855d2
Show file tree
Hide file tree
Showing 12 changed files with 1,316 additions and 0 deletions.
151 changes: 151 additions & 0 deletions reference/enchant/functions/enchant-broker-describe.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,151 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 6fa29283c5861ccb1f9da74fb252f80e01d27668 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<refentry xml:id="function.enchant-broker-describe" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>enchant_broker_describe</refname>
<refpurpose>Enumera os provedores de Enchant</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>array</type><methodname>enchant_broker_describe</methodname>
<methodparam><type>EnchantBroker</type><parameter>broker</parameter></methodparam>
</methodsynopsis>
<para>
Enumera os provedores de Enchant e fornece algumas informações rudimentares
sobre eles. A mesma informação é fornecida por phpinfo().
</para>

</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
&enchant.param.broker;
</variablelist>
</para>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Retorna um &array; de provedores Enchant com seus detalhes.
</para>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&enchant.changelog.broker-param;
<row>
<entry>8.0.0</entry>
<entry>
Antes deseta versão, a função retornava &false; em caso de falha.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Lista os backends providos pelo broker informado</title>
<programlisting role="php">
<![CDATA[
<?php
$r = enchant_broker_init();
$bprovides = enchant_broker_describe($r);
echo "O broker atual fornece os seguintes backend(s):\n";
print_r($bprovides);
?>
]]>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
O broker atual fornece os seguintes backend(s):
Array
(
[0] => Array
(
[name] => aspell
[desc] => Aspell Provider
[file] => /usr/lib/enchant/libenchant_aspell.so
)
[1] => Array
(
[name] => hspell
[desc] => Hspell Provider
[file] => /usr/lib/enchant/libenchant_hspell.so
)
[2] => Array
(
[name] => ispell
[desc] => Ispell Provider
[file] => /usr/lib/enchant/libenchant_ispell.so
)
[3] => Array
(
[name] => myspell
[desc] => Myspell Provider
[file] => /usr/lib/enchant/libenchant_myspell.so
)
)
]]>
</screen>
</example>
</para>
</refsect1>



<!-- Use when adding See Also links
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function></function></member>
<member>Or <link linkend="somethingelse">something else</link></member>
</simplelist>
</para>
</refsect1>
-->


</refentry>
<!-- 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
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
109 changes: 109 additions & 0 deletions reference/enchant/functions/enchant-broker-dict-exists.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,109 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 6fa29283c5861ccb1f9da74fb252f80e01d27668 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<refentry xml:id="function.enchant-broker-dict-exists" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>enchant_broker_dict_exists</refname>
<refpurpose>Informa se um dicionário existe ou não, usando etiqueta não vazia</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>enchant_broker_dict_exists</methodname>
<methodparam><type>EnchantBroker</type><parameter>broker</parameter></methodparam>
<methodparam><type>string</type><parameter>tag</parameter></methodparam>
</methodsynopsis>
<para>
Informa se um dicionário existe ou não, usando etiqueta não vazia.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
&enchant.param.broker;
<varlistentry>
<term><parameter>tag</parameter></term>
<listitem>
<para>
Etiqueta não vazia no formato da localidade, por exemplo, us_US, pt_BR, etc.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Retorna &true; quando a etiqueta existe ou &false; quando não existe.
</para>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&enchant.changelog.broker-param;
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Um exemplo de <function>enchant_broker_dict_exists</function></title>
<programlisting role="php">
<![CDATA[
<?php
$tag = 'en_US';
$r = enchant_broker_init();
if (enchant_broker_dict_exists($r,$tag)) {
echo "Dicionário $tag encontrado.\n";
}
?>
]]>
</programlisting>
</example>
</para>
</refsect1>


<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>enchant_broker_describe</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- 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
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
101 changes: 101 additions & 0 deletions reference/enchant/functions/enchant-broker-free-dict.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,101 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<refentry xml:id="function.enchant-broker-free-dict" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>enchant_broker_free_dict</refname>
<refpurpose>Libera um recurso de dicionário</refpurpose>
</refnamediv>

<refsynopsisdiv>
&warn.deprecated.function-8-0-0;
</refsynopsisdiv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type>bool</type><methodname>enchant_broker_free_dict</methodname>
<methodparam><type>EnchantDictionary</type><parameter>dictionary</parameter></methodparam>
</methodsynopsis>
<para>
Libera um recurso de dicionário
A partir do PHP 8.0.0, é recomendado remover a definição deste objeto em vez de chamar esta função.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
&enchant.param.dictionary;
</variablelist>
</para>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Esta função foi descontinuada em favor de remover a definição do objeto.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
<parameter>dictionary</parameter> agora espera um objeto <classname>EnchantDictionary</classname>;
anteriormente, esperava um &resource;.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>enchant_broker_request_dict</function></member>
<member><function>enchant_broker_request_pwl_dict</function></member>
</simplelist>
</para>
</refsect1>


</refentry>
<!-- 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
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
Loading

0 comments on commit fc855d2

Please sign in to comment.