andre_ae Sun May 5 04:49:58 2002 EDT
Modified files:
/phpdoc-pt_BR translation.xml
/phpdoc-pt_BR/appendices debugger.xml
Log:
EN-sync
Index: phpdoc-pt_BR/translation.xml
diff -u phpdoc-pt_BR/translation.xml:1.8 phpdoc-pt_BR/translation.xml:1.9
--- phpdoc-pt_BR/translation.xml:1.8 Wed May 1 22:12:09 2002
+++ phpdoc-pt_BR/translation.xml Sun May 5 04:49:57 2002
@@ -22,6 +22,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="appendices/*" person="andre_ae" type="translate (3 of 50)"
date="05.01.2002"/>
+ <file name="appendices/*" person="andre_ae" type="review (4 of 9)"
+date="05.05.2002"/>
</work-in-progress>
</translation>
Index: phpdoc-pt_BR/appendices/debugger.xml
diff -u phpdoc-pt_BR/appendices/debugger.xml:1.9
phpdoc-pt_BR/appendices/debugger.xml:1.10
--- phpdoc-pt_BR/appendices/debugger.xml:1.9 Sat Apr 27 13:33:41 2002
+++ phpdoc-pt_BR/appendices/debugger.xml Sun May 5 04:49:58 2002
@@ -1,50 +1,76 @@
<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- EN-Revision: 1.20 Maintainer: andre_ae Status: ready -->
<appendix id="debugger">
<title>O debugador do PHP</title>
+ <sect1 id="debugger-about">
+ <title>Sobre o debugador</title>
+ <simpara>
+ O PHP 3 tem suporte ao debug baseado em rede.
+ </simpara>
+ <simpara>
+ O PHP 4 n�o possui um utilit�rio de debug interno.
+ Mas voc� pode utilizar debugadores externos alternativamente. O
+ <ulink url="&url.zend.ide;">Zend IDE</ulink> inclui
+ um debugador e h� tamb�m outras extens�es gr�tis
+ como o DBG em <ulink url="&url.dbg;">&url.dbg;</ulink> ou o
+ <ulink url="&url.apd;">Advanced PHP Debugger</ulink> (APD).
+ </simpara>
+ </sect1>
+
<sect1 id="debugger-using">
- <title>Usando o Debugador</title>
+ <title>Utilizando o debugador</title>
<para>
- O debugador do PHP � util para procurar "bugs" simples.
- O debugador trabalha conectando numa porta <acronym>TCP</acronym> para cada
- se��o PHP aberta. Todas as mensagens de erro ser�o enviadas a esta conec��o TCP.
- Esta informa��o tem inten��o de "debugar" o servidor de dentro de um sistema
- <acronym>IDE</acronym> ou editor de arquivos program�vel (como o Emacs). Esse
- debugador est� dispon�vel somente no PHP vers�o 3, e n�o pode ser utilizado
- nas vers�es mais novas do PHP.
+ O debugador interno do PHP 3 � �til para rastrear bugs
+ fugitivos. O debugador trabalha conectado em uma porta
+ <acronym>TCP</acronym> cada vez que o PHP 3 inicia.
+ Todas as mensagens de erro daquela requisi��o ser� enviada para esta
+ conex�o TCP. Estas informa��es s�o destinadas a
+ "debugar o servidor" de dentro de um sistema
+ <acronym>IDE</acronym> ou editor de arquivos program�vel (como o Emacs).
</para>
<para>
- Como levantar o debugger:
+ Como ativar o debugger:
<orderedlist>
<listitem>
- <simpara>
- Configure uma porta TCP para ele no <link
+ <simpara>
+ Configure uma porta TCP para ele no <link
linkend="configuration.file">arquivo de configura��o</link> (<link
- linkend="ini.debugger.port">debugger.port</link>) e habilite ele
+ linkend="ini.debugger.port">debugger.port</link>) e habilite ele
(<link linkend="ini.debugger.enabled">debugger.enabled</link>).
</simpara>
</listitem>
<listitem>
- <simpara>
+ <simpara>
Configure um "ouvidor" TCP naquela porta em algum programa (por exemplo
<command>socket -l -s 1400</command> no UNIX).
</simpara>
</listitem>
<listitem>
- <simpara>
- Em seu c�digo execute "debugger_on(<replaceable>m�quina</replaceable>)", onde
<replaceable>m�quina</replaceable> � o n�mero IP ou nome do computador executando o
"ouvidor" <acronym>TCP</acronym> .
+ <simpara>
+ Em seu c�digo execute um
+ "debugger_on(<replaceable>endere�o</replaceable>)", onde
+ <replaceable>endere�o</replaceable> � o n�mero IP ou nome do
+ computador executando o "ouvidor" <acronym>TCP</acronym>.
</simpara>
</listitem>
</orderedlist>
- Agora, todas as mensagens aparecer� no computador que est� "ouvindo",<emphasis>
mesmo que voc� desligue com <function>error_reporting</function></emphasis>.
+ Agora, todos os alarmes, avisos, etc. aparecer�o no computador que est�
+ "ouvindo", <emphasis> mesmo que voc� desligue com
+ <function>error_reporting</function></emphasis>.
</para>
</sect1>
<sect1 id="debugger-protocol">
<title>Protocolo do Debugger</title>
<para>
- O protocolo � baseado em linhas. Cada linha tem um <emphasis>tipo</emphasis>, e
v�rias linhas compondo a <emphasis>mensagem</emphasis>. Cada mensagem come�a com uma
linha de tipo <literal>start</literal> e termina com uma linha de tipo
<literal>end</literal>. O PHP pode emviar linhas para diferentes mensagens
simultaneamente.
+ O protocolo do debugador do PHP 3 � baseado em linhas. Cada linha tem um
+ <emphasis>tipo</emphasis>, e v�rias linhas comp�em uma
+ <emphasis>mensagem</emphasis>. Cada mensagem come�a com uma linha
+ do tipo <literal>start</literal> e termina com uma linha
+ do tipo <literal>end</literal>. O PHP 3 pode enviar linhas de diferentes
+ mensagens simultaneamente.
</para>
<para>
Uma linha tem este formato:
@@ -78,7 +104,8 @@
<term><replaceable>host</replaceable></term>
<listitem>
<simpara>
- "Nome DNS ou IP da maquina onde est� o script".
+ Nome DNS ou IP da maquina onde o erro do script foi
+ gerado.
</simpara>
</listitem>
</varlistentry>
@@ -86,7 +113,8 @@
<term><replaceable>pid</replaceable></term>
<listitem>
<simpara>
- ID do processo na <replaceable>m�quina</replaceable> do processo que gerou
este erro de script.
+ ID do processo na <replaceable>m�quina</replaceable> do
+ processo com o PHP 3 que gerou este erro de script.
</simpara>
</listitem>
</varlistentry>
@@ -94,7 +122,8 @@
<term><replaceable>type</replaceable></term>
<listitem>
<para>
- Tipo da linha. Informa o programa sobre como ele deve tratar os seguintes
dados:
+ Tipo da linha. Informa o programa sobre como ele
+ deve tratar os seguintes dados:
<table>
<title>Tipos de Linhas de Debug</title>
<tgroup cols="2">
@@ -106,44 +135,54 @@
</thead>
<tbody>
<row>
- <entry><literal>start</literal></entry>
+ <entry><literal>start</literal></entry>
<entry>
- Informa ao programa que a mensagem come�a aqui. O conte�do de
<replaceable>data</replaceable> ser� o tipo de erro da mensagem, listado abaixo.
+ Informa ao programa que a mensagem
+ come�a aqui. O conte�do de
+ <replaceable>data</replaceable> ser� o tipo de erro
+ da mensagem, como listado abaixo.
</entry>
</row>
<row>
<entry><literal>message</literal></entry>
- <entry>A mensagem de erro do PHP.</entry>
+ <entry>A mensagem de erro do PHP 3.</entry>
</row>
<row>
<entry><literal>location</literal></entry>
<entry>
- Arquivo e n�mero da linha onde ocorreu o erro. A primeira linha
<literal>location</literal> sempre conter� o n�vel superior.
+ Arquivo e n�mero da linha onde ocorreu o erro. A
+ primeira linha <literal>location</literal> sempre
+ conter� o n�vel superior.
<replaceable>data</replaceable> conter�:
<literal><replaceable>arquivo</replaceable>:<replaceable>linha</replaceable></literal>.
- Sempre existir� uma linha <literal>location</literal> ap�s uma
<literal>message</literal> e ap�s cada <literal>function</literal>.
+ Sempre existir� uma linha <literal>location</literal>
+ ap�s uma <literal>message</literal> e ap�s cada
+ <literal>function</literal>.
</entry>
</row>
<row>
<entry>
<literal>frames</literal></entry> <entry>N�mero de janelas (frames)
- na saida atual. Se houver quatro n�veis, ser� esperado informa��o sobre
quatro n�veis de fun��es chamadas.
+ na saida atual. Se houver quatro n�veis,
+ ser� esperado informa��o sobre quatro n�veis de fun��es chamadas.
Se n�o for dada nenhuma linha de janela (frame) assume que o valor � 0
(o erro aconteceu no in�cio).
</entry>
</row>
<row>
<entry>
- <literal>function</literal></entry>
+ <literal>function</literal></entry>
<entry>
- Nome da fun��o onde o erro apareceu. Ser� repetida para cada vez que
- a fun��o for chamada.
+ Nome da fun��o onde o erro ocorreu. Ser�
+ repetida para cada vez que a fun��o for chamada
+ dentro da pilha.
</entry>
</row>
<row>
- <entry><literal>end</literal></entry>
+ <entry><literal>end</literal></entry>
<entry>
- Informa ao programa que a mensagem de debug termina aqui.
+ Informa ao programa que a mensagem de debug termina
+ aqui.
</entry>
</row>
</tbody>
@@ -161,49 +200,49 @@
</variablelist>
<table>
- <title>Tipos de erros de debuga��o</title>
+ <title>Tipos de erros de debug</title>
<tgroup cols="2">
<thead>
<row>
<entry>Debugador</entry>
- <entry>Interno do PHP</entry>
+ <entry>Interno do PHP 3</entry>
</row>
</thead>
<tbody>
<row>
- <entry><errortype>aten��o</errortype></entry>
+ <entry><errortype>warning (alerta, aten��o)</errortype></entry>
<entry><errortype>E_WARNING</errortype></entry>
</row>
<row>
- <entry><errortype>erro</errortype></entry>
+ <entry><errortype>error (erro)</errortype></entry>
<entry><errortype>E_ERROR</errortype></entry>
</row>
<row>
- <entry><errortype>interpreta��o</errortype></entry>
+ <entry><errortype>parse (interpreta��o)</errortype></entry>
<entry><errortype>E_PARSE</errortype></entry>
</row>
<row>
- <entry><errortype>notifica��o</errortype></entry>
+ <entry><errortype>notice (notifica��o)</errortype></entry>
<entry><errortype>E_NOTICE</errortype></entry>
</row>
<row>
- <entry><errortype>grave erro</errortype></entry>
+ <entry><errortype>core-error (erro grave)</errortype></entry>
<entry><errortype>E_CORE_ERROR</errortype></entry>
</row>
<row>
- <entry><errortype>grave aten��o</errortype></entry>
+ <entry><errortype>core-warning (aviso grave)</errortype></entry>
<entry><errortype>E_CORE_WARNING</errortype></entry>
</row>
<row>
- <entry><errortype>desconhecido</errortype></entry>
+ <entry><errortype>unknown (desconhecido)</errortype></entry>
<entry>(qualquer outro)</entry>
</row>
</tbody>
</tgroup>
</table>
-
+
<example>
- <title>Exemplo de Mensagem de Debug</title>
+ <title>Exemplo de uma mensagem de Debug</title>
<literallayout>
1998-04-05 23:27:400966 lucifer.guardian.no(20481) start: notice
1998-04-05 23:27:400966 lucifer.guardian.no(20481) message: Uninitialized variable
@@ -235,4 +274,7 @@
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
-->
