Comando Linux vgrind
Em sistemas operacionais do tipo Unix, o comando vgrind “mói” as listagens de programas, criando um formato de saída mais atraente.
Descrição
O utilitário vgrind formata as fontes do programa nomeadas pelos argumentos do nome do arquivo em um estilo agradável usando troff . Os comentários são colocados em itálico, as palavras-chave em negrito e, conforme cada função é encontrada, seu nome é listado na margem da página.
O vgrind é executado em dois modos básicos, modo de filtro ou modo regular. No modo de filtro, vgrind atua como um filtro de maneira semelhante ao tbl . A entrada padrão é passada diretamente para a saída padrão, exceto pelas linhas entre colchetes pelas macros do tipo troff :
| .vS | inicia o processamento |
| .vE | termina o processamento |
Essas linhas são formatadas como descrito acima. A saída desse filtro pode ser passada para o troff para saída. Não é necessário fazer pedidos específicos com eqn ou tbl . No modo regular, vgrind aceita nomes de arquivos de entrada, os processa e os passa para troff para saída. Use um hífen (‘ – ‘) para especificar a entrada padrão ; caso contrário, o vgrind sairá sem tentar ler a entrada padrão. Os nomes dos arquivos devem ser especificados após todos os outros argumentos de opção .
No modo regular, se a opção -t ou -P for especificada, a saída será:
- emitida (no formato troff ) para stdout se a opção -t for especificada.
- impresso (como PostScript ) para a impressora nomeada se a opção -P for especificada.
Caso contrário, a saída é:
- impresso (como PostScript) na impressora padrão do sistema, se houver uma definida, e o stdout do comando for um tty .
- emitido (como PostScript) para stdout se não for um tty (ou seja, se stdout for um canal ou um redirecionamento para um arquivo).
Nos dois modos, vgrind passa todas as linhas que começam com um ponto decimal sem conversão.
Sintaxe
vgrind [-2] [-f] [-n] [-t] [-w] [-W] [-x] [-d defs-file ] [-h header ]
[-l language ] [-s n ] [-o pagelist ] [-P printer ] [-T output -device]
nome do arquivoOpções
| -2 | Produz saída de duas colunas. A especificação desta opção altera o tamanho do ponto padrão para 8 (como se a opção -s8 fosse fornecida). Ele também organiza a saída para aparecer no modo paisagem, fornecendo o sinalizador -L ao formatador e alterando a altura e a largura da página de acordo. |
| -f | Força o modo de filtro. |
| -n | Não cria palavras-chave em negrito. |
| -t | Semelhante à mesma opção no troff ; isto é, o texto formatado vai para a saída padrão. |
| -W | Considera que os caracteres TAB estejam espaçados quatro colunas, em vez dos oito usuais. |
| -W | Força a saída para a impressora Versatec (larga) em vez da Varian (estreita). |
| -x | Produz o arquivo de índice em um formato “bonito”. O próprio arquivo de índice é produzido sempre que o vgrind é executado com um arquivo chamado index, presente no diretório atual . O índice de definições de função pode ser executado, fornecendo à vgrind a opção -x e o índice do arquivo como argumento. |
| -d defs-file | Especifique um arquivo de definições de idioma alternativo (o padrão é / usr / lib / vgrindefs ). |
| -h cabeçalho | Especifique um cabeçalho para aparecer no centro de cada página de saída. |
| -l language | Especifique o idioma a ser usado. Entre os idiomas atualmente conhecidos estão: shell Bourne ( -lsh ), C ( -lc , o padrão), C ++ ( -lc ++ ), shell C ( -lcsh ), emacs MLisp ( -lml ), FORTRAN ( -lf ), Ícone ( -lI ), ISP ( -i ), LDL ( -lLDL ), Modelo ( -lm ), Pascal ( -lp ) e RATFOR ( -lr ). |
| -s n | Especifique um tamanho de ponto a ser usado na saída (exatamente o mesmo que o argumento de uma solicitação de tamanho de ponto de trps .ps). |
| -o pagelist | Imprime apenas as páginas cujos números de página aparecem na lista de paginação separada por vírgula de números e intervalos. Um intervalo N – M significa as páginas N a M ; uma inicial – N significa do início à página N ; e um N final – significa de N até o fim. |
| -P impressora | Envia a saída para a impressora nomeada. |
| -T dispositivo de saída | Formata a saída para o dispositivo de saída especificado. |
| nome do arquivo | Nome da fonte do programa a ser processado pelo vgrind. Use ‘ – ‘ para especificar a entrada padrão. |
Exemplos
vgrind -t meuarquivo.c | lpr -t
imprima uma lista formatada do arquivo de programa myfile.c .
Comandos relacionados
csh – O interpretador de comandos do shell C.
ctags – Crie arquivos de tags para o código fonte.
eqn – Processador de linguagem para descrever equações.
tbl – Pré-processador que formata tabelas para nroff ou troff.
troff – Documentos de tipos ou formatos para exibição no terminal ou impressora de linha.
