Apêndice N. Sobre o manual

Índice
Formatos
Sobre as notas de usuários
Como ler a definição de função (protótipo)
Versões do PHP documentadas neste manual
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/ 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.