J.5. Edição da documentação #

J.5.1. Emacs

Os arquivos-fonte da documentação são mais convenientemente modificados usando um editor que possui um modo para edição de XML, e ainda mais se tiver algum conhecimento das linguagens de marcação XML, para poder conhecer a sintaxe do DocBook.

Note que, por razões históricas, os arquivos-fonte da documentação têm nomes com a extensão .sgml, embora agora sejam arquivos XML. Portanto, pode ser necessário ajustar a configuração do editor para definir o modo correto. [195]

J.5.1. Emacs #

O Modo nXML, que acompanha o Emacs, é a maneira mais comum de editar documentos XML usando o Emacs, permitindo usar o Emacs para inserir tags e verificar sua consistência, com suporte ao DocBook pronto para uso. Veja a página nXML Mode para acessar a documentação.

O arquivo src/tools/editors/emacs.samples contém configurações recomendadas para este modo.



[195] O editor de texto Geany funciona perfeitamente bem para editar os arquivos-fonte da documentação do PostgreSQL, apenas configurando para usar espaços na indentação em vez de tabulação. O recurso de snippets pode ser configurado para completar texto usando a tecla de tabulação, ajudando muito a digitação. (N. T.)