manilist - Online na nuvem

PROGRAMA:

NOME

manilist - relata o status dos arquivos em um diretório de origem

SINOPSE

manilista [ -abcdhnptV ] [ -i extensão ] [ -f manifestar ] [ -p formato ] [ -s corda ] [ -w
qual ] [ -x extensão ] [ -C separator ] [ -I incluído ] [ -L tamanho pequeno ] [ -X excluídos ] [
arquivos or diretórios ]

DESCRIÇÃO

Manilista verifica um diretório de origem e produz um relatório sobre o status de cada arquivo:
se está atualizado ou não com relação a patchlevel.h , se estiver faltando em
MANIFEST.new, e algumas outras informações úteis que podem ser configuradas dinamicamente. Isto
pode ser usado para manter um arquivo MANIFEST.new, produzir uma lista detalhada e o status de um
grupo de diretórios, etc ... O rico conjunto de opções concorrem para fazer manilista um perfeito
ferramenta de baixo nível.

Em sua forma de invocação mais simples no diretório de nível superior de um pacote, sem
argumentos, manilista irá escanear o MANIFEST.new e produzir um relatório sobre o status de cada
arquivo listado lá. Cada linha começa com um único sinalizador de caractere que indica o estado
do arquivo, seguido do nome do arquivo.

O que acontece de fato é mais complexo do que isso. Manilista verifica o arquivo MANIFEST.new e
em seguida, percorre todos os arquivos listados ali. Internamente, manilista mantém uma inclusão
e uma lista de exclusão, ambas especificando extensões para arquivos. Por exemplo, a inclusão
lista pode ser ('.c', '.h') e a exclusão ('.o', ', v') para que as fontes C sejam incluídas
e arquivos objeto ou RCS excluídos. Por padrão, todos os arquivos, exceto os excluídos, são usados. Algum
outras seleções podem ser aplicadas nesta fase, como será explicado mais tarde. Para aqueles
arquivos que passam neste processo de seleção, um relatório é emitido de acordo com um relatório formato,
que por padrão é "A:% c %n". A carta A (ou qualquer coisa antes do caractere ':' inicial
é a especificação de seleção de arquivo da qual falamos. O restante é o
formatting, uma string que é impressa no estado em que se encontra, modulo algumas sequências de escape. Acontece
que %c é a bandeira do personagem e %n é o nome do arquivo atual.

De um modo geral, manilista deve ser considerada como uma ferramenta que emite relatórios configuráveis
em um conjunto de arquivos, escolhendo-os seletivamente em uma lista ou examinando diretamente o
diretórios para ver o que está lá fora ...

Ao especificar um conjunto de diretórios ou arquivos como argumentos na linha de comando, você restringe
a área de digitalização, limitando-se a relatórios sobre esses arquivos ou diretórios. Se você fizer
não especificar nenhum, o manilist restringe seu relatório ao diretório atual e seu
subdiretórios, a menos que -t opção é fornecida.

OPÇÕES

Manilista reconhece as seguintes opções:

-a Faça um relatório para todos os os arquivos, independentemente do que é especificado pelo
incluído e excluídos listas de sufixos.

-b Suponha que o diretório atual seja a base (raiz) da árvore do pacote. Quando isso
opção não é especificada, manilista vai procurar por um .pacote arquivo para indicar
o diretório raiz do pacote (também chamado de top) e reclamar se ele
não o encontra.

-c Compare os arquivos com os listados em MANIFEST.new (ou qualquer outro arquivo
especificado através do -f opção) e relatar discrepâncias por meio do %c macro.

-d Despejar listas de sufixos incluídos e excluídos em stderr, sendo as extensões espaço
separados. Uma boa maneira de saber as listas padrão é executar: manilista -f
/ dev / null -bd.

-f manifestar Especifique um arquivo de manifesto alternativo, sendo o padrão usar MANIFEST.new.

-h Imprima a mensagem de ajuda de uso e saia.

-i extensões Adicione novas extensões à lista de sufixos incluída. o extensões argumento
deve listar os sufixos separados por espaços, como em -i '.ph .pl ' para adicionar ambos
.ph e .pl aos sufixos existentes. Observe que o argumento precisa ser
citada para proteger os espaços contra a interpretação do shell.

-n Não use nenhum arquivo de manifesto. Em vez disso, examine os diretórios e aja como
todos os arquivos já estavam listados em um manifesto.

-p formato Defina o novo formato de impressão, que possui o formulário doadores, :corda, com
doadores, sendo uma lista de letras únicas especificando quais arquivos do
manifestos devem ser usados ​​para relatórios e corda sendo uma mensagem para imprimir como
relatório, com algumas substituições macro. Também é possível ter coluna
formatação especificando um '|' dentro da string para delimitar os diferentes
colunas que você deseja ver. Veja também -C e -L para mais parâmetros de formatação.

-s corda Especifique o corda parte do formato de impressão (ver -p para um general
descrição de formato) As macros disponíveis estão listadas mais abaixo no
página do manual.

-t Comece a partir do diretório superior (o diretório raiz da distribuição)
independentemente do diretório atual. Deve haver um .pacote arquivo para
indique qual é o diretório principal.

-w doadores, Especifique o doadores, parte do formato de impressão. Seleções disponíveis
será discutido mais tarde.

-x extensões Adicione novas extensões à lista de sufixos excluídos. o extensões argumento
deve listar os sufixos separados por espaços, como em -x '.s .p ' para adicionar ambos .s
e .p à lista existente. Observe que o argumento precisa ser citado para
proteja os espaços contra a interpretação do shell.

-C separator Forneça o separador de coluna, que deve ser usado no lugar de '|'
caractere na string de formato do relatório. Por padrão, é um único espaço.

-I incluído Especifique uma nova lista de sufixos a serem incluídos nos relatórios. Esse
substitui a lista padrão original (enquanto -i é usado para adicionar sufixos para
a lista). Os sufixos devem ser separados por espaço.

-L tamanho pequeno Ao usar a formatação de coluna (o caractere '|' sendo usado para denotar
colunas), esta opção pode ser usada para especificar a largura máxima da coluna,
separando cada largura por um único ','. Deixar uma largura não especificada não
impor qualquer limite em sua largura. Por exemplo, se a string de formato for
% n |% d |% t, pode-se limitar a coluna do meio (descrições de
MANIFEST.new) para 40 caracteres e a coluna do nome (primeira) para 15
caracteres, deixando o último sem limites impostos, usando -L
15,40,.

-V Imprime o número da versão e sai.

-X excluídos Especifique uma nova lista de sufixos a serem excluídos dos relatórios. Esse
substitui a lista padrão original (enquanto -x é usado para adicionar sufixos para
a lista). Os sufixos devem ser separados por espaço.

USANDO FORMATOS

A flexibilidade de manilista é trazido pelo uso de uma string de formatação dinâmica para
fornecendo seus relatórios. É possível especificar um formato por meio do -p opção ou apenas peças
dele: a string de texto via -s e a seleção do arquivo com -w.

Envie o Seleção
A parte inicial da string de formatação diz manilista em quais arquivos você deseja ver
o relatório final. Os seletores disponíveis são:

A Todos os arquivos, exceto os excluídos (ou seja, aqueles arquivos cujo sufixo está listado no
lista de exclusão). Esta é a ação padrão.
a Todos os arquivos incluídos e / ou excluídos (atalho para ix) Observe que os arquivos que são
nem incluído nem excluído não aparecerá no relatório.
d Reportar apenas para diretórios.
f Relatório apenas para arquivos.
i Apenas os arquivos incluídos são listados.
m Apenas os arquivos ou diretórios encontrados no manifesto são listados.
n Apenas esses arquivos ou diretórios não encontrados no manifesto são listados.
x Apenas os arquivos excluídos são listados.

Quando você especifica mais de uma letra, o relatório resultante depende da natureza do
seleção. Para d, f, m e n, uma união lógica é executada. Isso significa especificar fd or mn
é o mesmo que não especificar nada, mas é menos eficiente, pois manilista é forçado
para realizar as verificações, caso contrário, ele ignoraria. o i e x os seletores são especiais: por
padrão, todos os arquivos não excluídos são relatados. Especificando x também pede excluído
arquivos. Especificando i restringe o relatório aos arquivos incluídos. Usando ambos ao mesmo
Tempo (ix) forçará um relatório para arquivos incluídos ou excluídos.

Macro Substituição
A parte da string do formato do relatório pode usar as seguintes macros:

% c Um caractere que codifica o status do arquivo.
% d Descrição do arquivo de manifesto, se houver.
% n Nome do arquivo (seu caminho desde o diretório superior).
% s Tamanho do arquivo, em bytes.
% t Carimbo de hora da última modificação.

Envie o Status
A %c macro, dando a um único caractere codificando o status do arquivo, pode se expandir em um dos
seguinte.
. O arquivo está atualizado (não mais recente que patchlevel.h).
- O arquivo está presente no manifesto, mas não foi encontrado.
> O arquivo foi modificado desde o último patch (mais recente que patchlevel.h).
+ O arquivo existe, mas não está listado no manifesto.
o O arquivo existe, mas não está listado no manifesto e é mais antigo que patchlevel.h
x O arquivo está listado no manifesto e existe, mas foi excluído. Naturalmente, este
aparecerá no relatório apenas se o x seletor é fornecido no formato de relatório.
? O arquivo está listado no manifesto, não existe e foi excluído.

EXEMPLOS

O comando

manilista -ct -p 'ni:% n'

irá listar todos os arquivos fonte de sua distribuição que não estão listados em seu
Arquivo MANIFEST.new. Observe que isso inclui apenas arquivos "fonte", ou seja, arquivos cujo
extensão está listada na lista de inclusão. Se você não deseja esta restrição, substitua
a string de formatação com n:% n (apenas os arquivos excluídos não aparecerão).

Para construir um arquivo MANIFESTO inicial, use:

manilista -n -p 'Af:% n' > MANIFESTO

no diretório superior. Eventualmente, você desejará preencher descrições para cada arquivo
listado no manifesto.

Use manilist online usando serviços onworks.net