devtodo - Online en la nube

PROGRAMA:

NOMBRE

todo - un programa de recordatorio / tarea dirigido a desarrolladores

SINOPSIS

todo []
Sin opciones, muestra los elementos del directorio actual.

tda [-pag ] [-g ] []
Agregue un nuevo elemento, injertándolo opcionalmente como un elemento secundario del elemento dado.

tde
Edite el elemento dado.

Colina
Quite los elementos dados.

tdd
Marque los elementos especificados como hechos.

todo --Enlace [-gramo ]
Vincular la base de datos devtodo especificada a la actual, injertándola opcionalmente como
un hijo del índice especificado.

DESCRIPCIÓN

todo es un programa dirigido específicamente a programadores (pero que puede utilizar cualquier persona en el
terminal) para ayudar en el desarrollo diario.

Mantiene una lista de elementos que aún no se han completado. Esto permite al programador
Realice un seguimiento de los errores o elementos pendientes que deben completarse con muy poco esfuerzo.

Los elementos se pueden priorizar y también se pueden mostrar en una jerarquía, de modo que un elemento puede
depender de otro.

Con el uso de algunos pequeños scripts de shell (scripts. * En el directorio doc de la fuente
distribución), todo también puede mostrar los elementos pendientes en un directorio a medida que cambia
en ello. Entonces, por ejemplo, si ingresa al directorio de origen de todo, debe
ver una lista de elementos pendientes ... a menos que se hayan solucionado todos los errores;).

OPCIONES

Las opciones pueden tener una forma larga y corta.

Las opciones cortas se pueden combinar en un argumento mediante un guión seguido de una cadena de
opciones cortas. También se pueden agregar parámetros de opciones cortas a esta cadena.

-v, --verboso
Mostrar prolijamente

-a --agregar []
Agregue una nota (le pedirá una nota si no se proporciona una).

-gramo, --injerto
En conjunción con --agregar or --Enlace, injerte el nuevo elemento en el elemento especificado.

-yo, --Enlace
Vincula el archivo de tareas especificado en el cuerpo de este. Si la base de datos vinculada tiene
un conjunto de títulos, esto se utilizará como el cuerpo del elemento de enlace, de lo contrario el
Se utilizará el nombre del directorio de la base de datos vinculada. Utilice --remove (o tdr) para eliminar
bases de datos vinculadas - esto hace no eliminar la base de datos en sí, solo el enlace.

-R, - reparador [, ]
Cambie el padre del índice del primer elemento por el índice del segundo elemento. Si no hay segundo
Se da el índice, el elemento se compara con la raíz del árbol.

-pag, --prioridad
Junto con --add o --edit, establezca la prioridad (por defecto | veryhigh | high |
medio | bajo | muy bajo)

-mi, --editar
Edite la nota que está indexada por el número dado.

--retirar
Elimine la nota indexada por los números dados, incluidos los niños.

-D, --hecho
Marque las notas especificadas (y sus hijos) como hechas.

-RE, --no hecho
Marque las notas especificadas (y todos los niños) como no hechas.

--base de datos global
Especifique la base de datos que se utilizará si el -G or --global se especifican las opciones.

-GRAMO, --global
Forzar todo para usar la base de datos especificada con --base de datos global. Si esto se coloca
en tu ~ / .todorc forzará a todo a usar esa base de datos con exclusión de todos
otros.

--base de datos
Cambie la base de datos de lo que sea el predeterminado (normalmente '.todo') al archivo
especificado.

-T, --HACER
Genere un archivo de texto de salida TODO típico desde una base de datos Todo.

-UN, --todas
Atajo para el filtro '+ hecho, + niños' para mostrar todas las notas.

-F, --filtrar
Muestra solo las notas que pasan el filtro. Consulte la sección FILTROS for
más información.

--color
Anula los colores predeterminados de los elementos de tareas pendientes. Consulte la sección COLOR


--force-color
Forzar el uso del color incluso cuando no se envía a un TTY. Esto es útil cuando se conectan
a less(1) -R.

--mononucleosis infecciosa Elimine todas las secuencias de escape ANSI de la salida: útil para personas con problemas de color
terminales

--ayuda Muestre esta ayuda.

--versión
Muestra la versión de Tareas pendientes.

--título []
Establezca el título de las notas de tareas pendientes de este directorio.

--formato de fecha
Formatee la visualización de valores de tiempo. El formato es el utilizado por Strftime(3). los
el formato predeterminado es '% c'. Esta opción se especifica mejor en la ~ / .todorc.

--formato =
Especifique el formato de la salida. Consulte la sección FORMATEO para obtener más información.


--uso-formato =
Utilice la cadena de formato identificada por (definido con --format) como el
cadena de formato que se utilizará al formatear con el formato incorporado .

--clasificar
Ordena la base de datos con la expresión especificada. Consulte la sección CLASIFICACIÓN for
Información más detallada.

--paranoico
Sea paranoico con algunas configuraciones, incluidos los permisos.

- cargadores de bases de datos <cargador lista>
Pruebe los formatos de la base de datos en el orden indicado. Los formatos válidos son xml y binario. p.ej.
todo --database-loaders binary, xml. El formato predeterminado es XML.

--respaldo []
Haga una copia de seguridad de la base de datos hasta veces, justo antes de que se escriba. Si no es
especificado, se realizará una copia de seguridad. Los nombres de archivo utilizados para almacenar las copias de seguridad son los
nombre de base de datos predeterminado con su revisión adjunta de esta manera: .todo.1, .todo.2, etc.
Para usar realmente una de estas copias de seguridad, puede convertirla en .todo o usar
--base de datos .todo. para especificar explícitamente su uso.

-s, --resumen
Alternar el modo "resumen", donde los elementos largos se truncan en una línea.

-C, --comentario
Edite o muestre comentarios respectivamente.

--se acabó el tiempo []
If se especifica, el tiempo de espera entre las pantallas de la base de datos se establece en este número
de segundos. Si no se especifica, el comportamiento es mostrar la base de datos
only si no se ha mostrado durante el número de segundos especificado por --timeout
con de la forma más dado. p.ej. todo --se acabó el tiempo 10 --se acabó el tiempo solo mostraría el
base de datos como máximo una vez cada 10 segundos. Poniendo un tiempo de espera 10 en tu ~ / .todorc es un
buena opción, entonces el --timeout en el doc / scripts. * significará que la base de datos
no se mostrará cada vez que ingrese a un directorio.

--purga []
Purgue todos los elementos completados anteriores a . Si se omite, todo
los registros completados se depuran.

PRIORIDADES

Las prioridades se pueden especificar simbólicamente usando las palabras tu préstamo estudiantil, muy alto, high, mediano ,
low y muy bajo.

El sistema tu préstamo estudiantil La prioridad tiene un significado especial en el sentido de que utilizará la prioridad predeterminada para cualquier
acción. Esto significa que al editar un elemento existente, se conserva su prioridad; cuando
creando un nuevo elemento, la prioridad se establecerá en mediano ; al injertar un nuevo elemento, es
la prioridad será la de su padre. DevTodo no solicitará prioridad si esto es
especificado, lo que lo convierte en una función útil para su todorc. Como ocurre con todas las opciones, la prioridad
se puede anular en la línea de comando.

FILTROS

Los filtros se componen de una lista de expresiones que se utilizan para definir las notas que se
desplegado.

El formato general de una expresión de filtro es:

([- | = | +] (todos | niños | hecho | | )) | (/ expresión>)

Generalmente, si una expresión de filtro tiene el prefijo '-', no mostrar elementos que
coincidir con la expresión, si tiene el prefijo '+', se mostrarán elementos que coincidan con esto
expresión además de otras, o si tiene el prefijo '=' (o ningún prefijo)
la visualización only aquellos elementos que coinciden con la expresión. Tenga en cuenta que esto solo buscará elementos
no excluido por otros filtros, por lo que para buscar en toda la base de datos tendrá que hacer
algo como: todo --filtrar todo, / alguna-cadena-de-búsqueda.

La segunda forma de expresión de filtro se utiliza para buscar texto en una base de datos. <buscar
expresión> es una expresión regular que se compara con el cuerpo del texto de cada elemento.

Los átomos de filtro se filtran en orden por estado, prioridad y luego búsqueda. Así que primeros elementos
que no coincidan con el filtro "hecho" se excluirán, luego, aquellos que no coincidan con el
filtro de prioridad, etc.

Las expresiones en detalle:

all Obliga a que se muestren todos los elementos. Los diversos prefijos no tienen ningún efecto en este
expresión.

niños
Contraer o expandir elementos secundarios. Si el prefijo '-' está presente, los niños son
contraído, de lo contrario, se muestran los niños.

done Filtre si un elemento está completo o no.


Los índices de nota se especifican como números. Los rangos se pueden dar ala '1.2.10-20'.


Las prioridades se especifican como se describe en el PRIORIDADES sección. Un prefijo de '-'
mostrará todos los elementos con prioridades menores o iguales a la prioridad dada.
Con un prefijo '+', todos los elementos con prioridades mayores o iguales a las indicadas
se muestran las prioridades. Si '=' o no se da ningún prefijo, solo los elementos con el
se muestran las prioridades.

Ejemplos:

todo --filter done, -children, + low

Esto mostrará solo aquellos elementos que están hechos y tienen una prioridad baja o alta. En
Además, los niños se derrumbarán.

todo / [Tt] él

Muestre solo aquellos elementos con la palabra 'the' en ellos, donde la primera letra puede ser más baja
o mayúsculas. Puede ser necesario citar la expresión de búsqueda para asegurarse de que el shell lo haga.
no interpretarlos.

FORMATEAR

La salida de todo se puede cambiar para que sea más de su agrado definiendo su propia
cadenas de formato. Estas cadenas son similares a las que se utilizan en Printf(3) y Strftime(3).

Los siguientes ejemplos, que se pueden colocar en ~ / .todorc, imitará el predeterminado
comportamiento:

# Mostrar en formato predeterminado
formato de visualización =% i% [info]% f% 2n.% [prioridad]% T

# Mostrar en formato predeterminado
formato generado =% 2i-% T% 2i (agregado% d, prioridad% p) \ n \ n

Hay cuatro opciones de formato independientes: la visualización, generado, visualización detallada y verboso-
generado. Los dos últimos se utilizan para formatear su texto respectivo cuando --verbose es
especificado como un argumento para hacer.

Además, los usuarios pueden crear sus propias cadenas de formato simplemente pasando un
identificador a formato. Esto se puede habilitar usando --uso-formato. p.ej.

formato informe completo =% i% [info]% f% 2n.% [prioridad]% + 1T% + 1i% [info] Agregado:% [normal]% c
% [info] Completado:% [normal]% d \ n% + 1i% [info] Duración:% [normal]% D% [info] Prioridad:
% [normal]% p \ n \ n
# Anule el formato de visualización para utilizar "informe completo".
pantalla de formato de uso = informe completo

Las diversas banderas que están disponibles son:

% > El sistema > bandera establece el número de espacios para usar para todas las sangrías futuras.

% [+ | -] [ ]I
Aplicar sangría a la profundidad del elemento actual. especifica la profundidad a la que se aplicará la sangría. Si is
omitido, se utiliza el nivel actual. Se pueden utilizar valores relativos. p.ej. '% + 1T'
sangría a un nivel más alto que el nivel de sangría actual.

% [+ | -] [ ] T
Muestre el texto del elemento, envuelto en 80 caracteres y sangrado al
nivel especificado. Semántica de son como con %i. Tenga en cuenta que el texto envuelto
agrega automáticamente un '0 al final del texto, mientras que %t no lo hare

%t Texto del elemento sin envolver ni formatear.

%s Texto de resumen (es decir, solo una línea, equivalente a --resumen).

%p El nivel de prioridad del elemento actual.

%c La fecha de creación de los elementos actuales, formateada según --date-format.

%d La fecha en la que el elemento se marcó como hecho, formateado de acuerdo con --date-format.

%D La duración del elemento, formateado según --date-format.

% [ ]norte
El número de índice del artículo actual. El valor numérico opcional especifica el
número de caracteres que debe ocupar el número. El número se rellena con espacios.
para llenar este número de caracteres.

%f La bandera del estado del artículo actual. Los valores mostrados para esta bandera son '+'
significa niños, '-' significa hecho ',' * 'significa hecho con niños.

%F La bandera de estado legible por humanos del elemento actual. Los valores mostrados para esto
bandera son 'niños', 'hecho' significa hecho ',' hecho, niños 'y' abierto '.

% [ ]
Los colores se pueden especificar con esta bandera. Los valores válidos para son:
muy bajo, low, mediano , high, muy alto, título, infoy lista de prioridades. Estos son bastante
autoexplicativo, excepto lista de prioridades cambia al color de prioridad de los elementos actuales. p.ej.
%[prioridad]

Tenga en cuenta que al sangrar, típicamente desea utilizar un valor de prefijo de '+1'
con% T. es decir. % + 1T. Esto obliga al texto a sangrar a un nivel más profundo que el actual.
nivel, lo que lo aleja de cualquier otro formato que pueda haber utilizado.

CLASIFICACIÓN

La visualización de elementos en la base de datos se puede ordenar en una variedad de claves. Dada una serie de
claves todo ordena en cada clave sucesiva, continuando a la siguiente solo si la clave anterior
la comparación fue igual. Por ejemplo:

todo --sort -done, text

Esto ordenará, en primer lugar, si un elemento está completo y, en segundo lugar, según su texto. Esta
agrupa de forma eficaz los elementos en dos bloques: los que están completos y los que no.

Las claves que están disponibles son creado, terminado, texto, lista de prioridades, duración, ninguna y
done. Cada tecla, excepto ninguna se puede prefijar con un - para invertir su orden predeterminado y
varias claves deben separarse con,.

Si se encuentran varios parámetros --sort, se utiliza el último. Esto significa que un
'ordenar' entrada en ~ / .todorc será anulado por cualquiera en la línea de comando.

ÍNDICES

Los indicios se utilizan como opciones para una variedad de argumentos de línea de comando. Índices de notas múltiples
están separados por comas (los espacios son no permitido). El alcance de los niños se realiza mediante un '.'.

Por ejemplo, dadas las siguientes notas:

1. Hacer páginas de manual
1. Hazlos más hermosos.
2. Haga también documentación HTML.

El segundo subtema se representaría así: 1.2

El comodín '*' se puede utilizar para representar a todos los hijos de un nodo. p.ej. 1. *

Los rangos de notas se pueden especificar usando ' - '. Por ejemplo, para marcar notas 10.1.2,
10.1.3 y 10.3.4 como hecho, puede hacer: todo --done 10.1.2-4

COLOR

Se pueden colorear varios artículos. Elementos que pueden ser muy alto, high, mediano , low, muy bajo,
título y info. info se utiliza para mostrar números de artículo e información general.

Estos elementos se pueden configurar en uno de los ocho colores. Esos colores son negro, rojo, green,
amarillo, azul, magenta, cian, complejo de salvador blanco y tu préstamo estudiantil. El color tu préstamo estudiantil se utiliza para especificar el
color predeterminado de la terminal de primer plano.

Los colores se especifican así:

=[+]

Si el opcional + si se usa esta expresión, el elemento se pondrá en negrita.

Por ejemplo, una línea en su ~ / .todorc podría verse así:

color medio = + blanco

Que haría mediano texto complejo de salvador blanco.

TODORC

todo puede cargar opciones de varios archivos de recursos. El orden en el que se analizan
es el siguiente:

1. El archivo especificado en la variable de entorno. TODORC o, si eso no existe,
/ etc / todorc.
2. ~ / .todorc

Las opciones son acumulativas en el sentido de que las cargadas desde $ TODORC serán anuladas o agregadas por
aquellos en ~ / .todorc.

Estas opciones se especifican como pares clave / valor, uno por línea La clave es el nombre largo de un
argumento de línea de comando y el valor es el parámetro de ese argumento, si lo hay. Además,
las variables de entorno se expanden.

Por ejemplo, el argumento de la línea de comando --filter acepta un parámetro que es un filtro
expresión. Se puede agregar un filtro predeterminado al ~ / .todorc archivo así:

# No mostrar elementos secundarios de forma predeterminada
filtro -niños

La única diferencia entre las opciones especificadas en el archivo rc y las de la línea de comando
es que las opciones en el archivo rc no tienen el prefijo -.

Además, hay dos comandos disponibles en el archivo RC que no están disponibles en el
línea de comando. Son:

El primer comando, on, se utiliza para agregar comandos específicos de forma condicional. El formato de este
comando es: on [ ]. Los eventos válidos son add, remove, view, editar,
generar, done, no hecho, título, reparador, carga, ahorrar, enlace, Para crear y purga. Múltiple
los comandos se pueden pasar a on encerrándolos entre llaves (se requiere un espacio en blanco entre
tokens). Ejemplo completo a continuación.

El segundo comando es ejecutivo <cáscara comando>. Este comando ejecutará el argumento que es
dado en un caparazón. La variable de entorno $ TODODB contiene el nombre de archivo de la actual
base de datos. p.ej. ejecutivo chmod 600 $ TODODB

Hay un archivo rc de ejemplo en el subdirectorio doc de la distribución fuente.

EJEMPLOS

Para mostrar los elementos pendientes en el directorio actual, simplemente escriba:

todo

Para eliminar las notas 1, 2 y 4:

todo --eliminar 1,2,4

Para mostrar TODOS los elementos:

hacer todo

Para mostrar solo los elementos de nivel superior y no sus elementos secundarios:

todo -niños

(aunque -niños no es un argumento válido, esto funciona porque todo interpreta cualquier
argumentos de línea de comando que no reconoce como parte de una expresión de filtro)

Un ejemplo más complejo. Esto agrega un nuevo elemento, con el texto del elemento especificado en el
línea de comando, con una prioridad de high como hijo del tercer hijo del segundo elemento (si
eso tiene algún sentido):

todo -a "Reparar la página de manual" -p high -g 2.3

Este es un ejemplo de cómo utilizar la función TODO de todo. Hace que todo genere una nueva
Archivo TODO de la información almacenada en la base de datos. Este ejemplo en particular genera todos
elementos al archivo TODO, incluso aquellos marcados como hechos.

todo --filtrar todo --TODO

Este ejemplo muestra un buen uso de los activadores de eventos. Cuando se crea una nueva base de datos
forzará sus permisos a 0600.

en crear {
verboso
ejecutivo chmod 600 .todo
}

Use devtodo en línea usando los servicios de onworks.net