list (ls): 列出版本库目录条目。

用法:

list [TARGET[@REV]...]

列出版本库中存在的每个 TARGET 文件和每个 TARGET 目录的内容。如果 TARGET 是一个工作副本路径项,则使用与其对应的版本库 URL。如果指定了 REV 参数,则它将决定首先搜索目标的哪个版本。

默认的 TARGET 是 “.”,意思是当前工作目录的版本库 URL

可以指定多个 --search 模板, 输出将只包含那些最后一个段(即文件或目录名称)至少与这些模板之一相匹配的路径。

使用 --verbose 参数,对每个项目,还会显示以下区段:

有效选项:  
-r [--revision] ARG : 指定版本 ARG (一些命令也接受 ARG1:ARG2 格式的版本范围),版本参数可以是如下之一:
  • NUMBER 版本号
  • '{' DATE '}' 在指定时间以后的版本
  • 'HEAD' 版本库中的最新版本
  • 'BASE' 工作副本的基准版本
  • 'COMMITTED' 最后提交的版本或基准版本之前的版本
  • 'PREV' 最后提交版本 COMMITTED 的前一版本
-v [--verbose] : 输出额外信息
-R [--recursive] : 向下递归输出各级路径项,与 --depth=infinity 相同
-H [--human-readable] : --verbose 一起使用,文件大小显示以 2 为基单位后缀(字节、KB、MB、GB、TB、PB),数字个数不超过三位
--depth ARG : 限制输出深度为 ARG (empty, files, immediates, 或 infinity)
--incremental : 使用便于合并输出结果的方式进行输出
--xml : 输出为 XML 结果
--include-externals : 也输出外部定义(由 svn:externals 属性指定)
--search ARG : 使用 ARG 作为搜索模版 (Glob 语法,大小写和重音敏感,可能需要引号防止 shell 展开)