ae Mon May 13 22:41:13 2002 EDT
Modified files:
/phpdoc-pt_BR translation.xml
/phpdoc-pt_BR/chapters intro.xml config.xml
/phpdoc-pt_BR/language basic-syntax.xml
/phpdoc-pt_BR/appendices aliases.xml about.xml
Log:
small update
Index: phpdoc-pt_BR/translation.xml
diff -u phpdoc-pt_BR/translation.xml:1.11 phpdoc-pt_BR/translation.xml:1.12
--- phpdoc-pt_BR/translation.xml:1.11 Sun May 5 14:43:04 2002
+++ phpdoc-pt_BR/translation.xml Mon May 13 22:41:13 2002
@@ -21,5 +21,6 @@
<file name="language/variables.xml" person="cpereira"
type="translation" date=""/>
<file name="reference/math/reference.xml" person="kappu"
type="translation" date="02.02.2002"/>
<file name="reference/pgsql/reference.xml" person="phaser"
type="translation" date="04.26.2002"/>
+ <file name="language/*" person="andre_ae" type="review (1 of 9)"
+date="05.12.2002"/>
</work-in-progress>
</translation>
Index: phpdoc-pt_BR/chapters/intro.xml
diff -u phpdoc-pt_BR/chapters/intro.xml:1.8 phpdoc-pt_BR/chapters/intro.xml:1.9
--- phpdoc-pt_BR/chapters/intro.xml:1.8 Wed May 1 22:14:08 2002
+++ phpdoc-pt_BR/chapters/intro.xml Mon May 13 22:41:13 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.33 Maintainer: andre_ae Status: ready -->
+<!-- EN-Revision: 1.34 Maintainer: andre_ae Status: ready -->
<chapter id="introduction">
<title>Introdu��o</title>
@@ -100,7 +100,7 @@
usando o <literal>cron</literal> ou o Agendador de Tarefas (no
Windows). Esses scripts podem ser usados tamb�m para
rotinas de processamento de texto. Veja a se��o
- <link linkend="commandline">Utilizando o PHP em
+ <link linkend="features.commandline">Utilizando o PHP em
linha de comando</link> para maiores informa��es.
</simpara>
</listitem>
Index: phpdoc-pt_BR/chapters/config.xml
diff -u phpdoc-pt_BR/chapters/config.xml:1.11 phpdoc-pt_BR/chapters/config.xml:1.12
--- phpdoc-pt_BR/chapters/config.xml:1.11 Tue Apr 30 10:53:05 2002
+++ phpdoc-pt_BR/chapters/config.xml Mon May 13 22:41:13 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.50 Maintainer: afortaleza Status: working -->
+<!-- EN-Revision: 1.52 Maintainer: andre_ae Status: ready -->
<chapter id="configuration">
<title>Configura��o</title>
@@ -441,12 +441,36 @@
<listitem>
<para>
Habilitado (On) por padr�o. Se desabilitado (Off) os scripts ir�o ser
finalizados
- t�o logo quanto ele tentar imprimir algo e descobrir que o usu�rio cancelou
a conex�o.
+ t�o logo quanto ele tentar imprimir algo e descobrir que o usu�rio cancelou
+ a conex�o.
Veja tamb�m <function>ignore_user_abort</function>.
</para>
</listitem>
</varlistentry>
+ <varlistentry id="ini.implicit-flush">
+ <term>
+ <parameter>implicit_flush</parameter>
+ <type>booleano</type>
+ </term>
+ <listitem>
+ <para>
+ &false; por default. Alterando para &true, diz ao PHP para chamar as
+ rotinas de impress�o/output automaticamente depois de cada comando de sa�da.
+ Isto � equivalente a chamar a fun��o
+ <function>flush</function> depois de cada chamada a
+ <function>print</function> ,<function>echo</function> ou depois de qualquer
+outro
+ bloco <literal>HTML</literal>.
+ </para>
+ <para>
+ Quanto utilizando o <literal>PHP</literal> em um ambiente Web, ativar
+ esta op��o tem s�rias implica��es na performance e � geralmente
+ recomendado para prop�sitos de debug. Este valor � &true; por
+ default quando operando sobre a <literal>CLI SAPI</literal>.
+ </para>
+ </listitem>
+ </varlistentry>
+
<varlistentry id="ini.include-path">
<term>
<parameter>include_path</parameter>
@@ -622,7 +646,7 @@
(que conteriam a informa��o do GET).
</simpara>
<simpara>
- Veja tamb�m <link linkend="commandline">PHP em linha de comando</link>.
+ Veja tamb�m <link linkend="features.commandline">PHP em linha de
+comando</link>.
Esta diretiva se tornou dispon�vel no PHP 4.0.0 e
estava sempre habilitanda antes desta vers�o.
</simpara>
Index: phpdoc-pt_BR/language/basic-syntax.xml
diff -u phpdoc-pt_BR/language/basic-syntax.xml:1.3
phpdoc-pt_BR/language/basic-syntax.xml:1.4
--- phpdoc-pt_BR/language/basic-syntax.xml:1.3 Wed Dec 12 15:56:34 2001
+++ phpdoc-pt_BR/language/basic-syntax.xml Mon May 13 22:41:13 2002
@@ -1,124 +1,278 @@
<?xml version="1.0" encoding="iso-8859-1"?>
- <chapter id="language.basic-syntax">
- <title>Sintaxe b�sica</title>
-
- <sect1 id="language.basic-syntax.phpmode">
- <title>Escapes do HTML</title>
-
- <para>
- H� quatro meios de escapes do HTML para entrar no modo "c�digo
- PHP":</para>
+<!-- EN-Revision: 1.33 Maintainer: andre_ae Status: ready -->
+ <chapter id="language.basic-syntax">
+ <title>Sintaxe b�sica</title>
+
+ <!--
+
+ NOTE: Last modified: 2001-05-16 13:00 GMT
+
+ the language part is currently under heavy revision. Please do not
+ not make any heavy (i.e. structural) modifications to this part
+ for a moment.
+
+ You'd also better not start any translation yet.
+
+ Comments are always welcome at [EMAIL PROTECTED]
+
+ Progress:
+
+ intro : DOESN'T EXIST - yet?
+ new chapter, with some introductionary remarks?
+ Will be discussed on the ML soon.
+ basic-syntax:
+ FINISHED
+ except maybe moving the 'advanced escaping'
+ to a better place?
+ TODO:
+ - nada
+ types : Being revised. Added all new types
+ Boolean and Integer are more or less finished.
+ The rest isn't.
+ TODO:
+ - why is $foo[bar] bad syntax?
+ - what's the difference between unset($bla) and
+ $bla = NULL; (it is different!)
+ - $obj->{expr} syntax
+ - (unset) cast?????
+ - $bla = unset <== should've been nuked, don't mention it
+ - $str{offset} syntax, rather than $str[offset]
+ - read notes and apply when any of them are useful
+ - remove notes which have been included here.
+ - ...
+ the rest: Not yet started with.
+ TODO:
+ - ?
+ oop : has been revised by Kristian, DONE.
+ -->
+
+ <sect1 id="language.basic-syntax.phpmode">
+ <title>Alternado/Escaping do HTML</title>
+
+ <para>
+ Quando o PHP interpreta um arquivo, ele simplesmente repassa o texto do arquivo
+ at� encontrar uma das tags especiais que lhe diz para
+ come�ar a interpretar o texto como c�digo PHP. O interpretador ent�o
+ executa todo o c�digo que encontra, at� chegar em uma tag de
+ fechamento PHP, que novamente o coloca simplesmente repassando
+ texto novamente. Este � o mecanismo que permite a inclus�o de c�digo
+ PHP dentro do HTML: qualquer coisa fora das tags PHP � deixado como
+ encontrado, enquanto tudo dentro � interpretado e executado.
+ </para>
+
+ <para>
+ H� quatro conjuntos de tags que podem ser usadas para marcar blocos de
+ c�digo PHP. Delas, somente duas (<?php. . .?> e <script
+ language="php">. . .</script>) s�o sempre dispon�veis. As
+ outras podem ser ativadas ou desativadas a partir do arquivo de configura��o
+ &php.ini;. Enquanto as
+ formas reduzidas das tags ou no seu estilo ASP serem convenientes, elas n�o
+ s�o port�veis em todas as vers�es. Al�m disso, se voc� pretende incluir
+ c�digo PHP em XML ou XHTML, voc� precisar� usar a forma
+ <?php ... ?> para compatibilidade com o padr�o XML.
+ </para>
+
+ <para>
+ As tags suportadas pelo PHP s�o:
+ </para>
<para>
<example>
- <title>Meios de escape do HTML</title>
- <programlisting>
-1. <? echo ("esta � a mais simples, uma instru��o de processamento SGML\n"); ?>
-
-2. <?php echo("se voc� quer servir documentos XML, fa�a assim\n"); ?>
-
-3. <script language="php">
- echo ("alguns editores (como o FrontPage) n�o gostam de
- instru��es de processamento");
- </script>
-
-4. <% echo ("Voc� pode, opcionalmente, usar tags com estilo ASP"); %>
- <%= $variable; # Este � um atalho para "<%echo .." %>
+ <title>Maneiras de alternar do HTML</title>
+ <programlisting role="php">
+<![CDATA[
+1. <?php echo("se voc� precisa dispor documentos XHTML ou XML, use assim\n"); ?>
+
+2. <? echo ("este � o mais simples, como uma instru��o de processamento SGML\n"); ?>
+ <?= espressao ?> Uma redu��o de "<? echo expressao ?>"
+
+3. <script language="php">
+ echo ("alguns editores (como o FrontPage) n�o
+ gostam de processas instru��es");
+ </script>
+
+4. <% echo ("Voc� tamb�m pode usar tags ASP opcionalmente"); %>
+ <%= $variavel; # Uma redu��o para "<% echo ..." %>
+]]>
</programlisting>
- </example></para>
-
- <para>
- O primeiro meio s� � dispon�vel se tags curtas foram habilitadas.
- Isto pode ser feito atrav�s da fun��o <function>short_tags</function>,
- habilitando a configura��o <link
linkend="ini.short-open-tag">short_open_tag</link>
- no arquivo de configura��o do PHP, ou compilando o PHP com a op��o
- --enable-short-tags em <command>configure</command>.</para>
+ </example>
+ </para>
- <para>
- O quarto meio s� � dispon�vel se tags com estilo ASP foram habilitadas, usando
- a configura��o <link linkend="ini.asp-tags">asp_tags</link>.
+ <para>
+ O primeiro m�todo, <?php. . .?>, � o preferencial, j�
+ que ele permite o uso do PHP em c�digos padr�o XML como o XHTML.
+ </para>
+
+ <para>
+ O segundo m�todo pode n�o estar sempre dispon�vel. Tags curtas est�o dispon�veis
+ apenas quando ativadas. Isto pode ser realizando atrav�s da fun��o
+ <function>short_tags</function> (PHP 3 somente), ativando
+ a diretiva de configura��o <link
+linkend="ini.short-open-tag">short_open_tag</link>
+ no arquivo de configura��o do PHP ou compilando o PHP
+ com a op��o --enable-short-tags no
+ <command>configure</command>. Mesmo que ele esteja configurado por default no
+ php.ini-dist, o uso de tags curtas � desencorajado.
+ </para>
+
+ <para>
+ A quarta maneira s� est� dispon�vel se a tag estilo ASP for
+ ativada utilizando a diretiva <link linkend="ini.asp-tags">asp_tags</link>
+ no arquivo de configura��o.
<note>
- <para>O suporte para tags com estilo ASP foram acrescentadas em 3.0.4.</para>
- </note></para>
+ <para>O suporte as tags estilo APS foi incorporada na vers�o 3.0.4.</para>
+ </note>
+ </para>
+ <note>
<para>
- A tag de fechamento para o bloco incluir� a nova linha imediatamente
- seguinte, se uma estiver presente.</para></sect1>
-
- <sect1 id="language.basic-syntax.instruction-separation">
- <title>Separa��o de instru��o</title>
-
- <simpara>
- Instru��es s�o separadas da mesma forma que em C ou perl - terminando
- cada comando com um ponto-e-v�rgula.</simpara>
+ A utiliza��o das tags curtas deve ser evitada quando do desenvolvimento de
+aplica��es
+ ou bibliotecas com inten��o de redistribui��o ou no desenvolvimento de
+ servi�os em PHP que n�o ficar�o sob seu controle, uma vez que as tags curtas
+ podem n�o estar dispon�veis no servidor de instala��o. Para portabilidade
+ de c�digo para distribui��o, tenha certeza de n�o usar tags curtas.
+ </para>
+ </note>
+
+ <para>
+ A tag de fechamento incluir� uma linha nova linha em branco
+ automaticamente se uma n�o estiver presente. Al�m, a tag de fechamento
+ automaticamente implica num ponto e v�rgula: voc� n�o precisa ter um
+ ponto e v�rgula no fim da �ltima linha de c�digo PHP.
+ </para>
<para>
- A tag de fechamento (?>) tamb�m implica no fim do comando, de forma que
- os seguintes itens s�o equivalentes:
-
- <informalexample>
- <programlisting>
-<?php
- echo "Este � um teste";
+ O PHP tamb�m suporta a utiliza��o de estruturas como essa:
+ <example><title>Alternagem avan�ada</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+if ($expression) {
+ ?>
+ <strong>Isso � verdadeiro.</strong>
+ <?php
+} else {
+ ?>
+ <strong>Isto � falso.</strong>
+ <?php
+}
+?>
+]]>
+ </programlisting>
+ </example>
+ Isso funciona como esperado porque quando o PHP encontra a tag de fechamento
+ ?>, ele simplesmente come�a a imprimir tudo at� encontrar
+ outra tag de abertura. Obviamente, o exemplo acima se aplica
+ a exibi��o de grandes blocos de texto, uma vez que sair do
+ modo de interpreta��o do PHP � geralmente mais eficiente que
+ imprimir todo o texto atrav�s de fun��es como <function>echo</function>,
+ <function>print</function> e outras.
+ </para>
+ </sect1>
+
+ <sect1 id="language.basic-syntax.instruction-separation">
+ <title>Separador de instru��es</title>
+
+ <simpara>
+ Instru��es s�o separadas da mesma forma que o C ou o Perl - cada
+ instru��o termina com um ponto e v�rgula.</simpara>
+
+ <para>
+ A tag de fechamento (?>) tamb�m implica no fim de uma instru��o, ent�o
+ os exemplos seguintes s�o equivalentes:
+
+ <informalexample>
+ <programlisting role="php">
+<![CDATA[
+<?php
+ echo "Isto � um teste";
?>
-<?php echo "Este � um teste" ?>
- </programlisting>
- </informalexample></para></sect1>
-
- <sect1 id="language.basic-syntax.comments">
- <title>Coment�rios</title>
-
- <para>
- O PHP suporta coment�rios com os estilos 'C', 'C++' e shell do Unix. Por exemplo:
-
- <informalexample><programlisting>
-<?php
- echo "Este � um teste"; // Esta linha � um coment�rio de uma linha com estilo c++
- /* Este � um coment�rio de m�ltiplas linhas
- ainda outra linha de coment�rio */
- echo "Este � ainda outro teste";
- echo "Um Teste Final"; # Este � um coment�rio com estilo shell
+<?php echo "Isto � um outro teste" ?>
+]]>
+ </programlisting>
+ </informalexample>
+ </para>
+ </sect1>
+
+ <sect1 id="language.basic-syntax.comments">
+ <title>Coment�rios</title>
+
+ <para>
+ O PHP suporta coment�rios do 'C', 'C++' e Unix shell. Por exemplo
+
+ <informalexample>
+ <programlisting role="php">
+<![CDATA[
+<?php
+ echo "Isto � um teste"; //Coment�rio de uma linha no C++
+ /* Isto � um coment�rio de mais de uma linha
+ e aqui temos outra linha */
+ echo "Isto � um outro teste";
+ echo "O �ltimo teste"; #Coment�rio no estilo Unix shell
?>
+]]>
</programlisting>
- </informalexample></para>
+ </informalexample>
+ </para>
- <simpara>
- Os estilos de coment�rio de uma linha s� funcionam at� o fim da linha ou o fim
- do bloco de c�digo PHP corrente, o que vier primeiro.</simpara>
- <informalexample><programlisting>
-<h1>Este � um exemplo <?# echo "simples";?>.</h1>
-<p>O cabe�alho acima dir� 'Este � um exemplo'.
-</programlisting></informalexample>
-
- <simpara>
- Voc� deve ter o cuidado de n�o aninhar coment�rios com estilo 'C', o que pode
- acontecer quando se comenta grandes blocos.</simpara>
-
- <informalexample><programlisting>
-<?php
- /*
- echo "Este � um teste"; /* Este coment�rio causar� um problema */
+ <simpara>
+ Os coment�rio de uma linha s� tem efeito at� o fim da
+ linha ou fim do bloco de c�digo PHP atual, o que ocorrer
+ primeiro.
+ </simpara>
+ <informalexample>
+ <programlisting role="php">
+<![CDATA[
+<h1>Isto � um <?php # echo " simples";?> exemplo.</h1>
+<p>No t�tulo acima voc� ler� 'Isto � um exemplo'.
+]]>
+ </programlisting>
+ </informalexample>
+
+ <simpara>
+ Voc� precisa ser cuidadoso com coment�rios estilo 'C' encadeados, pois
+ eles podem causar problemas em grandes blocos.
+ </simpara>
+
+ <informalexample>
+ <programlisting role="php">
+<![CDATA[
+<?php
+ /*
+ echo "Isto � um teste"; /* Este coment�rio causar� um erro */
*/
?>
- </programlisting></informalexample></sect1>
- </chapter>
-
- <!-- 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
+]]>
+ </programlisting>
+ </informalexample>
+
+ <simpara>
+ Os coment�rios de uma linha somente agem at� o fim da linha
+ atual ou o fim do bloco de c�digo PHP, o que ocorrer primeiro.
+ Isto significa que c�digo HTML ap�s <literal>// ?></literal> SER� impresso: ?>
+continuar�
+ desligando o modo PHP, retornando para o modo HTML, e o // n�o pode influenciar
+isso.
+ </simpara>
+ </sect1>
+ </chapter>
+
+<!-- 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:"../manual.ced"
- sgml-exposed-tags:nil
- sgml-local-catalogs:nil
- sgml-local-ecat-files:nil
- End:
- -->
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../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
+-->
Index: phpdoc-pt_BR/appendices/aliases.xml
diff -u phpdoc-pt_BR/appendices/aliases.xml:1.5 phpdoc-pt_BR/appendices/aliases.xml:1.6
--- phpdoc-pt_BR/appendices/aliases.xml:1.5 Tue Apr 30 10:53:05 2002
+++ phpdoc-pt_BR/appendices/aliases.xml Mon May 13 22:41:13 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.17 Maintainer: rarruda Status: ready -->
+<!-- EN-Revision: 1.18 Maintainer: rarruda Status: ready -->
<appendix id="aliases">
<title>Lista de fun��es sin�nimas (aliases)</title>
<para>
@@ -29,6 +29,11 @@
</row>
</thead>
<tbody>
+<row>
+ <entry>_</entry>
+ <entry><function>gettext</function></entry>
+ <entry><link linkend="ref.gettext">Gettext</link></entry>
+</row>
<row>
<entry>add</entry>
<entry><function>swfmovie_add</function></entry>
Index: phpdoc-pt_BR/appendices/about.xml
diff -u phpdoc-pt_BR/appendices/about.xml:1.4 phpdoc-pt_BR/appendices/about.xml:1.5
--- phpdoc-pt_BR/appendices/about.xml:1.4 Wed May 1 22:54:26 2002
+++ phpdoc-pt_BR/appendices/about.xml Mon May 13 22:41:13 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.12 Maintainer: andre_ae Status: ready -->
+<!-- EN-Revision: 1.13 Maintainer: andre_ae Status: ready -->
<!--
TODO: add manual conventions section (eg. how to read
