本文档旨在描述 Subversion 1.6.x 系列。如果您运行的是其他版本的 Subversion,强烈建议您访问 https://svnbook.subversion.org.cn/,并参考与您的 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
如果该属性存在于文件上,则表示该文件不是普通文件,而是符号链接或其他特殊对象。[63]
svn:needs-lock
如果该属性存在于文件上,则告诉客户端在工作副本中将该文件设为只读,以提醒用户在开始编辑之前应该锁定该文件。请参阅 名为“锁定通信”的部分。
svn:mergeinfo
由 Subversion 用于跟踪合并数据。请参阅 名为“合并信息和预览”的部分 获取详细信息,但除非您 确实 了解自己在做什么,否则不要编辑此属性。
以下是 Subversion 为自身使用而保留的非版本化属性
svn:author
如果存在,则包含创建修订版的经过身份验证的用户名。(如果不存在,则修订版是匿名提交的。)
svn:autoversioned
如果存在,则修订版是通过自动版本控制功能创建的。请参阅 名为“自动版本控制”的部分。
svn:date
包含创建修订版的 UTC 时间,采用 ISO 8601 格式。该值来自 服务器 机器的时钟,而不是客户端的时钟。
svn:log
包含描述修订版的日志消息。
svn:sync-currently-copying
包含正在由 svnsync 工具镜像到此存储库的源存储库中的修订版号。(此属性仅在它出现在修订版 0 上时才相关。)
svn:sync-from-uuid
包含已由 svnsync 工具初始化为镜像的存储库的 UUID。(此属性仅在它出现在修订版 0 上时才相关。)
svn:sync-from-url
包含已由 svnsync 工具初始化为镜像的存储库目录的 URL。(此属性仅在它出现在修订版 0 上时才相关。)
svn:sync-last-merged-rev
包含最近成功镜像到此存储库的源存储库的修订版。(此属性仅在它出现在修订版 0 上时才相关。)
svn:sync-lock
用于通过 svnsync 镜像操作暂时强制对存储库的互斥访问。此属性通常仅在该操作处于活动状态时观察到,或者当 svnsync 命令未能干净地断开与存储库的连接时观察到。(此属性仅在它出现在修订版 0 上时才相关。)