{"id":5901,"date":"2022-12-20T18:57:42","date_gmt":"2022-12-20T21:57:42","guid":{"rendered":"http:\/\/lode.uno\/linux-man\/index.php\/2022\/12\/20\/lexgrog-pt\/"},"modified":"2022-12-20T18:57:42","modified_gmt":"2022-12-20T21:57:42","slug":"lexgrog-pt","status":"publish","type":"post","link":"https:\/\/lode.uno\/linux-man\/2022\/12\/20\/lexgrog-pt\/","title":{"rendered":"LEXGROG (pt)"},"content":{"rendered":"

LEXGROG<\/h1>\n

NOME<\/a>
SINOPSE<\/a>
DESCRI\u00c3\u00c3O<\/a>
OP\u00c3\u00c3ES<\/a>
ESTADO DE SA\u00c3DA<\/a>
EXEMPLOS<\/a>
AN\u00c3LISE WHATIS<\/a>
VEJA TAMB\u00c3M<\/a>
NOTAS<\/a>
AUTOR<\/a>
ERROS<\/a> <\/p>\n

\n

NOME <\/a> <\/h2>\n

lexgrog \u2212 analisar informa\u00c3\u00a7\u00c3\u00a3o de cabe\u00c3\u00a7alho em p\u00c3\u00a1ginas do manual<\/p>\n

SINOPSE <\/a> <\/h2>\n

lexgrog<\/b> [\u2212m<\/b>|\u2212c<\/b>] [\u2212dfw?V<\/b>] [\u2212E<\/b> codifica\u00c3\u00a7\u00c3\u00a3o<\/i>] ficheiro<\/i> …<\/p>\n

DESCRI\u00c3\u00c3O <\/a> <\/h2>\n

lexgrog<\/b> \u00c3\u00a9 uma implementa\u00c3\u00a7\u00c3\u00a3o do utilit\u00c3\u00a1rio tradicional \u201cgroff guess\u201d) em lex<\/b>. Ele l\u00c3\u00aa a lista de ficheiros na linha de comandos como ficheiros fonte de p\u00c3\u00a1ginas do manual ou p\u00c3\u00a1ginas pr\u00c3\u00a9\u2212formatadas \u201ccat\u201d e mostra o seu nome e descri\u00c3\u00a7\u00c3\u00a3o conforme utilizados por apropos<\/b> e whatis<\/b>, a lista de filtros de pr\u00c3\u00a9\u2212processamento exigidos pela p\u00c3\u00a1gina do manual antes de ser passada para noff<\/b> ou troff<\/b>, ou ambos.<\/p>\n

Se a entrada estiver mal formatada, lexgrog<\/b> imprime \u201ca an\u00c3\u00a1lise falhou\u201d; isto pode ser \u00c3\u00batil para programas externos que precisam verificar as p\u00c3\u00a1ginas do manual para correc\u00c3\u00a7\u00c3\u00a3o. Se um dos ficheiros de entrada do lexgrog<\/b> for \u201c\u2212\u201d, ler\u00c3\u00a1 da entrada padr\u00c3\u00a3o; se algum ficheiro de entrada for comprimido, ser\u00c3\u00a1 lida automaticamente uma vers\u00c3\u00a3o descomprimida).<\/p>\n

OP\u00c3\u00c3ES <\/a> <\/h2>\n

\u2212d<\/b>, \u2212\u2212debug<\/b><\/p>\n

imprime informa\u00c3\u00a7\u00c3\u00a3o de depura\u00c3\u00a7\u00c3\u00a3o.<\/p>\n

\u2212m<\/b>, \u2212\u2212man<\/b><\/p>\n

Analisar entrada como ficheiros fonte de p\u00c3\u00a1ginas do manual. \u00c3 a predefini\u00c3\u00a7\u00c3\u00a3o se nem \u2212\u2212man<\/b> nem \u2212\u2212cat<\/b> forem indicados.<\/p>\n

\u2212c<\/b>, \u2212\u2212cat<\/b><\/p>\n

Analisar entrada como p\u00c3\u00a1ginas do manual pr\u00c3\u00a9\u2212formatadas (\u201cp\u00c3\u00a1ginas cat\u201d). \u2212\u2212man<\/b> e \u2212\u2212cat<\/b> n\u00c3\u00a3o podem ser indicados em simult\u00c3\u00a2neo.<\/p>\n

\u2212w<\/b>, \u2212\u2212whatis<\/b><\/p>\n

Mostra o nome e descri\u00c3\u00a7\u00c3\u00a3o do cabe\u00c3\u00a7alho da p\u00c3\u00a1gina do manual, como usado por apropos<\/b> e whatis<\/b>. \u00c3 a predefini\u00c3\u00a7\u00c3\u00a3o se nem \u2212\u2212whatis<\/b> nem \u2212\u2212filters<\/b> forem indicados.<\/p>\n

\u2212f<\/b>, \u2212\u2212filters<\/b><\/p>\n

Mostra a lista de filtros necess\u00c3\u00a1rios ao pr\u00c3\u00a9\u2212processamento da p\u00c3\u00a1gina do manual antes de a formatar com nroff<\/b> ou troff<\/b>.<\/p>\n

\u2212E<\/b> codifica\u00c3\u00a7\u00c3\u00a3o<\/i>, \u2212\u2212encoding<\/b> codifica\u00c3\u00a7\u00c3\u00a3o<\/i><\/p>\n

Sobrepor o conjunto de caracteres adivinhado para a p\u00c3\u00a1gina com codifica\u00c3\u00a7\u00c3\u00a3o<\/i>.<\/p>\n

\u2212?<\/b>, \u2212\u2212help<\/b><\/p>\n

mostra uma mensagem de ajuda e sai.<\/p>\n

\u2212\u2212usage<\/b><\/p>\n

mostra uma mensagem curta de uso e sai.<\/p>\n

\u2212V<\/b>, \u2212\u2212version<\/b><\/p>\n

mostra informa\u00c3\u00a7\u00c3\u00a3o da vers\u00c3\u00a3o.<\/p>\n

ESTADO DE SA\u00c3DA <\/a> <\/h2>\n\n\n\n\n
<\/td>\n\n

0<\/b><\/p>\n<\/td>\n

<\/td>\n\n

Execu\u00c3\u00a7\u00c3\u00a3o de programa com sucesso.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

1<\/b><\/p>\n<\/td>\n

<\/td>\n\n

Erro de utiliza\u00c3\u00a7\u00c3\u00a3o.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

2<\/b><\/p>\n<\/td>\n

<\/td>\n\n

lexgrog<\/b> falhou ao analisar um ou mais dos seus ficheiros de entrada..<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

EXEMPLOS <\/a> <\/h2>\n

$ lexgrog man.1
man.1: “man \u2212 um ambiente para os manuais de refer\u00c3\u00aancia do sistema”
$ lexgrog \u2212fw man.1
man.1 (t): “man \u2212 um ambiente para os manuais de refer\u00c3\u00aancia do sistema”
$ lexgrog \u2212c whatis.cat1
whatis.cat1: “whatis \u2212 mostra as descri\u00c3\u00a7\u00c3\u00b5es das p\u00c3\u00a1ginas do manual”
$ lexgrog broken.1
broken.1: an\u00c3\u00a1lise falhou<\/p>\n

AN\u00c3LISE WHATIS <\/a> <\/h2>\n

mandb<\/b> (que usa o mesmo c\u00c3\u00b3digo que lexgrog<\/b>) analisa a sec\u00c3\u00a7\u00c3\u00a3o NOME<\/b> ao cimo de cada p\u00c3\u00a1gina do manual, procurando nomes e descri\u00c3\u00a7\u00c3\u00b5es das funcionalidades documentadas em cada uma delas. Embora o analisador seja muito tolerante, dado que tem de lidar com um n\u00c3\u00bamero de diferentes formas que foram antes utilizadas, pode, \u00c3\u00a0s vezes, falhar a extrac\u00c3\u00a7\u00c3\u00a3o da informa\u00c3\u00a7\u00c3\u00a3o necess\u00c3\u00a1ria.<\/p>\n

Ao utilizar o conjunto de macros tradicional man<\/i>, uma sec\u00c3\u00a7\u00c3\u00a3o NOME<\/b> correcta parece\u2212se com isto:<\/p>\n

.SH NOME
foo \u2212 programa para fazer algo<\/p>\n

Algumas p\u00c3\u00a1ginas do manual requerem que \u2018\u2212\u2019 seja exactamente como mostrado; mandb<\/b> \u00c3\u00a9 mais tolerante, mas para compatibilidade com outros sistemas, \u00c3\u00a9 sempre boa ideia reter a barra invertida.<\/p>\n

No lado esquerdo, pode haver v\u00c3\u00a1rios nomes, separados por v\u00c3rgulas. Nomes com espa\u00c3\u00a7os ser\u00c3\u00a3o ignorados, para evitar comportamentos patol\u00c3\u00b3gicos em certas sec\u00c3\u00a7\u00c3\u00b5es NOME<\/b> mal formadas. O texto no lado direito \u00c3\u00a9 livre, e pode ser dividido em v\u00c3\u00a1rias linhas. Se est\u00c3\u00a3o a ser documentadas v\u00c3\u00a1rias funcionalidades com diferentes descri\u00c3\u00a7\u00c3\u00b5es na mesma p\u00c3\u00a1gina do manual, \u00c3\u00a9 usado o seguinte formul\u00c3\u00a1rio:<\/p>\n

.SH NOME
foo, bar \u2212 programas para fazer algo
.br
baz \u2212 programa para n\u00c3\u00a3o fazer nada<\/p>\n

(pode usar uma macro que inicia um novo par\u00c3\u00a1grafo, como .PP, em vez da macro de quebra .br)<\/p>\n

Ao utilizar o conjunto de macros mdoc<\/i> derivado de BSD, a sec\u00c3\u00a7\u00c3\u00a3o NOME<\/b> correcta parece\u2212se com algo como isto:<\/p>\n

.Sh NOME
.Nm foo
.Nd programa para fazer algo<\/p>\n

H\u00c3\u00a1 v\u00c3\u00a1rias raz\u00c3\u00b5es para a falha da an\u00c3\u00a1lise do whatis. Por vezes, os autores das p\u00c3\u00a1ginas do manual substituem \u2018.SH NOME\u2019 por \u2018.SH MEUPROGRAMA\u2019, o que leva a que mandb<\/b> n\u00c3\u00a3o consiga encontra a sec\u00c3\u00a7\u00c3\u00a3o de onde extrair a informa\u00c3\u00a7\u00c3\u00a3o necess\u00c3\u00a1ria. Outras vezes, incluem uma sec\u00c3\u00a7\u00c3\u00a3o NOME mas colocam aqui texto livre, em vez de \u2018nome \u2212 descri\u00c3\u00a7\u00c3\u00a3o\u2019. Contudo, qualquer sintaxe parecida com o acima dever\u00c3\u00a1 ser aceite.<\/p>\n

VEJA TAMB\u00c3M <\/a> <\/h2>\n

apropos<\/i>(1), man<\/i>(1), whatis<\/i>(1), mandb<\/i>(8)<\/p>\n

NOTAS <\/a> <\/h2>\n

lexgrog<\/b> tenta analisar ficheiros contendo pedidos .so, mas s\u00c3\u00b3 o poder\u00c3\u00a1 correctamente fazer se os ficheiros estiverem devidamente instalados numa hierarquia de p\u00c3\u00a1ginas do manual.<\/p>\n

AUTOR <\/a> <\/h2>\n

O c\u00c3\u00b3digo usado por lexgrog<\/b> para analisar quem escreveu as p\u00c3\u00a1ginas do manual:<\/p>\n

Wilf. (G.Wilford@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).
Colin Watson (cjwatson@debian.org).<\/p>\n

Colin Watson escreveu a encarna\u00c3\u00a7\u00c3\u00a3o actual da linha de comandos, assim como esta p\u00c3\u00a1gina do manual.<\/p>\n

ERROS <\/a> <\/h2>\n

https:\/\/savannah.nongnu.org\/bugs\/?group=man-db<\/p>\n

\n","protected":false},"excerpt":{"rendered":"

LEXGROG NOME SINOPSE DESCRI\u00c3\u00c3O OP\u00c3\u00c3ES ESTADO DE SA\u00c3DA EXEMPLOS AN\u00c3LISE WHATIS VEJA TAMB\u00c3M NOTAS AUTOR ERROS NOME lexgrog \u2212 analisar informa\u00c3\u00a7\u00c3\u00a3o de cabe\u00c3\u00a7alho em p\u00c3\u00a1ginas do manual SINOPSE lexgrog [\u2212m|\u2212c] [\u2212dfw?V] [\u2212E codifica\u00c3\u00a7\u00c3\u00a3o] ficheiro … DESCRI\u00c3\u00c3O lexgrog \u00c3\u00a9 uma implementa\u00c3\u00a7\u00c3\u00a3o do utilit\u00c3\u00a1rio tradicional \u201cgroff guess\u201d) em lex. Ele l\u00c3\u00aa a lista de ficheiros na linha […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[962],"tags":[964,968,2594],"class_list":["post-5901","post","type-post","status-publish","format-standard","hentry","category-1-comandos-generales","tag-964","tag-lexgrog","tag-pt"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/5901","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=5901"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/5901\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=5901"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=5901"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=5901"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}