Apêndice Q. 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 no site do PHP 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

Duas vantagens notáveis do manual on-line sobre seus formatos offline são a integração das notas dos usuários e os atalhos de URL, que você pode usar para alcançar partes do manual rapidamente. Uma desvantagem óbvia é que você precisa estar on-line para ver esta edição do 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.

A versão mais compatível do manual entre as plataformas é a HTML. Este é fornecido em um único arquivo HTML e como um pacote de arquivos individuais, um para cada seção (o que resulta numa coleção de milhares de arquivos). Esses pacotes são compactados, de forma que você precisa de algum utilitário para descomprimir os arquivos contidos nesses pacotes.

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 mais 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 Windows HTML Help do manual condensa os originais no formato HTML para o uso com o Windows HTML Help. Esse formato tem busca de textos, índice completo e marcadores. Vários ambientes de desenvolvimento populares do PHP no Windows se integram com esse formato da documentação para facilitar o acesso a documentação. Visualizadores de CHM para Linux também estão disponíveis. Veja xCHM or GnoCHM.

Existe também uma versão CHM extendida, atualizada menos freqüentemente, mas que provê muito mais recursos. Ela somente está disponível no Microsoft Windows, por causa das tecnologias utilizadas para compilar essas páginas.