本文档旨在描述 Apache™ Subversion® 的 1.7.x 系列。如果您运行的是其他版本的 Subversion,强烈建议您访问 https://svnbook.subversion.org.cn/ 并查阅适合您 Subversion 版本的文档。

Subversion 属性

Subversion 允许用户在文件和目录上创建任意命名的版本化属性,以及在修订版上创建非版本化属性。唯一的限制是属性名称以 svn: 开头的属性(这些属性保留供 Subversion 自用)。虽然用户可以设置这些属性来控制 Subversion 的行为,但用户不能创建新的 svn: 属性。

版本化属性

以下是 Subversion 为自身保留的版本化属性

svn:executable

如果在文件上存在,客户端将在 Unix 主机工作副本中使文件可执行。请参阅 名为“文件可执行性”的部分

svn:mime-type

如果在文件上存在,该值表示文件的 MIME 类型。这允许客户端决定在更新期间是否可以安全地执行基于行的上下文合并,并且还可以影响通过 Web 浏览器获取文件时的行为。请参阅 名为“文件内容类型”的部分

svn:ignore

如果在目录上存在,该值是一个 非版本化 文件模式列表,这些模式将被 svn status 和其他子命令忽略。请参阅 名为“忽略非版本化项”的部分

svn:keywords

如果在文件上存在,该值告诉客户端如何在文件中扩展特定关键字。请参阅 名为“关键字替换”的部分

svn:eol-style

如果文件存在,该值告诉客户端如何在工作副本和导出树中操作文件的行尾。参见名为“行尾字符序列”的部分和本章前面介绍的svn export

svn:externals

如果目录存在,该值是客户端应检出的其他路径和 URL 的多行列表。参见名为“外部定义”的部分

svn:special

如果文件存在,则表示该文件不是普通文件,而是符号链接或其他特殊对象。[73]

svn:needs-lock

如果文件存在,则告诉客户端在工作副本中将文件设为只读,以提醒用户在开始编辑之前应锁定文件。参见名为“锁定通信”的部分

svn:mergeinfo

Subversion 使用它来跟踪合并数据。参见名为“Mergeinfo 和预览”的部分以获取详细信息,但除非你确实知道自己在做什么,否则不要编辑此属性。

未版本化属性

这些是 Subversion 为自身使用而保留的未版本化属性

svn:author

如果存在,则包含创建修订的用户的已验证用户名。(如果不存在,则该修订是匿名提交的。)

svn:autoversioned

如果存在,则该修订是通过自动版本控制功能创建的。参见名为“自动版本控制”的部分

svn:date

包含创建修订的 UTC 时间,采用 ISO 8601 格式。该值来自服务器机器的时钟,而不是客户端的时钟。

svn:log

包含描述修订的日志消息。

svn:rdump-lock

用于通过svnrdump load临时强制对存储库进行互斥访问。此属性通常仅在执行此类操作时才会观察到,或者当svnrdump命令未能干净地断开与存储库的连接时。(此属性仅在修订版 0 上出现时才相关。)

svn:sync-currently-copying

包含从源代码库中镜像到此代码库的修订版本号,该代码库当前正在使用 svnsync 工具镜像。(此属性仅在修订版本 0 上出现时才相关。)

svn:sync-from-uuid

包含代码库的 UUID,该代码库已使用 svnsync 工具初始化为此代码库的镜像。(此属性仅在修订版本 0 上出现时才相关。)

svn:sync-from-url

包含代码库目录的 URL,该代码库目录已使用 svnsync 工具初始化为此代码库的镜像。(此属性仅在修订版本 0 上出现时才相关。)

svn:sync-last-merged-rev

包含最近成功镜像到此代码库的源代码库的修订版本。(此属性仅在修订版本 0 上出现时才相关。)

svn:sync-lock

用于通过 svnsync 镜像操作暂时强制对代码库进行互斥访问。此属性通常仅在该操作处于活动状态时才会被观察到,或者当 svnsync 命令未能从代码库干净地断开连接时。(此属性仅在修订版本 0 上出现时才相关。)



[73] 截至目前,符号链接确实是唯一的 特殊 对象。但在 Subversion 的未来版本中可能会有更多。

TortoiseSVN 官方中文版 1.14.7 发布