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
