tda - Online na nuvem

PROGRAMA:

NOME

todo - um programa de lembrete / tarefa voltado para desenvolvedores

SINOPSE

TODO []
Sem opções, exibe os itens no diretório atual.

tda [-p ] [-g ] []
Adicione um novo item, opcionalmente enxertando-o como filho do item fornecido.

tde
Edite o item fornecido.

TDR
Remova os itens fornecidos.

tdd
Marque os itens especificados como concluídos.

TODO --ligação [-g ]
Vincule o banco de dados devtodo especificado ao atual, opcionalmente, enxertando-o como
um filho do índice especificado.

DESCRIÇÃO

TODO é um programa voltado especificamente para programadores (mas utilizável por qualquer pessoa no
terminal) para ajudar no desenvolvimento do dia-a-dia.

Ele mantém uma lista de itens que ainda não foram concluídos. Isso permite que o programador
rastrear bugs ou itens pendentes que precisam ser concluídos com muito pouco esforço.

Os itens podem ser priorizados e também podem ser exibidos em uma hierarquia, de modo que um item pode
dependem de outro.

Com o uso de alguns pequenos scripts de shell (scripts. * No diretório doc da fonte
distribuição), o todo também pode exibir os itens pendentes em um diretório conforme você altera
afim disso. Então, por exemplo, se você entrar no diretório de origem do todo em si, você deve
veja uma lista de itens pendentes ... a menos que todos os bugs tenham sido corrigidos;).

OPÇÕES

As opções podem ter uma forma longa ou curta.

As opções curtas podem ser combinadas em um argumento usando um hífen seguido por uma string de
opções curtas. Parâmetros de opções curtas também podem ser anexados a esta string.

-dentro, --verbose
Exibir detalhadamente

-uma, --adicionar []
Adicione uma nota (solicitará uma nota se não for fornecida).

-g, --enxerto
Em conjunção com --adicionar or --ligação, enxertar o novo item no item especificado.

-eu, --ligação
Vincule o arquivo de tarefas especificado ao corpo deste. Se o banco de dados vinculado tiver
um conjunto de títulos, ele será usado como o corpo do item de ligação, caso contrário, o
o nome do diretório do banco de dados vinculado será usado. Use --remove (ou tdr) para remover
bancos de dados vinculados - isso faz não remova o próprio banco de dados, apenas o link.

-R, - reparent [, ]
Mude o pai do primeiro índice de item para o segundo índice de item. Se não houver segundo
o índice é fornecido e o item é reparado na raiz da árvore.

-p, --prioridade
Em conjunto com --add ou --edit, defina a prioridade (default | veryhigh | high |
médio | baixo | muito lento)

-e --editar
Edite a nota indexada pelo número fornecido.

--retirar
Remova a nota indexada pelos números fornecidos, incluindo todos os filhos.

-d, --feito
Marque as notas especificadas (e seus filhos) como concluídas.

-D, --não realizado
Marque as notas especificadas (e todos os filhos) como não concluídas.

--global-banco de dados
Especifique o banco de dados a ser usado se o -G or --global opções são especificadas.

-G, --global
Força todo para usar o banco de dados especificado com --global-banco de dados. Se este for colocado
na sua ~ / .todorc forçará todo a usar esse banco de dados com a exclusão de todos
outras.

--base de dados
Altere o banco de dados de qualquer que seja o padrão (normalmente '.todo') para o arquivo
Especificadas.

-T, --PENDÊNCIA
Gere um arquivo de texto de saída TODO típico de um banco de dados Todo.

-UMA, --tudo
Atalho para o filtro '+ done, + children' para mostrar todas as notas.

-f, --filtro
Exibe apenas as notas que passam no filtro. Por favor, consulte a seção FILTROS for
Mais Informações.

--cor
Substitua as cores padrão dos itens de tarefas. Por favor, consulte a seção COR para mais
informações.

--force-color
Força o uso da cor mesmo quando não estiver enviando para um TTY. Isso é útil ao encanar
para menos(1) -r.

--mono Remova todas as sequências de escape ANSI da saída - útil para pessoas com problemas de cor
terminais.

--Socorro Mostre esta ajuda.

--versão
Versão de exibição do ToDo.

--título []
Defina o título das notas de tarefas deste diretório.

--Formato de data
Formate a exibição dos valores de tempo. O formato é o usado por horário de trabalho(3) o
o formato padrão é '% c'. Esta opção é melhor especificada no ~ / .todorc.

--formato =
Especifique a formatação da saída. Consulte a seção FORMATANDO para mais
informações.

--use-formato =
Use a string de formato identificada por (definido com --format) como o
string de formato para usar ao formatar com o formato embutido .

--ordenar
Classifique o banco de dados com a expressão especificada. Consulte a seção ORDENAÇÃO for
informações mais detalhadas.

--paranóico
Seja paranóico com algumas configurações, incluindo permissões.

--carregadores de banco de dados <loader lista>
Experimente os formatos de banco de dados na ordem fornecida. Os formatos válidos são xml e binário. por exemplo.
todo - binário de banco de dados-loaders, xml. O formato padrão é XML.

--cópia de segurança []
Faça backup do banco de dados até vezes, pouco antes de ser escrito. Se não é
especificado, será feito um backup. Os nomes de arquivo usados ​​para armazenar os backups são os
nome do banco de dados padrão com sua revisão anexada como: .todo.1, .todo.2, etc.
Para realmente usar um desses backups, você pode transferi-lo para .todo ou usar
--database .todo. para especificar explicitamente seu uso.

-sim, --resumo
Alterne o modo "resumo", onde itens longos são truncados em uma linha.

-c, --Comente
Edite ou mostre comentários respectivamente.

--tempo esgotado []
If é especificado, o tempo limite entre as exibições do banco de dados é definido com este número
de segundos. Se não é especificado, o comportamento é exibir o banco de dados
só se não tiver sido exibido durante o número de segundos especificado por --timeout
com da dado. por exemplo. TODO --tempo esgotado 10 --tempo esgotado iria apenas exibir o
banco de dados no máximo uma vez a cada 10 segundos. Colocando um tempo limite 10 na sua ~ / .todorc é um
boa opção, então o --timeout no doc / scripts. * significará que o banco de dados
não será exibido toda vez que você fizer cd em um diretório.

--purga []
Elimine todos os itens concluídos com mais de . Se é omitido, tudo
os registros concluídos são eliminados.

PRIORIDADES

As prioridades podem ser especificadas simbolicamente usando as palavras omissão, muito alto, Alto, média,
baixo e muito lento.

A omissão a prioridade tem um significado especial porque usará a prioridade padrão para qualquer
açao. Isso significa que, ao editar um item existente, sua prioridade é preservada; quando
criando um novo item, a prioridade será definida para média; ao enxertar um novo item, é
a prioridade será a de seu pai. DevTodo não solicitará prioridade se este for
especificado, tornando-o um recurso útil para o seu todorc. Tal como acontece com todas as opções, a prioridade
pode ser substituído na linha de comando.

FILTROS

Os filtros são compostos por uma lista de expressões usadas para definir as notas que são
exibido.

O formato geral de uma expressão de filtro é:

([- | = | +] (todos | filhos | concluídos | | )) | (/ expressão>)

Geralmente, se uma expressão de filtro é prefixada com um '-' ela irá não exibir itens que
coincidir com a expressão, se prefixado com um '+' irá exibir os itens que correspondem a este
expressão além de outras, ou se prefixado com um '=' (ou nenhum prefixo) ele irá
exibição só os itens que correspondem à expressão. Observe que isso irá pesquisar apenas itens
não excluído por outros filtros, então para pesquisar todo o banco de dados você terá que fazer
algo como: TODO --filtro all, / some-search-string.

A segunda forma de expressão de filtro é usada para pesquisar texto em um banco de dados. <pesquisar
expressão> é uma expressão regular que corresponde ao corpo do texto de cada item.

Os átomos do filtro são filtrados em ordem por estado concluído, prioridade e pesquisa. Então, primeiros itens
que não corresponderem ao filtro "concluído" serão excluídos, então aqueles que não corresponderem ao
filtro de prioridade e assim por diante.

As expressões em detalhes:

todos os Força a exibição de todos os itens. Os vários prefixos não têm efeito sobre este
expressão.

crianças
Recolher ou expandir itens filho. Se o prefixo '-' estiver presente, os filhos são
recolhido, caso contrário, os filhos serão exibidos.

feito Filtre se um item foi concluído ou não.


Os índices de nota são especificados como números. Os intervalos podem ser fornecidos como ala '1.2.10-20'.


As prioridades são especificadas conforme descrito no PRIORIDADES seção. Um prefixo de '-'
irá exibir todos os itens com prioridades menores ou iguais à prioridade dada.
Com um prefixo '+', todos os itens com prioridades maiores ou iguais ao dado
prioridade são mostrados. Se '=' ou nenhum prefixo é fornecido, apenas os itens com o especificado
prioridade são exibidos.

Exemplos:

todo --filter concluído, -crianças, + baixo

Isso exibirá apenas os itens que estão concluídos e têm uma prioridade baixa ou superior. No
Além disso, as crianças ficarão colapsadas.

todo / [Tt] ele

Exibe apenas os itens com a palavra 'the' neles, onde a primeira letra pode ser inferior
ou maiúsculas. Pode ser necessário citar a expressão de pesquisa para garantir que o shell
não interpretá-los.

FORMATANDO

O resultado de todo pode ser alterado para ficar mais ao seu gosto, definindo o seu próprio
formatação de strings. Essas strings são semelhantes às usadas em printf(3) e horário de trabalho(3).

Os exemplos a seguir, que podem ser colocados em ~ / .todorc, irá imitar o padrão
comportamento:

# Exibir no formato padrão
exibição de formato =% i% [info]% f% 2n.% [prioridade]% T

# Exibir no formato padrão
formato gerado =% 2i-% T% 2i (adicionado% d, prioridade% p) \ n \ n

Existem quatro opções de formato distintas: exibição, gerado, exibição detalhada e verboso
gerado. Os dois últimos são usados ​​para formatar seus respectivos textos quando --verbose for
especificado como um argumento para todo.

Além disso, os usuários podem criar suas próprias strings de formato simplesmente passando um diferente
identificador para formato. Isso pode então ser habilitado usando --use-formato. por exemplo.

formato relatório completo =% i% [info]% f% 2n.% [prioridade]% + 1T% + 1i% [info] Adicionado:% [normal]% c
% [info] Concluído:% [normal]% d \ n% + 1i% [info] Duração:% [normal]% D% [info] Prioridade:
% [normal]% p \ n \ n
# Substitua o formato de exibição para usar "relatório completo".
use-format display = full-report

Os vários sinalizadores disponíveis são:

% > A > bandeira define o número de espaços para usar em todos os recuos futuros.

% [+ | -] [ ]eu
Recue até a profundidade do item atual. especifica a profundidade para o recuo. Se is
omitido, o nível atual é usado. Valores relativos podem ser usados. por exemplo. '% + 1T' seria
recuar para um nível acima do nível de recuo atual.

% [+ | -] [ ] T
Exibe o texto do item, empacotado em 80 caracteres e recuado para o
nível especificado. Semântica de são como com %i. Observe que o texto quebrado
adiciona automaticamente um '0 no final do texto, enquanto %t não vou.

%t Texto não embrulhado e não formatado do item.

%s Texto de resumo (ou seja, uma linha apenas, equivalente a --resumo).

%p O nível de prioridade do item atual.

%c A data de criação dos itens atuais, formatada de acordo com --date-format.

%d A data em que o item foi marcado como concluído, formatada de acordo com --date-format.

%D A duração do item, formatado de acordo com --date-format.

% [ ] n
O número do índice do item atual. O valor numérico opcional especifica o
número de caracteres que o número deve ocupar. O número é preenchido com espaços
de modo a preencher esse número de caracteres.

%f A bandeira do estado do item atual. Os valores exibidos para este sinalizador são '+'
significa filhos, '-' significa feito ',' * 'significa feito com filhos.

%F O sinalizador de estado legível por humanos do item atual. Os valores exibidos para este
flag são 'filhos', 'feito' significa feito ',' feito, filhos 'e' aberto '.

% [ ]
As cores podem ser especificadas com este sinalizador. Os valores válidos para como:
muito lento, baixo, média, Alto, muito alto, título, info e prioridade. Estes são bastante
autoexplicativo, exceto prioridade muda para a cor de prioridade dos itens atuais. por exemplo.
%[prioridade]

Observe que ao recuar, você irá tipicamente deseja usar um valor de prefixo de '+1'
com% T. ou seja, % + 1T. Isso força o recuo do texto para um nível mais profundo do que o atual
nível, fazendo com que fique longe de qualquer outra formatação que você possa ter usado.

ORDENAÇÃO

A exibição de itens no banco de dados pode ser classificada em uma variedade de chaves. Dada uma série de
keys todo classifica em cada chave sucessiva, continuando com a próxima apenas se a chave anterior
a comparação foi igual. Por exemplo:

todo --sort -done, text

Isso classificará primeiro pelo fato de um item ser concluído e, em segundo lugar, pelo texto. Esse
efetivamente agrupa os itens em dois blocos - os que estão completos e os que não estão.

As chaves disponíveis são criado, concluído, texto, prioridade, duração, Nenhum e
feito. Cada chave, exceto Nenhum pode ser prefixado com um - para inverter sua ordem padrão e
várias chaves devem ser separadas por um,.

Se vários parâmetros --sort forem encontrados, o último será usado. Isso significa que um
'classificar' entrada em ~ / .todorc será substituído por qualquer na linha de comando.

ÍNDICES

Indicies são usados ​​como opções para uma variedade de argumentos de linha de comando. Múltiplos índices de notas
são separados por vírgulas (os espaços são não permitido). O escopo das crianças é definido com um '.'

Por exemplo, dadas as seguintes notas:

1. Faça páginas de manual
1. Torne-os mais bonitos.
2. Faça a documentação HTML também.

O segundo subitem seria representado assim: 1.2

O curinga '*' pode ser usado para representar todos os filhos de um nó. por exemplo. 1. *

Intervalos de notas podem ser especificados usando ' - '. Por exemplo, para marcar notas 10.1.2,
10.1.3 e 10.3.4 como concluído, você poderia fazer: todo --done 10.1.2-4

COR

Vários itens podem ser coloridos. Itens que podem ser muito alto, Alto, média, baixo, muito lento,
título e info. info é usado para exibir números de item e informações gerais.

Esses itens podem ser definidos para uma de oito cores. Essas cores são preto, vermelho, verde,
amarelo, azul, magenta, ciano, branco e omissão. A cor omissão é usado para especificar o
cor padrão de primeiro plano do terminal.

As cores são especificadas da seguinte forma:

=[+]

Se o opcional + nesta expressão, ela fará com que o item fique em negrito.

Por exemplo, uma linha em seu ~ / .todorc pode ser parecido com:

meio de cor = + branco

O que faria média texto pino branco.

TODORC

todo pode carregar opções de vários arquivos de recursos. A ordem em que são analisados
é como se segue:

1. O arquivo especificado na variável de ambiente TODORC ou, se isso não existir,
/ etc / todorc.
2. ~ / .todorc

As opções são cumulativas no sentido de que aquelas carregadas de $ TODORC serão substituídas ou adicionadas por
aqueles em ~ / .todorc.

Essas opções são especificadas como pares chave / valor, um por linha A chave é o nome longo de um
argumento de linha de comando e o valor é o parâmetro para esse argumento, se houver. Além disso,
as variáveis ​​de ambiente são expandidas.

Por exemplo, o argumento da linha de comando --filter aceita um parâmetro que é um filtro
expressão. Um filtro padrão pode ser adicionado ao ~ / .todorc arquivo assim:

# Não exibe itens filho por padrão
filtro -crianças

A única diferença entre as opções especificadas no arquivo rc e aquelas na linha de comando
é que as opções no arquivo rc não são prefixadas por -.

Além disso, existem dois comandos disponíveis no arquivo RC que não estão disponíveis no
linha de comando. Eles são:

O primeiro comando, on, é usado para adicionar condicionalmente comandos específicos. O formato deste
o comando é: on [ ]. Os eventos válidos são adicionar, remover, view, editar,
gerar, feito, não realizado, título, reparador, carregar, salvar, link, crio e purga. Múltiplo
os comandos podem ser passados ​​para on colocando-os entre colchetes (é necessário espaço em branco entre
tokens). Exemplo completo abaixo.

O segundo comando é exec <shell comando>. Este comando irá executar o argumento que é
dado em uma concha. A variável de ambiente $ TODODB contém o nome do arquivo do atual
base de dados. por exemplo. exec chmod 600 $ TODODB

Há um arquivo rc de exemplo no subdiretório doc da distribuição de origem.

EXEMPLOS

Para exibir quaisquer itens pendentes no diretório atual, basta digitar:

TODO

Para remover as notas 1, 2 e 4:

todo --remove 1,2,4

Para exibir TODOS os itens:

fazer tudo

Para exibir apenas os itens de nível superior e não seus filhos:

todo -crianças

(Apesar de -crianças não é um argumento válido, isso funciona porque todo interpreta qualquer
argumentos de linha de comando que ele não reconhece como sendo parte de uma expressão de filtro)

Um exemplo mais complexo. Isso adiciona um novo item, com o texto do item especificado no
linha de comando, com uma prioridade de Alto como filho do terceiro filho do segundo item (se
isso faz algum sentido):

todo -a "Corrigir a página do manual" -p high -g 2.3

Este é um exemplo de como usar o recurso TODO de todo. Faz com que todas as tarefas gerem um novo
Arquivo TODO a partir das informações armazenadas no banco de dados. Este exemplo particular produz todos
itens para o arquivo TODO, mesmo aqueles marcados como concluídos.

todo - filtrar tudo --TODO

Este exemplo mostra um bom uso dos gatilhos de evento. Quando um novo banco de dados é criado,
forçará suas permissões para 0600.

na criação {
detalhado
exec chmod 600 .todo
}

Use tda online usando serviços onworks.net