tdd - 云端在线

程序：

您的姓名

todo - 针对开发人员的提醒/任务程序

概要

所有 []
如果没有选项，则显示当前目录中的项目。

TDA [-p ] [-G []
添加一个新项目，可选择将其嫁接为给定项目的子项。

TDE
编辑给定的项目。

TDR
删除给定的项目。

时间
将指定的项目标记为已完成。

所有 - 关联 [-G ]
将指定的 devtodo 数据库链接到当前的数据库中，可选择将其嫁接为
指定索引的子项。

商品描述

所有 是一个专门针对程序员的程序（但任何人都可以使用
终端）以帮助日常开发。

它维护尚未完成的项目列表。 这允许程序员
跟踪未完成的错误或需要花费很少的精力来完成的项目。

项目可以按优先级排序，也可以按层次结构显示，以便一个项目可以
依赖另一个。

配合一些小的shell脚本（源码的doc目录下的scripts.*
分发），todo 也可以在你改变时显示目录中未完成的项目
进去。 因此，例如，如果您 cd 进入 todo 本身的源目录，您应该
查看未完成项目的列表...除非所有错误都已修复；)。

配置

期权可以有长格式和短格式。

短选项可以通过使用连字符后跟一串
短选项。 短选项的参数也可以附加到这个字符串。

-v， --详细
详细显示

-一种， - 添加 []
添加注释（如果未提供，将提示输入注释）。

-G， - 接枝
和这个结合 - 添加 or - 关联，将新项目嫁接到指定项目。

-l, - 关联
将指定的 todo 文件链接到此文件的正文中。 如果链接的数据库有
标题集，这将用作链接项的正文，否则
将使用链接数据库的目录名称。 使用 --remove（或 tdr）删除
链接数据库 - 这样做 而不去 删除数据库本身，只有链接。

-R,--reparent [, ]
将第一个项目索引的父项更改为第二个项目索引。 如果没有第二
给定索引，该项目重新指向树的根。

-p, - 优先事项
结合--add 或--edit，设置优先级（默认|非常高|高|
中 | 低 | 非常低）

-e， - 编辑
编辑由给定编号索引的注释。

- 消除
删除由给定数字索引的笔记，包括任何孩子。

-d, - 完毕
将指定的笔记（及其子笔记）标记为完成。

-D, - 尚未完成
将指定的笔记（和所有孩子）标记为未完成。

--全局数据库
指定要使用的数据库，如果 -G or - 全球的 选项被指定。

-G， - 全球的
强制待办事项使用指定的数据库 --全局数据库. 如果这样放置
在您的 〜/.todorc 它将强制 todo 使用该数据库以排除所有
其他。

- 数据库
将数据库从默认值（通常是“.todo”）更改为文件
指定的。

-T, - 去做
从 Todo DB 生成典型的 TODO 输出文本文件。

-一种， - 全部
过滤器“+done,+children”的快捷方式以显示所有笔记。

-F， - 筛选
只显示那些通过过滤器的音符。 请参阅部分 滤波器 HPMC胶囊
更多信息。

- 颜色
覆盖 todo 项目的默认颜色。 请参阅部分 镜片颜色 更多
信息。

--force-颜色
即使不输出到 TTY 也强制使用颜色。 这在管道时很有用
至 减(1) -R

- 单核细胞增多症 从输出中删除所有 ANSI 转义序列 - 对颜色受损很有用
终端。

- 帮帮我 显示此帮助。

- 版
ToDo 的显示版本。

- 标题 []
设置此目录的待办事项的标题。

- 日期格式
格式化时间值的显示。 格式是由 时间（3）。 该
默认格式为“%c”。 此选项最好在 〜/.todorc.

- 格式 =
指定输出格式。 请参阅格式化部分了解更多信息
信息。

--使用格式 =
使用由标识的格式字符串 （用 --format 定义）作为
使用内置格式进行格式化时要使用的格式字符串 .

- 种类
使用指定的表达式对数据库进行排序。 参考章节 排序 HPMC胶囊
更详细的信息。

--偏执
对某些设置（包括权限）保持警惕。

--数据库加载器 <装载机 列表>
按给定的顺序尝试数据库格式。 有效格式为 XML 和 二进制. 例如。
todo --database-loaders 二进制文件，xml。 默认格式为 XML。

--备份 []
将数据库备份到 次，就在它被写入之前。 如果 是不是
指定，将进行一次备份。 用于存储备份的文件名是
默认数据库名称及其修订版附加如下：.todo.1、.todo.2 等。
要实际使用这些备份之一，您可以将其 mv 到 .todo 或使用
--数据库.todo。 明确指定其用途。

-是的， - 概括
切换“摘要”模式，其中长项目被截断为一行。

-C， - 评论
分别编辑或显示评论。

- 暂停 []
If 指定，数据库显示之间的超时设置为此数字
秒。 如果不 被指定，行为是显示数据库
仅由 如果在 --timeout 指定的秒数内没有显示
- 这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 给。 例如。 所有 - 暂停 10 - 暂停 只会显示
数据库最多每 10 秒一次。 放一个 超时 10 在您的 〜/.todorc 是一个
不错的选择，然后是 --timeout 在 文档/脚本。* 将意味着数据库
每次 cd 进入目录时都不会显示。

- 清除 []
清除所有已完成的项目 。 如果 省略，全部
完成的记录被清除。

优先事项

可以使用以下词象征性地指定优先级 默认, 很高, 高, 中等,
低 和 非常低.

这个 默认 优先级具有特殊含义，因为它将对任何
行动。 这意味着在编辑现有项目时，其优先级被保留； 什么时候
创建一个新项目，优先级将设置为 中等; 嫁接新物品时，其
优先级将是其父级。 如果是这样，DevTodo 将不会提示优先级
指定，使其成为您的 todorc 的一个方便的功能。 与所有选项一样，优先级
可以在命令行上覆盖。

滤波器

过滤器由用于定义注释的表达式列表组成
显示。

过滤器表达式的一般格式为：

([-|=|+](所有|儿童|完成| | )) | (/ 表达>)

通常，如果过滤器表达式以“-”为前缀，它将 而不去 显示项目
匹配表达式，如果前缀为“+”，它将显示与此匹配的项目
除了其他表达式之外，或者如果前缀为“=”（或根本没有前缀），它将
产品 仅由 那些与表达式匹配的项目。 请注意，这只会搜索项目
没有被其他过滤器排除，所以要搜索整个数据库，你必须这样做
就像是： 所有 - 筛选 全部，/一些搜索字符串.

过滤器表达式的第二种形式用于在数据库中搜索文本。 <搜索
表达> 是与每个项目的文本正文匹配的正则表达式。

过滤器原子按完成状态、优先级、搜索的顺序进行过滤。 所以第一项
与“完成”过滤器不匹配的将被排除，然后那些与“完成”过滤器不匹配的
优先过滤器等。

详细表达：

所有 强制显示所有项目。 各种前缀对此没有影响
表达。

孩子
折叠或展开子项。 如果存在“-”前缀，则孩子是
折叠，否则显示子项。

完成 过滤项目是否完成。


注意索引指定为数字。 范围可以指定为“1.2.10-20”。


优先级按照 优先事项 部分。 '-' 前缀
将显示优先级小于或等于给定优先级的所有项目。
带有“+”前缀的所有项目的优先级大于或等于给定
显示优先级。 如果 '=' 或未给出前缀，则只有具有指定的项
显示优先级。

例子：

待办事项--过滤完成，-儿童，+低

这将仅显示那些已完成且优先级为低或更高的项目。 在
此外，孩子会崩溃。

待办事项 /[Tt]he

只显示那些带有“the”字样的项目，其中第一个字母可以小一些
或大写。 可能需要引用搜索表达式以确保 shell
不解释它们。

格式化

todo 的输出可以通过定义自己的方式更改为更符合您的喜好
格式化字符串。 这些字符串类似于 的printf（3）和 时间（3）。

下面的例子，可以放在 〜/.todorc, 将模仿默认
行为：

# 以默认格式显示
格式显示=%i%[info]%f%2n.%[priority]%T

# 以默认格式显示
生成的格式=%2i-%T%2i (添加 %d，优先级 %p)\n\n

有四个单独的格式选项： 产品, 产生, 详细显示 和 详细-
产生. 后两者用于在 --verbose 时格式化各自的文本
指定为 todo 的参数。

此外，用户可以通过简单地传递不同的格式来创建自己的格式字符串
标识符 格式. 然后可以通过使用启用 --使用格式. 例如。

格式完整报告=%i%[info]%f%2n.%[priority]%+1T%+1i%[info]添加：%[normal]%c
%[info]已完成：%[正常]%d\n%+1i%[info]持续时间：%[正常]%D %[info]优先级：
%[正常]%p\n\n
# 覆盖显示格式以使用“完整报告”。
使用格式显示=完整报告

可用的各种标志是：

% > 这个 > 标志设置空格数 用于所有未来的缩进。

%[+|-][ ]一世
缩进到当前项目的深度。 指定要缩进的深度。 如果 is
省略，使用当前级别。 可以使用相对值。 例如。 '%+1T' 会
缩进比当前缩进级别高一级。

%[+|-][ ]T
显示项目的文本，以 80 个字符换行并缩进到
指定级别。 的语义 和 %i. 请注意，换行的文本
自动在文本末尾添加一个 '0，而 %t 将不会。

%t 项目的未包装、未格式化的文本。

%s 摘要文本（即仅一行，相当于 - 概括).

%p 当前项目的优先级。

%c 当前项目创建日期，根据 --date-format 格式化。

%d 项目被标记为完成的日期，根据 --date-format 格式化。

%D 项目的持续时间，根据 --date-format 格式化。

%[ ]n
当前项目的索引号。 可选数值 指定
数字应占用的字符数。 数字用空格填充
以填充这个字符数。

%f 当前项目的状态标志。 此标志的显示值为“+”
表示孩子，“-”表示完成，“*”表示与孩子一起完成。

%F 当前项目的人类可读状态标志。 为此显示的值
标志是“孩子”，“完成”意味着“完成”，“完成，孩子”和“打开”。

%[ ]
可以使用此标志指定颜色。 的有效值 是：
非常低, 低, 中等, 高, 很高, 标题, info和 优先. 这些是相当
不言自明，除了 优先 更改为当前项目的优先颜色。 例如。
％[优先事项]

请注意，缩进时，您将 一般 想使用'+1'的前缀值
与 %T。 IE。 %+1T。 这会强制文本缩进比当前深一层
级别，使其远离您可能使用过的任何其他格式。

排序

数据库中项目的显示可以按各种键排序。 鉴于一系列
待办事项键对每个连续的键进行排序，仅当前一个键时才继续下一个
比较是平等的。 例如：

待办事项--排序-完成，文本

这将首先按项目是否完成排序，其次按其文本排序。 这个
有效地将项目分为两个块 - 完整的和不完整的。

可用的键是 创建, 完成, 文本, 优先, 为期, 没有 和
完成. 每个键，除了 没有 可以以 - 为前缀来反转其默认顺序和
多个键必须用 , 分隔。

如果遇到多个 --sort 参数，则使用最后一个。 这意味着一个
“排序”条目 〜/.todorc 将被命令行上的 any 覆盖。

指数

索引用作各种命令行参数的选项。 多个音符索引
用逗号分隔（空格是 而不去 允许）。 子项使用“.”来限定范围。

例如，给出以下注释：

1.做手册页
1. 让它们更漂亮。
2. 制作 HTML 文档。

第二个子项将表示如下： 1.2

通配符“*”可用于表示节点的所有子节点。 例如。 1.*

可以使用“ - ”指定音符范围。 例如，要标记注释 10.1.2，
10.1.3 和 10.3.4 完成后，你可以这样做： todo --done 10.1.2-4

镜片颜色

各种物品都可以上色。 可以是的项目 很高, 高, 中等, 低, 非常低,
标题 和 info. info 用于显示项目编号和一般信息。

这些项目可以设置为八种颜色之一。 那些颜色是 黑色, 红色, 墨绿色,
黄色, 蓝色, 品红, 青色, 白色 和 默认. 颜色 默认 用于指定
默认前景终端颜色。

颜色指定如下：

=[+]

如果可选 + 在这个表达式中使用它会导致项目变成粗体。

例如，你的一行 〜/.todorc 可能看起来像：

颜色中等=+白色

这将使 中等 文本 无所畏惧 白色.

托多克

todo 可以从许多资源文件中加载选项。 解析这些的顺序
如下：

1.环境变量中指定的文件 托多克 或者，如果不存在，
/etc/托多克.
2. 〜/.todorc

选项是累积的，因为那些从 $TODORC 加载的将被覆盖或添加到
那些在 〜/ .todorc。

这些选项被指定为键/值对，每行一个。键是一个的长名称
命令行参数，该值是该参数的参数（如果有）。 此外，
环境变量被扩展。

例如， --filter 命令行参数接受作为过滤器的参数
表达。 可以将默认过滤器添加到 〜/.todorc 像这样的文件：

# 默认不显示子项
过滤器-儿童

rc 文件中指定的选项与命令行中指定的选项之间的唯一区别
是 rc 文件中的选项没有以 -- 为前缀。

此外，RC 文件中还有两个命令在 RC 上不可用
命令行。 他们是：

第一个命令， on, 用于有条件地添加特定命令。 这个的格式
命令是： on [ ]. 有效的事件是 加, 去掉, 查看, 编辑,
生成, 完成, 尚未完成, 标题, 父, 加载, 保存, 链接, 创建信息图 和 清除。 多
命令可以传递给 on 通过将它们括在大括号中（之间需要空格
令牌）。 完整示例如下。

第二个命令是 EXEC <外壳 命令>. 此命令将执行它是的参数
在壳中给出。 环境变量 $TODODB 包含当前文件名
数据库。 例如。 EXEC CHMOD 600 $TODODB

在源代码分发的 doc 子目录中有一个示例 rc 文件。

示例

要显示当前目录中任何未完成的项目，只需键入：

所有

删除音符 1、2 和 4：

待办事项 -- 删除 1,2,4

显示所有项目：

待办事项

仅显示顶级项目而不显示其子项：

待办事项 - 儿童

（即使 -儿童 不是一个有效的论点，这是有效的，因为 todo 解释了任何
命令行参数它不能识别为过滤器表达式的一部分）

一个更复杂的例子。 这将添加一个新项目，该项目的文本在
命令行，优先级为 高 作为第二个项目的第三个孩子的孩子（如果
这有任何意义）：

todo -a "修复手册页" -p high -g 2.3

这是如何使用 todo 的 TODO 功能的示例。 它使 todo 生成一个新的
TODO 文件来自存储在数据库中的信息。 这个特定的例子输出所有
项目到 TODO 文件，即使是那些标记为完成的项目。

待办事项 -- 过滤所有 --TODO

这个例子展示了事件触发器的一个很好的用法。 当一个新的数据库被创建时
将强制其权限为 0600。

在创建{
详细
执行 chmod 600 .todo
}

使用 onworks.net 服务在线使用 tdd