LEXGROG(1) Utilidades do paginador do manual LEXGROG(1) NOME lexgrog - analisar informacao de cabecalho em paginas do manual SINOPSE lexgrog [-m|-c] [-dfw?V] [-E codificacao] ficheiro ... DESCRICAO lexgrog e uma implementacao do utilitario tradicional "groff guess") em lex. Ele le a lista de ficheiros na linha de comandos como ficheiros fonte de paginas do manual ou paginas pre-formatadas "cat" e mostra o seu nome e descricao conforme utilizados por apropos e whatis, a lista de filtros de pre-processamento exigidos pela pagina do manual antes de ser passada para noff ou troff, ou ambos. Se a entrada estiver mal formatada, lexgrog imprime "a analise falhou"; isto pode ser util para programas externos que precisam verificar as paginas do manual para correccao. Se um dos ficheiros de entrada do lexgrog for "-", lera da entrada padrao; se algum ficheiro de entrada for comprimido, sera lida automaticamente uma versao descomprimida). OPCOES -d, --debug imprime informacao de depuracao. -m, --man Analisar entrada como ficheiros fonte de paginas do manual. E a predefinicao se nem --man nem --cat forem indicados. -c, --cat Analisar entrada como paginas do manual pre-formatadas ("paginas cat"). --man e --cat nao podem ser indicados em simultaneo. -w, --whatis Mostra o nome e descricao do cabecalho da pagina do manual, como usado por apropos e whatis. E a predefinicao se nem --whatis nem --filters forem indicados. -f, --filters Mostra a lista de filtros necessarios ao pre-processamento da pagina do manual antes de a formatar com nroff ou troff. -E codificacao, --encoding codificacao Sobrepor o conjunto de caracteres adivinhado para a pagina com codificacao. -?, --help mostra uma mensagem de ajuda e sai. --usage mostra uma mensagem curta de uso e sai. -V, --version mostra informacao da versao. ESTADO DE SAIDA 0 Execucao de programa com sucesso. 1 Erro de utilizacao. 2 lexgrog falhou ao analisar um ou mais dos seus ficheiros de entrada.. EXEMPLOS $ lexgrog man.1 man.1: "man - um ambiente para os manuais de referencia do sistema" $ lexgrog -fw man.1 man.1 (t): "man - um ambiente para os manuais de referencia do sistema" $ lexgrog -c whatis.cat1 whatis.cat1: "whatis - mostra as descricoes das paginas do manual" $ lexgrog broken.1 broken.1: analise falhou ANALISE WHATIS mandb (que usa o mesmo codigo que lexgrog) analisa a seccao NOME ao cimo de cada pagina do manual, procurando nomes e descricoes das funcionalidades documentadas em cada uma delas. Embora o analisador seja muito tolerante, dado que tem de lidar com um numero de diferentes formas que foram antes utilizadas, pode, as vezes, falhar a extraccao da informacao necessaria. Ao utilizar o conjunto de macros tradicional man, uma seccao NOME correcta parece-se com isto: .SH NAME foo \- program to do something Algumas paginas do manual requerem que `\-' seja exactamente como mostrado; mandb e mais tolerante, mas para compatibilidade com outros sistemas, e sempre boa ideia reter a barra invertida. No lado esquerdo, pode haver varios nomes, separados por virgulas. Nomes com espacos serao ignorados, para evitar comportamentos patologicos em certas seccoes NOME mal formadas. O texto no lado direito e livre, e pode ser dividido em varias linhas. Se estao a ser documentadas varias funcionalidades com diferentes descricoes na mesma pagina do manual, e usado o seguinte formulario: .SH NAME foo, bar \- programs to do something .br baz \- program to do nothing (A macro which starts a new paragraph, like .PP, may be used instead of the break macro .br.) Ao utilizar o conjunto de macros mdoc derivado de BSD, a seccao NOME correcta parece-se com algo como isto: .Sh NAME .Nm foo .Nd program to do something Ha varias razoes para a falha da analise do whatis. Por vezes, os autores das paginas do manual substituem `.SH NOME' por `.SH MEUPROGRAMA', o que leva a que mandb nao consiga encontra a seccao de onde extrair a informacao necessaria. Outras vezes, incluem uma seccao NOME mas colocam aqui texto livre, em vez de `nome \- descricao'. Contudo, qualquer sintaxe parecida com o acima devera ser aceite. VEJA TAMBEM apropos(1), man(1), whatis(1), mandb(8) NOTAS lexgrog tenta analisar ficheiros contendo pedidos .so, mas so o podera correctamente fazer se os ficheiros estiverem devidamente instalados numa hierarquia de paginas do manual. AUTOR O codigo usado por lexgrog para analisar quem escreveu as paginas do manual: Wilf. (G.Wilford@ee.surrey.ac.uk). Fabrizio Polacco (fpolacco@debian.org). Colin Watson (cjwatson@debian.org). Colin Watson escreveu a encarnacao actual da linha de comandos, assim como esta pagina do manual. ERROS https://gitlab.com/man-db/man-db/-/issues https://savannah.nongnu.org/bugs/?group=man-db 2.12.1 2024-04-05 LEXGROG(1)