Apêndice K . Sobre o manual

Índice
Formatos
Sobre as notas de usuários
Como ler a definição de função (protótipo)
Como encontrar mais informações sobre o PHP
Como ajudar a melhorar a documentação
Como nós geramos os formatos
Traduções

Formatos

O manual do PHP é fornecido em vários formatos . Esses formatos podem ser divididos em dois grupos : de leitura online e em pacotes para download .

Nota : Algumas editoras tornaram disponíveis versões impressas desse manual . Nós não podemos recomendar nenhum deles , pois eles se tornam desatualizados rapidamente .

Você pode ler o manual online em http : / /www.php.net / Você pode ler o manual online em http : / /www.php.net / e em numerosos mirrors . Para melhor performance , escolha o mirror localizado mais fisicamente próximo a você . Você pode visualizar o manual no formato HTML simples ou em um formato HTML que se assemelha ao próprio look and feel do site do PHP

A vantagem do manual online para a maioria dos formatos offline é a sua integração com os comentários dos usuários . A desvantagem óbvia é que você precisa estar online para ler o manual .

Existem vários formatos offline do manual , e o formato mais apropriado para você depende do seu sistema operacional de seu estilo pessoal de leitura . Para informações de como esse manual é gerado e quais são esses formatos , veja a seção ' Como nós criamos os formatos ' deste apêndice .

As versões mais independentes de plataforma são o HTML e o texto simples . O formato HTML é fornecido em um único arquivo e também como um pacote de arquivos individuais para cada seção ( o que resulta numa coleção de vários milhares de arquivos ) . Os formatos HTML e texto simples são condensados com o tar e comprimidos usando o bzip2 .

Outro formato popular independente de plataforma , e que ainda fornece suporte a impressão , é o PDF ( também conhecido como Adobe Acrobat ) . Mas antes de você baixar o manual neste formato e apertar o botão Imprimir , esteja avisado que o ele tem por volta de 2000 páginas , e está sendo constantemente revisado .

Nota : Se você ainda não tem um programa capaz de visualizar arquivos PDF , você precisará baixar o Adobe Acrobat Reader .

Para proprietários de handhelds compatíveis com o Palm , os formatos DOC e iSilo são ideias para esta plataforma . Você pode ter no seu handheld de seu uso diário um visualizador DOC ou iSilo para aumentar seu conhecimento em PHP , ou apenas como referência rápida .

Para a plataforma Windows , a versão HTML Help do manual condensa os originais no formato HTML para o uso com o HTML Help . Esse formato tem busca de textos , índice completo e marcadores . Vários ambientes de desenvolvimento populares do PHP em Windows se integram com esse formato da documentação para facilitar o acesso a documentação .