andre_ae                Tue Apr 30 10:53:06 2002 EDT

  Modified files:              
    /phpdoc/pt_BR       bookinfo.xml language-snippets.ent 
    /phpdoc/pt_BR/appendices    aliases.xml 
    /phpdoc/pt_BR/chapters      config.xml intro.xml 
  Log:
  bookinfo.xml - update/revcheck clean
  language-snippets.ent - typos/revcheck clean
  intro.xml - remove brief-history & update
  config.xml - typos, WS, updates, ...
  appendices/about.xml - initial translation
  
Index: phpdoc/pt_BR/bookinfo.xml
diff -u phpdoc/pt_BR/bookinfo.xml:1.13 phpdoc/pt_BR/bookinfo.xml:1.14
--- phpdoc/pt_BR/bookinfo.xml:1.13      Sat Apr 27 10:44:09 2002
+++ phpdoc/pt_BR/bookinfo.xml   Tue Apr 30 10:53:05 2002
@@ -1,7 +1,6 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.12 Maintainer: rarruda Status: ready -->
-<!-- $Revision: 1.13 $ -->
- 
+<!-- EN-Revision: 1.26 Maintainer: andre_ae Status: ready -->
+
  <bookinfo id="bookinfo">
   <authorgroup id="authors">
 
@@ -40,7 +39,7 @@
   </authorgroup>
 
   <pubdate>&php.build-date;</pubdate>
- 
+
   <authorgroup id="editors">
    <editor>
     <firstname>Stig</firstname><surname>S&aelig;ther Bakken</surname>
@@ -89,7 +88,7 @@
    <title>Copyright</title>
    <simpara>
     Este manual é &copy; Copyright 1997, 1998, 1999, 2000, 2001, 2002 pelo
-    PHP Documentation Group. Os membros deste grupo são listados 
+    PHP Documentation Group. Os membros deste grupo são listados
     na primeira página deste manual.
    </simpara>
    <simpara>
@@ -108,7 +107,7 @@
   </legalnotice>
 
  </bookinfo>
- 
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
Index: phpdoc/pt_BR/language-snippets.ent
diff -u phpdoc/pt_BR/language-snippets.ent:1.7 phpdoc/pt_BR/language-snippets.ent:1.8
--- phpdoc/pt_BR/language-snippets.ent:1.7      Fri Apr 19 23:06:02 2002
+++ phpdoc/pt_BR/language-snippets.ent  Tue Apr 30 10:53:05 2002
@@ -1,13 +1,27 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.24 Maintainer: rarruda Status: ready -->
-
-<!ENTITY warn.experimental '<warning><simpara>Este módulo é 
<emphasis>EXPERIMENTAL</emphasis>. Isso quer dizer que o comportamento destas funções 
e seus nomes, incluindo TUDO o que está documentado aqui pode mudar em futuras versões 
do PHP, SEM QUALQUER NOTIFICAÇÃO. Esteja avisado, e use este módulo por sua própria 
conta e risco.</simpara></warning>'>
-
-<!ENTITY warn.experimental.func '<warning><simpara>Esta função é 
<emphasis>EXPERIMENTAL</emphasis>. Isso quer dizer que o comportamento desta função e 
seu nome, incluindo TUDO o que está documentado aqui pode mudar em futuras versões do 
PHP, SEM QUALQUER NOTIFICAÇÃO. Esteja avisado, e use esta função por sua própria conta 
e risco.</simpara></warning>'>
-
-<!ENTITY warn.undocumented.func '<warning><simpara>Esta função não está documentada, 
somente a lista de argumentos está disponível.</simpara></warning>'>
-
-<!ENTITY tip.ob-capture '<tip><simpara>Como toda saída é normalmente enviada direto 
para o browser, você pode usar as <link linkend="ref.outcontrol">Funções de Controle 
de Output</link> para capturar o resultado e guardá-lo (por exemplo) em uma 
<type>string</type>.</simpara></tip>'>
+<!-- EN-Revision: 1.25 Maintainer: andre_ae Status: ready -->
+<!ENTITY warn.experimental '<warning><simpara>Este módulo é 
+<emphasis>EXPERIMENTAL</emphasis>. Isso quer dizer que o comportamento destas funções
+e seus nomes, incluindo TUDO o que está documentado aqui
+pode mudar em futuras versões do PHP, SEM QUALQUER NOTIFICAÇÃO. 
+Esteja avisado, e use este módulo por sua própria conta e 
+risco.</simpara></warning>'>
+
+<!ENTITY warn.experimental.func '<warning><simpara>Esta função é 
+<emphasis>EXPERIMENTAL</emphasis>. Isso quer dizer que o comportamento desta função 
+e seu nome, incluindo TUDO o que está documentado aqui 
+pode mudar em futuras versões do PHP, SEM QUALQUER NOTIFICAÇÃO. 
+Esteja avisado, e use esta função por sua própria conta e risco.</simpara></warning>'>
+
+<!ENTITY warn.undocumented.func '<warning><simpara>Esta função 
+não está documentada, somente a lista de argumentos está 
+disponível.</simpara></warning>'>
+
+<!ENTITY tip.ob-capture '<tip><simpara>Como toda saída é normalmente 
+enviada direto para o browser, você pode usar as <link 
+linkend="ref.outcontrol">Funções de Controle de Output</link> para capturar 
+o resultado e guardá-lo (por exemplo) em uma 
+<type>string</type>.</simpara></tip>'>
 
 <!ENTITY tip.fopen-wrapper '<tip><simpara>Você pode usar uma URL com esta
 função se "fopen wrappers" estiver habilitado
@@ -15,56 +29,70 @@
 
 <!ENTITY return.success 'Retorna &true; em caso de sucesso ou &false; em falhas.'>
 
-<!ENTITY return.falseproblem '<warning><simpara>Esta função pode retornar &false;, 
mas também pode retornar um valor avaliado como &false; em uma instrução simples;, 
como <literal>0</literal> ou &quot;&quot;. Utilize o <link 
linkend="language.operators.comparison">operador ===</link> para testar o valor 
retornado por esta função.<simpara></warning>'>
+<!ENTITY return.falseproblem '<warning><simpara>Esta função pode 
+retornar o booleano &false;, mas também pode retornar um valor não-booleano que pode 
+ser 
+avaliado como &false;, como <literal>0</literal> ou 
+&quot;&quot;. Leia a seção em <link
+linkend="language.types.boolean">Booleanos</link> para maiores 
+informações. Utilize o <link linkend="language.operators.comparison">operador ===
+</link> para testar o valor retornado por esta 
+função.<simpara></warning>'>
 
 <!-- Notas variadas -->
-<!ENTITY note.not-bin-safe '<warning><simpara>Esta função (ainda) não é compatível 
com dados binários!</simpara></warning>'>
+<!ENTITY note.not-bin-safe '<warning><simpara>Esta função 
+(ainda) não é compatível com dados binários!</simpara></warning>'>
 
-<!ENTITY note.bin-safe '<note><simpara>Esta função é compatível com dados 
binários</simpara></note>'>
+<!ENTITY note.bin-safe '<note><simpara>Esta função é 
+compatível com dados binários</simpara></note>'>
 
-<!ENTITY note.no-windows '<note><simpara>esta função não é implementada na plataforma 
Windows</simpara></note>'>
+<!ENTITY note.no-windows '<note><simpara>esta função não é 
+implementada na plataforma Windows</simpara></note>'>
 
-<!ENTITY note.func-callback '<note><simpara> Ao invez de um nome de função, um array 
contendo uma referência a um objeto e ao nome de um método também pode ser 
passado.</simpara></note>'>
+<!ENTITY note.func-callback '<note><simpara>Ao invez de um nome de função, um 
+array contendo uma referência de objeto e ao nome de método também pode ser
+fornecidos.</simpara></note>'>
 
 <!-- Notas das limitacoes do Safe-Mode -->
-
 <!ENTITY note.sm.disabled '<note><simpara>&sm.disabled;</simpara></note>'>
 
-<!ENTITY note.sm.uidcheck '<note><simpara>Quando o <link 
-linkend="features.safe-mode">safe-mode</link> está ativo, o PHP verifica se 
-o(s) arquivo(s) e/ou diretório(s) que serão afetados por esta operação tem o mesmo 
<literal>UID</literal> do script que está sendo executado.</simpara></note>'>
+<!ENTITY note.sm.uidcheck '<note><simpara>Quando o <link
+linkend="features.safe-mode">safe-mode</link> está ativo, o PHP verifica se
+o(s) arquivo(s) e/ou diretório(s) que serão afetados por esta operação tem o mesmo 
+<literal>UID</literal> 
+do script que está sendo executado.</simpara></note>'>
 
-<!ENTITY note.sm.uidcheck.dir '<note><simpara>Quando o <link 
-linkend="features.safe-mode">safe-mode</link> está ativo, o PHP verifica se 
+<!ENTITY note.sm.uidcheck.dir '<note><simpara>Quando o <link
+linkend="features.safe-mode">safe-mode</link> está ativo, o PHP verifica se
 o diretório que será afetado por essa operação tem o mesmo <literal>UID</literal>
 do script que está sendo executado.</simpara></note>'>
 
 <!-- Peças comuns em features/safe-mode.xml porque o
      Jade não permite entidades in-lines, então eu coloquei aqui... Assim eles
      podem ser in-line no safe-mode.xml -->
-
-<!ENTITY sm.uidcheck 'Verifica se o(s) arquivo(s) e/ou diretório(s) que 
-serão afetados por esta operação tem o mesmo <literal>UID</literal> do script 
+<!ENTITY sm.uidcheck 'Verifica se o(s) arquivo(s) e/ou diretório(s) que
+serão afetados por esta operação tem o mesmo <literal>UID</literal> do script
 que está sendo executado.'>
 
-<!ENTITY sm.uidcheck.dir 'Verifica se o diretório que 
-será afetado por esta operação tem o mesmo <literal>UID</literal> do scritp 
+<!ENTITY sm.uidcheck.dir 'Verifica se o diretório que
+será afetado por esta operação tem o mesmo <literal>UID</literal> do scritp
 qu está sendo executado.'>
 
-<!ENTITY sm.disabled 'Esta função é desabilitada no <link 
+<!ENTITY sm.disabled 'Esta função é desabilitada no <link
 linkend="features.safe-mode">safe-mode</link>'>
 
 <!-- Peças comuns nas partintro-sections -->
-<!ENTITY no.config '<para>Esta extenção não define nenhum parametro de 
configuração.</para>'>
-<!ENTITY no.resource '<para>Esta extensão não define nenhum tipo de resource.</para>'>
+<!ENTITY no.config '<para>Esta extenção não define nenhum 
+parametro de configuração.</para>'>
+<!ENTITY no.resource '<para>Esta extensão não define nenhum tipo resource.</para>'>
 <!ENTITY no.constants '<para>Esta extensão não define nenhuma constante.</para>'>
-<!ENTITY no.requirement '<para>Estas funções estão diponíveis como parte de um 
módulo,que são sempre disponíveis.</para>'>
-<!ENTITY no.install '<para>Não há nenhuma instalação nescessária para utilizar estas 
funções, elas fazem parte do núcleo do PHP.</para>'>
+<!ENTITY no.requirement '<para>Estas funções são disponibilizadas  como parte de um
+módulo padrão, e estão sempre disponíveis.</para>'>
+<!ENTITY no.install '<para>Não há nenhuma instalação nescessária para utilizar estas 
+funções, elas fazem parte do núcleo do PHP.</para>'>
 
 <!-- Utilizadas em reference/$extname/constants.xml -->
 <!ENTITY extension.constants '<simpara>
 Estas contantes são definidas por esta extensão, e somente
-será disponível quando a extensão foi ou compilada no PHP
+estarão disponíveis quando a extensão foi ou compilada com o PHP
 ou carregada dinamicamente durante a execução.
 </simpara>'>
 
@@ -73,8 +101,8 @@
 <!ENTITY reftitle.intro     '<title>Introdução</title>'>
 <!ENTITY reftitle.required  '<title>Requisitos</title>'>
 <!ENTITY reftitle.install   '<title>Instalação</title>'>
-<!ENTITY reftitle.runtime   '<title>Configuração durante a Execução</title>'>
-<!ENTITY reftitle.resources '<title>Resource Types</title>'>
+<!ENTITY reftitle.runtime   '<title>Configuração durante execução</title>'>
+<!ENTITY reftitle.resources '<title>Tipos Resource</title>'>
 <!ENTITY reftitle.constants '<title>Constantes Predefinidas</title>'>
 <!ENTITY reftitle.examples  '<title>Exemplos</title>'>
 <!ENTITY reftitle.seealso   '<title>Veja Também</title>'>
Index: phpdoc/pt_BR/appendices/aliases.xml
diff -u phpdoc/pt_BR/appendices/aliases.xml:1.4 phpdoc/pt_BR/appendices/aliases.xml:1.5
--- phpdoc/pt_BR/appendices/aliases.xml:1.4     Sat Apr 27 13:21:23 2002
+++ phpdoc/pt_BR/appendices/aliases.xml Tue Apr 30 10:53:05 2002
@@ -1,12 +1,11 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- EN-Revision: 1.17 Maintainer: rarruda Status: ready -->
-<!-- $Revision: 1.4 $ -->
 <appendix id="aliases">
- <title>Lista de sinônimos (aliases)</title>
+ <title>Lista de funções sinônimas (aliases)</title>
  <para>
   Esta é a lista de funções sinônimas. Todas as funções sinônimas estão
   listadas aqui. Normalmente é uma má idéia utiliza-lás, pois elas
-  estão em vias de ser obsoletas ou ser renomeadas, o que criaria um
+  estão em vias de ficarem obsoletas ou serem renomeadas, o que criaria um
   script não portável. Esta lista é fornecida para ajudar aqueles que
   querem atualizar os seus scripts antigos para a nova sintaxe.
  </para>
@@ -20,7 +19,7 @@
  </para>
  <para>
   <table>
-   <title>Aliases</title>
+   <title>Sinônimos</title>
    <tgroup cols="3">
      <thead>
       <row>
Index: phpdoc/pt_BR/chapters/config.xml
diff -u phpdoc/pt_BR/chapters/config.xml:1.10 phpdoc/pt_BR/chapters/config.xml:1.11
--- phpdoc/pt_BR/chapters/config.xml:1.10       Sat Apr 27 01:20:17 2002
+++ phpdoc/pt_BR/chapters/config.xml    Tue Apr 30 10:53:05 2002
@@ -10,7 +10,7 @@
     O arquivo de configuração (chamado <filename>php3.ini</filename> no
     PHP 3.0, e simplesmente &php.ini; no PHP 4.0)
     é lido quando o PHP inicia. Para as versões de módulos de servidor do PHP,
-    isso só acontece uma vez quando o servidor é iniciado.  Para a versão
+    isso só acontece uma vez quando o servidor é iniciado. Para a versão
     <acronym>CGI</acronym> acontece em cada chamada.</simpara>
    <para>
     <example>
@@ -37,10 +37,10 @@
    </para>
 
    <simpara>
-    Usando o PHP como um módulo do apache, você também pode mudar
+    Usando o PHP como um módulo do Apache, você também pode mudar
     as definições de configuração usando diretivas na configuração dos arquivos
     Apache e dos arquivos .htaccess (Você irá precisar de privilégios
-    "AllowOverride Options" ou "AllowOverride All" privileges)</simpara>
+    "AllowOverride Options" ou "AllowOverride All")</simpara>
 
    <simpara>
     Com o PHP 3.0, existem diretivas Apache que correspondem a cada
@@ -136,17 +136,21 @@
        </term>
        <listitem>
         <para>
-         Esta opção habilita o URL-aware fopen wrappers que possibilitam o acesso a 
objetos URL
-         como arquivos. Wrappers padrão são fornecidos para o acesso de 
+         Esta opção habilita o URL-aware fopen wrappers que possibilitam 
+         o acesso a objetos URL
+         como arquivos. Wrappers padrão são fornecidos para o acesso de
          <link linkend="features.remote-files">arquivos remotos</link>
-         usando os protocolos ftp ou http, algumas extensões como zlib podem 
registrar wrappers adicionais. 
+         usando os protocolos FTP ou HTTP, algumas extensões como zlib podem 
+         registrar wrappers adicionais.
         </para>
 
         <note>
          <para>
-          Esta opção foi introduzida imediatamente após o lançamento da versão 4.0.3.
-          Para versões superiores incluindo a 4.0.3 você só pode desabilitar essa 
função na
-          compilação usando o argumento 
+          Esta opção foi introduzida imediatamente após o lançamento da versão 
+          4.0.3.
+          Para versões superiores incluindo a 4.0.3, você só pode desabilitar essa
+          função na
+          compilação usando o argumento
           <link 
linkend="install.configure.disable-url-fopen-wrapper"><parameter>--disable-url-fopen-wrapper</parameter></link>
 na configuração (configure).
          </para>
         </note>
@@ -163,7 +167,7 @@
         <simpara>
          Habilita o uso de tags no estilo ASP &lt;% %&gt; em adição às tags
          &lt;?php ?&gt; usuais. Isso inclui a impressão resumida
-         de valor de variável &lt;%= $valor %&gt;. Para maiores informações 
+         de valor de variável &lt;%= $valor %&gt;. Para maiores informações
          veja <link linkend="language.basic-syntax.phpmode">Saindo do HTML</link>.
         </simpara>
 
@@ -173,7 +177,7 @@
 
        </listitem>
       </varlistentry>
-      
+
       <varlistentry id="ini.auto-append-file">
        <term>
         <parameter>auto_append_file</parameter>
@@ -183,14 +187,15 @@
         <para>
          Especifica o nome do arquivo que é automaticamente interpretado
          após o arquivo principal. O arquivo é incluído como se tivesse sido
-         chamado com a função <function>include</function> , logo
+         chamado com a função <function>include</function>, logo
          <link linkend="ini.include-path">include_path</link> é usado.</para>
         <para>
-         O valor especial <systemitem class="constant">none</systemitem> desabilita o 
auto-appending.
+         O valor especial <systemitem class="constant">none</systemitem>
+         desabilita o auto-appending.
          <note>
           <simpara>
            Se o script é finalizado com <function>exit</function>,
-           auto-append <emphasis>não</emphasis> será lido.</simpara>
+           auto-append <emphasis>não</emphasis> ocorrerá.</simpara>
          </note></para>
        </listitem>
       </varlistentry>
@@ -204,10 +209,11 @@
         <para>
          Especifica o nome do arquivo que é automaticamente interpretado
          antes do arquivo principal. O arquivo é incluído como se tivesse sido
-         chamado com a função <function>include</function> , logo
+         chamado com a função <function>include</function>, logo
          <link linkend="ini.include-path">include_path</link> é usado.</para>
         <para>
-         O valor especial <systemitem class="constant">none</systemitem> desabilita o 
auto-prepending.</para>
+         O valor especial <systemitem class="constant">none</systemitem>
+         desabilita o auto-prepending.</para>
        </listitem>
       </varlistentry>
 
@@ -234,7 +240,7 @@
         </para>
        </listitem>
       </varlistentry>
-      
+
       <varlistentry id="ini.doc-root">
        <term>
         <parameter>doc_root</parameter>
@@ -243,8 +249,9 @@
        <listitem>
         <para>
          O "root directory" do PHP no servidor. Só é usado se não
-         estiver vazio.  Se o PHP é configurado com <link 
linkend="ini.safe-mode">safe mode</link>, nenhum
-         arquivo fora desse diretório é servido.
+         estiver vazio. Se o PHP é configurado com <link
+         linkend="ini.safe-mode">safe mode</link>, nenhum
+         arquivo acima desse diretório é acessível.
         </para>
        </listitem>
       </varlistentry>
@@ -257,16 +264,16 @@
        <listitem>
         <para>
          Essa diretiva só é realmente útil com a versão de módulo Apache
-         do PHP.  É usado por sites que queiram habilitar ou desabiliar
-         a interpretação PHP num servidor baseado por-diretório ou
-         por-virtual.  Colocando <userinput>engine
+         do PHP. É usado por sites que queiram habilitar ou desabiliar
+         a interpretação PHP num servidor por diretório ou
+         por domínio virtual. Colocando <userinput>engine
          off</userinput> nos devidos lugares no arquivo
-         <filename>httpd.conf</filename> , o PHP pode ser habilitado ou
+         <filename>httpd.conf</filename>, o PHP pode ser habilitado ou
          desabilitado.
         </para>
        </listitem>
       </varlistentry>
-      
+
       <varlistentry id="ini.error-log">
        <term>
         <parameter>error_log</parameter>
@@ -274,10 +281,10 @@
        </term>
        <listitem>
         <para>
-         Nome do arquivo onde erros de script devem ser guardados.  Se o
+         Nome do arquivo onde erros de script devem ser guardados. Se o
          valor especial <literal>syslog</literal> for usado, os erros serão
-         enviados para o logger do sistema.  No UNIX, isto significa
-         syslog(3) e no Windows NT isto significa event log.  O
+         enviados para o logger do sistema. No UNIX, isto significa
+         syslog(3) e no Windows NT isto significa o event log. O
          system logger não é suportado no Windows 95.</para>
        </listitem>
       </varlistentry>
@@ -289,8 +296,8 @@
        </term>
        <listitem>
         <para>
-         Define o nível de publicação de erros.  O parâmetro é um inteiro
-         representado um campo de bits.  Adicione os valores que você
+         Define o nível de publicação de erros. O parâmetro é um inteiro
+         representado um campo de bits. Adicione os valores que você
          queira do nível de publicação de erros.
          <table>
           <title>Níveis de Publicação de Erros</title>
@@ -338,7 +345,7 @@
         </para>
        </listitem>
       </varlistentry>
-      
+
       <varlistentry id="ini.open-basedir">
        <term>
         <parameter>open_basedir</parameter>
@@ -364,14 +371,14 @@
         <para>
          No Windows, separe os diretórios com ponto-e-vírgula. Em todos os outros
          sistemas, separe os diretórios com dois pontos. Como um módulo Apache,
-         os paths de open_basedir de dretórios parentes agora são
+         os caminhos de open_basedir de diretórios pais agora são
          automaticamente herdados.
         </para>
         <para>
-          A restrição especificada com open_basedir é na verdade um prefixo, e
+          A restrição imposta com open_basedir é na verdade um prefixo, e
           não um nome de diretório. Isso significa que "open_basedir =
           /dir/incl" também permite acesso a "/dir/include" e "/dir/incls"
-          se eles existem. Quando você deseja restringir o casso somente
+          se eles existem. Quando você deseja restringir o acesso somente
           ao diretório específico, o termine com uma barra. Por exemplo:
           "open_basedir = /dir/incl/"
         </para>
@@ -391,11 +398,11 @@
        </term>
        <listitem>
         <para>
-         Define a ordem de interpretação da variável GET/POST/COOKIE .  A
-         definição padrão para essa diretiva é "GPC".  Definindo-a para
+         Define a ordem de interpretação da variável GET/POST/COOKIE . A
+         definição padrão para essa diretiva é "GPC". Definindo-a para
          "GP", por exemplo, fará com que o PHP ignore completamente cookies
-         e irá sobescrever quaisquer variáveis com o método GET por variáveis com
-         o método POST com o mesmo nome.
+         e irá sobescrever quaisquer variáveis enviadas com o método GET por variáveis
+         do método POST com o mesmo nome.
         </para>
         <para>
          Note que esta opção não está disponível no PHP 4.
@@ -412,11 +419,11 @@
        </term>
        <listitem>
         <para>
-         Definir a ordem do parsing das variáveis EGPCS (Environment,
+         Define a ordem de prioridade das variáveis EGPCS (Environment,
          GET, POST, Cookie, Server). A definição padrão para essa
          diretiva é "EGPCS". Definindo como "GP", por exemplo,
-         faria que o PHP completamente ignorasse as variáveis de ambiente
-         (environment), cookies e server, e sobre escrever qualquer
+         fará com que o PHP ignore completamente as variáveis de ambiente
+         (environment) cookies e server, e sobrescrever qualquer
          variavel do metodo GET com variaveis do modo POST com o mesmo nome.
         </para>
         <para>
@@ -434,12 +441,12 @@
        <listitem>
         <para>
          Habilitado (On) por padrão. Se desabilitado (Off) os scripts irão ser 
finalizados
-         tão cedo quanto ele tentar imprimir algo após o cliente ter abortado a 
conexão.
-         <function>ignore_user_abort</function>.
+         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.include-path">
        <term>
         <parameter>include_path</parameter>
@@ -450,7 +457,7 @@
          Especifica uma lista de diretórios onde as funções
          <function>require</function>, <function>include</function>
          e <function>fopen_with_path</function> procuram por
-         arquivos.  O formato é como a variável de ambiente <envar>PATH</envar>
+         arquivos. O formato é o mesmo da variável de ambiente <envar>PATH</envar>
          do sistema: uma lista de diretórios separados por
          dois pontos no UNIX ou ponto-e-vírgula no Windows.
          <example>
@@ -493,7 +500,7 @@
        <listitem>
         <para>
          Diz se as mensagens de erro devem ser salvas no
-         arquivo de log do servidor. Logo, esta opção é específica do servidor.</para>
+         arquivo de log do servidor. Logo, esta opção é específica por 
+servidor.</para>
        </listitem>
       </varlistentry>
 
@@ -504,10 +511,10 @@
        </term>
        <listitem>
         <para>
-         Define o estado de magic_quotes para as operações 
-         GPC (Get/Post/Cookie).  Quando os magic_quotes estão habilitados (on),
-         todas ' (aspas simples), &quot; (aspas duplas), \ (barra invetida) e NUL's 
são
-         automaticamente escapadas com a barra invertida. Se magic_quotes_sybase is
+         Define o estado de magic_quotes para as operações
+         GPC (Get/Post/Cookie). Quando os magic_quotes estão habilitados (on),
+         todas ' (aspas simples), &quot; (aspas duplas), \ (barra invetida) e NULL's 
+são
+         automaticamente prefixadas (escaped) com a barra invertida. Se 
+magic_quotes_sybase
          também está habilitado (on), uma aspa simples é escapada como aspa simples
          ao invés da barra invertida.
         </para>
@@ -539,7 +546,7 @@
        <listitem>
         <para>
          Se <parameter>magic_quotes_sybase</parameter> também estiver habilitado (on),
-         aspa simples é escapada como aspa simples ao invés de barra invertida
+         aspas simples é escapada como aspa simples ao invés de barra invertida
          se <parameter>magic_quotes_gpc</parameter> ou
          <parameter>magic_quotes_runtime</parameter> estiverem habilitados.
         </para>
@@ -554,8 +561,9 @@
        <listitem>
         <para>
          Isto define a quantide máxima de tempo em segundos que um script é permitido
-         ter antes de ser finalizado pelo interpretador.  Isto previne
-         scripts mal escritos de travar o servidor. O valor padrão é 
<literal>30</literal>.
+         rodar antes de ser finalizado pelo interpretador. Isto previne
+         scripts mal escritos de travar o servidor. O 
+         valor padrão é <literal>30</literal>.
         </para>
         <para>
          O tempo máximo de execução não é afetado por qualquer system calls,
@@ -565,7 +573,7 @@
         </para>
        </listitem>
       </varlistentry>
-      
+
       <varlistentry id="ini.memory-limit">
        <term>
         <parameter>memory_limit</parameter>
@@ -579,7 +587,7 @@
         </para>
        </listitem>
       </varlistentry>
-      
+
       <varlistentry id="ini.nsapi-ext">
        <term>
         <parameter>nsapi_ext</parameter>
@@ -590,7 +598,7 @@
         </para>
        </listitem>
       </varlistentry>
-                
+
       <varlistentry id="ini.precision">
        <term>
         <parameter>precision</parameter>
@@ -606,7 +614,7 @@
       <varlistentry id="ini.register-argc-argv">
        <term>
         <parameter>register_argc_argv</parameter>
-        <type>boolean</type>
+        <type>booleano</type>
        </term>
        <listitem>
         <simpara>
@@ -614,8 +622,8 @@
          (que conteriam a informação do GET).
         </simpara>
         <simpara>
-          Veja também <link linkend="commandline">linha de comando</link>.
-          Também, esta diretiva se tornou disponível no PHP 4.0.0 e
+          Veja também <link linkend="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>
        </listitem>
@@ -628,16 +636,16 @@
        </term>
        <listitem>
         <simpara>
-         Sets max size of post data allowed. This setting also affects
-         file upload. To upload large files, this value must be larger
-         than <link linkend="upload-max-filesize">upload_max_filesize</link>.
+         Define o tamanho máximo dos dados informados via POST. Esse parâmetro afeta
+         o upload de arquivos. Para poder receber arquivos grandes, este valor 
+precisa ser maior
+         que o <link linkend="upload-max-filesize">upload_max_filesize</link>.
         </simpara>
         <simpara>
-         If memory limit is enabled by configure script, <link
-         linkend="ini.memory-limit">memory_limit</link> also affects
-         file uploading. Generally speaking, <link
-         linkend="ini.memory-limit">memory_limit</link> should be
-         larger than <link
+         Se o limite de memória foi informado no script de configuração,  <link
+         linkend="ini.memory-limit">memory_limit</link> afetará o
+         upload de arquivos. Ou seja, o <link
+         linkend="ini.memory-limit">memory_limit</link> também precisa
+         maior que <link
          linkend="ini.post-max-size">post_max_size</link>.
         </simpara>
        </listitem>
@@ -648,25 +656,29 @@
         <parameter>register_globals</parameter>
         <type>booleano</type>
        </term>
-       <listitem>                
+       <listitem>
         <para>
          Diz quando registrar as variáveis EGPCS (Environment, GET,
          POST, Cookie, Server) como globais ou não. Você pode
          desabilitar isso se você não quer misturar o escopo global do seu script
          com dados de usuário. Isto faz mais senso
          quando usado juntamente com <link
-         linkend="ini.track-vars">track_vars</link> - neste caso
+         linkend="ini.track-vars">track_vars</link>. Neste caso
          você pode acessar todas as variáveis EGPCS através das matrizes
-         <varname>$HTTP_ENV_VARS</varname>,
-         <varname>$HTTP_GET_VARS</varname>,
-         <varname>$HTTP_POST_VARS</varname>,
-         <varname>$HTTP_COOKIE_VARS</varname>, e
-         <varname>$HTTP_SERVER_VARS</varname>
+         <varname>$_ENV</varname>,
+         <varname>$_GET</varname>,
+         <varname>$_POST</varname>,
+         <varname>$_COOKIE</varname> e
+         <varname>$_SERVER</varname>
          no escopo global.
         </para>
-           </listitem>
+        <para>
+         Please note that you need to set AllowOveride All in your
+         Directory block in the apache config file for this to work.
+        </para>
+       </listitem>
       </varlistentry>
-                
+
       <varlistentry id="ini.short-open-tag">
        <term>
         <parameter>short_open_tag</parameter>
@@ -714,11 +726,11 @@
         <para>
          Se habilitado, então as variáveis Environment, GET, POST, Cookie,
          e Server poderão ser encontradas nas matrizes associativas globais
-         <varname>$HTTP_ENV_VARS</varname>,
-         <varname>$HTTP_GET_VARS</varname>,
-         <varname>$HTTP_POST_VARS</varname>,
-         <varname>$HTTP_COOKIE_VARS</varname>, e
-         <varname>$HTTP_SERVER_VARS</varname>.
+         <varname>$_ENV</varname>,
+         <varname>$_GET</varname>,
+         <varname>$_POST</varname>,
+         <varname>$_COOKIE</varname> e
+         <varname>$_SERVER</varname>.
         </para>
         <para>
          Note que no PHP 4.0.3, <systemitem
@@ -735,8 +747,22 @@
        <listitem>
         <para>
          O diretório temporário usado para armazenar arquivos
-         durante o upload de arquivos.  Deve ser gravável por qualquer usuário em
-         que o PHP esteja sendo rodado.</para>
+         durante o upload de arquivos. Deve ter permissão de escrita para qualquer 
+usuário em
+         que o PHP esteja sendo rodado.
+        </para>
+       </listitem>
+      </varlistentry>
+
+      <varlistentry id="ini.upload-max-filesize">
+       <term>
+        <parameter>upload_max_filesize</parameter>
+        <type>inteiro</type>
+       </term>
+       <listitem>
+        <para>
+         O tamanho máximo de um upload de arquivo. O valor é
+         expresso em bytes.
+        </para>
        </listitem>
       </varlistentry>
 
@@ -747,7 +773,7 @@
        </term>
        <listitem>
         <para>
-         O nome base do diretório usado no diretório home de um usuário
+         O caminho base do usado como diretório home do usuário
          para arquivos PHP, por exemplo
          <literal>public_html</literal>.</para>
        </listitem>
@@ -761,7 +787,7 @@
        <listitem>
         <para>
          Se habilitado, esta opção faz com que o PHP imprima um aviso quando o 
operador
-         mais (<literal>+</literal>) é usado em strings.
+         mais (<literal>+</literal>) é usado em variáveis string.
          Isto é para tornar mais fácil encontrar scripts que precisam ser reescritos
          para substituir pelo concatenador de strings
          (<literal>.</literal>).</para>
Index: phpdoc/pt_BR/chapters/intro.xml
diff -u phpdoc/pt_BR/chapters/intro.xml:1.6 phpdoc/pt_BR/chapters/intro.xml:1.7
--- phpdoc/pt_BR/chapters/intro.xml:1.6 Sat Apr 20 03:18:19 2002
+++ phpdoc/pt_BR/chapters/intro.xml     Tue Apr 30 10:53:05 2002
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.2 Maintainer: andre_ae Status: ready -->
-
+<!-- EN-Revision: 1.33 Maintainer: andre_ae Status: ready -->
  <chapter id="introduction">
   <title>Introdução</title>
 
@@ -8,10 +7,12 @@
    <title>O que é PHP?</title>
    <para>
     PHP (um acrônimo recursivo para "PHP: Hypertext Preprocessor")
-    é uma linguagem de script open-source do lado do servidor embutível em HTML.
+    é uma linguagem de script Open Source de uso geral, muito
+    utilizada e especialmente guarnecida para o desenvolvimento
+    de aplicações Web embútivel dentro do HTML.
    </para>
    <para>
-    Uma resposta simples, mas o que isso significa? Um exemplo:
+    Uma resposta simples, mas o que isso significa?
    </para>
    <para>
     <example>
@@ -25,7 +26,7 @@
     <body>
 
         <?php
-        echo "Olá, Eu sou um script PHP!"; 
+        echo "Olá, Eu sou um script PHP!";
         ?>
 
     </body>
@@ -48,9 +49,21 @@
     é que o código é executado no servidor. Se você tivesse um
     script similar ao acima em seu servidor, o cliente receberia
     os resultados da execução desse script, sem nenhum modo de determinar
-    qual é o código fonte. Você pode inclusive configurar seu servidor
+    como é o código fonte. Você pode inclusive configurar seu servidor
     para processar todos os seus arquivos HTML como PHP, e então não haverá
-    nenhum modo dos usuários descobrirem que você usa essa linguagem.
+    nenhum modo dos usuários descobrirem que se você usa essa linguagem ou não.
+   </para>
+   <para>
+    A melhor coisa em usar PHP está no fato de ele ser extremamente simples
+    para um iniciante, mas oferece muitos recursos para
+    o programador profissional. Não se preocupe em ler as longas
+    listas de funções do PHP. Você pode pular essa parte (por enquanto) e
+    começar a escrever scripts em poucas horas.
+   </para>
+   <para>
+    Apesar do desenvolvimento do PHP ser focado nos scripts do lado do servidor, 
+    você pode fazer muito mais com ele. Veja isso e leia mais na seção
+    <link linkend="intro-whatcando">O que o PHP pode fazer?</link>.
    </para>
   </sect1>
 
@@ -59,7 +72,7 @@
    <para>
     Qualquer coisa. O PHP é focado para ser uma linguagem de script do lado do 
servidor,
     portanto, você pode fazer qualquer coisa que outro programa CGI pode fazer, como:
-    coletar dados de formulários, gerar conteúdo dinâmico de páginas ou
+    coletar dados de formulários, gerar páginas com conteúdo dinâmico ou
     enviar e receber cookies. Mas o PHP pode fazer muito mais.
    </para>
    <para>
@@ -70,8 +83,8 @@
        Script no lado do servidor (server-side). Este é o mais tradicional
        e principal campo de atuação do PHP. Você precisa de três coisas
        para seu trabalho. O interpretador do PHP (como CGI ou módulo),
-       um servidor web e um browser. Basta rodar o servidor web
-       conectado a um PHP instalado.
+       um servidor web e um browser. Basta 
+       rodar o servidor web onectado a um PHP instalado.
        Você pode acessar os resultados de seu programa PHP com um browser,
        visualizando a página PHP através do servidor web. Veja as
        <link linkend="installation">instruções de instalação</link>
@@ -84,8 +97,9 @@
        funcionar sem um servidor web ou browser.
        A única coisa necessária é o interpretador.
        Esse tipo de uso é ideal para script executados
-       usando o <literal>cron</literal> (ou o Agendador de Tarefas no Windows),
-       ou rotinas de processamento de texto. Veja a seção
+       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
        linha de comando</link> para maiores informações.
       </simpara>
@@ -111,23 +125,22 @@
     O PHP pode ser utilizado na maioria dos sistemas operacionais, incluindo
     Linux, várias variantes Unix (incluindo HP-UX, Solaris e OpenBSD),
     Microsoft Windows, Mac OS X, RISC OS, e provavelmente outros.
-    O PHP também é suportado pela maioria dos servidores web atuais, incluindo
-    Apache, Microsoft Internet Information Server,
+    O PHP também é suportado pela maioria dos servidores web atuais, 
+    incluindo Apache, Microsoft Internet Information Server,
     Personal Web Server, Netscape and iPlanet Servers, Oreilly
     Website Pro Server, Caudium, Xitami, OmniHTTPd, e muitos
-    outros. O PHP pode ser configurado como um módulo para a maioria dos servidores,
-    e para os outros como um CGI padrão.<!--(repetitivo) PHP can work
+    outros. O PHP pode ser configurado como módulo para a maioria dos servidores,
+    e para os outros como um CGI comum.<!--(repetitivo) PHP can work
     as a CGI processor.-->
    </para>
    <para>
-    Com o PHP, portanto, você tem livre arbítrio para escolher o sistema
+    Com o PHP, portanto, você tem a liberdade para escolher o sistema
     operacional e o servidor web. Do mesmo modo, você pode escolher entre
     utilizar programação estrutural ou programação orientada a objeto,
-    ou uma mistura deles. Mesmo não
+    ou ainda uma mistura deles. Mesmo não
     desenvolvendo nenhum recurso padrão de OOP (Object Oriented Programming, 
Programação Orientada a Objetos) na versão atual
     do PHP, muitas bibliotecas de código e grandes aplicações (incluindo a
-    <link linkend="pear">biblioteca PEAR</link>) foram escritos somente
-    utilizando OOP.
+    biblioteca PEAR) foram escritos somente utilizando OOP.
    </para>
    <para>
     Com PHP você não está limitado a gerar somente HTML. As habilidades
@@ -193,7 +206,7 @@
     XSLT para transformar documentos XML.
    </para>
    <para>
-    Utilizando o PHP no campo comercial, você poderá as
+    Utilizando o PHP no campo do e-commerce, você poderá usar as
     funções específicas para Cybescash, CyberMUT, Verysign Payflow
     Pro e CCVS, práticos sistemas de pagamento
     online.
@@ -208,68 +221,12 @@
     Como você pode ver, esta página não é suficiente para descrever todos
     os recursos e benefícios que o PHP pode oferecer. Leia nas
     seções sobre a <link linkend="installation">Instalação do
-    PHP</link>, e veja a <link linkend="funcref">lista de
+    PHP</link>, e veja a <link linkend="funcref">referência das
     funções</link> para detalhes das extensões
     mencionadas aqui.
    </para>
   </sect1>
 
-  <sect1 id="intro-history">
-   <title>Uma breve história do PHP</title>
-   <simpara>
-    O PHP foi concebido em por volta de 1994 por &link.rasmus;.
-    Versões iniciais não lançadas foram usadas em sua home page para 
-    rastrear quem estava olhando o seu currículo virtual. A primeira versão
-    utilizada por terceiros ficou disponível em 1995 e era conhecida como
-    Personal Home Page Tools. Consistia de um interpretador
-    muito simples que apenas entendia algumas macros especiais
-    e um conjunto de utilitários comuns em home pages
-    daquela época. Um guestbook (livro de visitantes), um contador, e algumas outras 
coisas. O
-    interpretador foi rescrito em meados de 1995 e batizado PHP/FI versão 2. O
-    FI era de outro pacote que Rasmus tinha escrito e interpretava
-    dados de formulários HTML. Ele combinou os scripts do Personal Home Page Tools
-    com o Form Interpreter e adicionou suporte ao mSQL e assim nasceu o
-    PHP/FI. O PHP/FI cresceu a um ritmo fantástico e pessoas começaram
-    a contribuir para seu código.
-   </simpara>
-   <simpara>
-    É difícil precisar qualquer estatística, mas estima-se
-    que ao final de 1996 o PHP/FI estava em uso em pelo menos 15,000 web sites
-    ao redor do mundo. Em meados de 1997 este número tinha crescido para mais de
-    50,000. Na metade de 1997 houve uma mudança no desenvolvimento do PHP. Ele deixou
-    de ser o projeto pessoal de Rasmus ao qual muitas pessoas tinham
-    contribuído, para se tornar o foco de um time mais
-    organizado. O interpretador foi rescrito do zero por Zeev Suraski e
-    Andi Gutmans e este novo interpretador formou a base do PHP versão
-    3. Muito do código dos utilitários do PHP/FI foi portado para o PHP 3
-    e muito mais dele foi completamente rescrito.
-   </simpara>
-   <simpara>
-    A última versão (PHP 4) usa engine de scripting da <ulink
-    url="&url.zend;">Zend</ulink> para possibilitar alta
-    performance, suportar uma ampla variedade de bibliotecas externas
-    e extensões, e ainda rodar como um módulo nativo com todos os
-    servidores web populares.
-   </simpara>
-   <simpara>
-    Hoje (1/2001), o PHP 3 ou 4 pode ser encontrado em numerosos
-    produtos comerciais como o servidor web Stronghold da Red Hat.
-    Uma estimativa conservadora baseada na extrapolação de
-    números fornecidos pela <ulink url="&url.netcraft;">Netcraft</ulink>
-    (veja também <ulink url="&url.netcraft-survey;">Netcraft Web Server
-    Survey</ulink>) diria que o PHP está em uso em mais de 5.100.000
-    sites ao redor do mundo. Para colocar isso em perspectiva, este número é
-    sensivelmente maior do que o número de sites que rodam o servidor IIS da 
Microsoft na Internet
-    (5,03 milhões).
-   </simpara>
-<!--
-   <figure>
-    <title>NetCraft Webserver Survey</title>
-    <graphic fileref="&url.php.stats;"/>
-   </figure>
--->
-  </sect1>
-
  </chapter>
 
 <!-- Keep this comment at the end of the file
@@ -288,4 +245,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
 -->


Reply via email to