选项值是由逗号分隔的列表, 列表指出了当 Subversion 存放 和检索缓存的认证证书时, 应该使用操作系统提供的哪些方法, 以及 这些方法的优先级. 默认值是 gnome-keyring, kwallet, keychain, gpg-agent, windows-crypto-api, 分别表示 GNOME Keyring, KDE Wallet, Mac OS Keychain, GnuPG Agent 和 Microsoft Windows 密码 API. 如果列表中出现了操作系统不支持 的方法, 该方法将被忽略.

该选项已经被 config 弃用, 它现在 在文件 servers 内, 作为一个每服务器配置项, 见 “每服务器配置”一节.

该选项已经被 config 弃用, 它现在 在文件 servers 内, 作为一个每服务器配置项, 见 “每服务器配置”一节.

指定差异比较工具的绝对路径, Subversion 在生成 “差异” 输出时 (例如执行命令 svn diff) 将会用到该工具. 默认情况下, Subversion 使用的是自己内部的差异比较库函数来生成差异输出—设置该 选项将导致 Subversion 转而使用外部差异比较工具. 关于如何使用 外部差异比较工具的更多信息, 见 “使用外部差异比较与合并工具”一节.

就像命令行选项 --extensions (-x), 该选项向差异比较引擎 (内部的或外部的) 传递额外的参数. 选项的有效值与 Subversion 所使用的差异比较 引擎有关, 更多的细节见 svn help diff 的输出. 该选项的默认值是 -u.

该选项指定三路差异比较工具的绝对路径. 当工作副本从服务器 接收更新时, Subversion 将使用该工具把服务器上的更新合并到本地. 默认情况下 Subversion 使用的是自己内部的差异比较库函数来合并 更新—设置该选项将导致 Subversion 转而使用外部工具来完成 合并. 关于如何使用三路差异比较工具的更多信息, 见 “使用外部差异比较与合并工具”一节.

如果由选项 diff3-cmd 指定的程序支持 命令行参数 --diff-program, 那么就应该把 diff3-has-program-arg 设置成 true.

指定文本编辑器程序. 当 Subversion 向用户请求输入文本, 或者交互式地解决冲突时将会用到该程序. 关于 Subversion 使用 外部编辑器的更多信息, 见 “使用外部编辑器”一节.

指定一个合并工具, 用于 Subversion 执行三路合并操作. 关于这种工具的更多信息, 见 “使用外部差异比较与合并工具”一节.

指示 Subversion 为新增和导入的文件自动设置属性. 选项的默认 值是 no, 将其设置成 yes 将开启自动属性设置. 配置文件内的 [auto-props] 节用于指定哪些文件应该设置什么 样的属性.

执行命令 svn status 时, 除了被版本控制 的文件外, Subversion 同时还会列出未被版本控制的文件, 但是这些 文件的名字前会出现一个 ? 字符 (见 “查看修改的整体概述”一节). 列出这些未被版本 控制的项目有时候会让人感到讨厌—例如编译过程中生成的目标 文件就没必要列出来. 选项 global-ignores 包含 了由空白字符分隔的文本表达式列表, 如果某个文件的名字与这些表达式 中的一个或多个相匹配, svn status 就不会显示 这个文件名, 除非它是被版本控制的文件. 选项的默认值是 *.o *.lo *.la *.al .libs *.so *.so.[0-9]* *.a *.pyc *.pyo *.rej *~ #*# .#* .*.swp .DS_Store.

和 svn status 一样, 命令 svn add 和 svn import 也会忽略与 global-ignores 匹配的文件. 为了显式地表示 不想忽略某个文件, 可以在执行这三个命令时, 显式地指定文件名, 或使用命令行参数 --no-ignore.

关于如何更加精细地忽略文件, 见 “忽略未被版本控制的项”一节.

指示 Subversion 是否应该尝试交互地解决冲突. 如果它的值是 yes (默认值), 在冲突发生时, Subversion 将按照 “解决冲突”一节 介绍的方式, 询问用户如何处理冲突; 否则的话, Subversion 只会给文件设置冲突 标记, 然后继续往下操作, 从而推迟解决冲突.

该选项用于设置日志消息的默认字符编码, 它是命令行参数 --encoding (见 svn 选项) 的等效选项. Subversion 仓库 使用 UTF-8 编码存放日志消息, 并且假设用户使用的是操作系统 的默认编码来编写日志消息, 如果你不是用的操作系统的默认编码 来编写日志消息的话, 那你就应该把字符编码的名字写到 log-encoding 里.

该选项在 Subversion 1.5 引入, 用于指定一个 MIME 类型映射 文件, 例如由 Apache HTTP 服务器提供的 mime.types. Subversion 使用 MIME 类型映射 文件为新增或导入的文件设置 MIME 类型. 关于 Subversion 如何 检测和使用文件内容类型的更多信息, 见 “自动属性设置”一节 和 “文件内容类型”一节.

这个选项和 svn commit 命令行选项 --no-unlock 相对应, 命令行选项 --no-unlock 告诉 Subversion 在提交修改后不 要释放文件上的锁. 如果把 no-unlock 设置 成 yes, Subversion 就不会自动释放锁, 为 了解锁, 用户必须显式地执行 svn unlock. 默认值是 no.

选项的值是由空格分隔的文件扩展名列表, 当 Subversion 生成 冲突文件名时必须保留这些扩展名. 该选项在 Subversion 1.5 引入, 默认值为空.

当 Subversion 检测到有冲突发生时, 会把冲突的解决交由用户 处理. 为了帮助解决冲突, Subversion 把互相冲突的两个版本的文件 保存到工作副本里, 默认情况下, 这些文件的名字是原来的文件名 再加上一个特定的扩展名, 例如 .mine 或 .REV (REV 表示一个版本号). 这种命名方式 可能产生的一个问题是在某些操作系统上, 文件扩展名决定了用于打开 它的默认应用程序, 为文件名添加一个特定的扩展名可能会导致无法 使用正确的应用程序轻易地打开文件. 比如说文件 ReleaseNotes.pdf 有冲突发生, 冲突文件可 能被命名成 ReleaseNotes.pdf.mine 和 ReleaseNotes.pdf.r4231, 操作系统使用 Adobe Acrobat Reader 打开扩展名为 .pdf 的文件, 但是很可能没有默认程序能够打开扩展名为 .r4231 的文件.

配置选项 preserved-conflict-file-exts 可以帮助用户解决这一问题. 对于扩展名和选项相匹配的文件, Subversion 像往常一样在冲突文件的名字末尾加上特定的扩展名后, 会再次添加文件原来的扩展名. 对于前面的例子, 假设 preserved-conflict-file-exts 的值含有 pdf, 那么为 ReleaseNotes.pdf 所生成的冲突文件将 被命名成 ReleaseNotes.pdf.mine.pdf 和 ReleaseNotes.pdf.r4231.pdf. 因为冲突文件 的扩展名仍然是 .pdf, 因此在打开它们时 会用到正确的默认应用程序.

通常情况下, 工作副本里的文件包含了能够反映文件最后一次是 在什么时候被进程—例如文本编辑器或 svn 命令—修改了的时间戳. 这个时间戳对于软件开发非常有用, 因 为软件构建系统通过查看时间戳来决定是否需要重新编译某个文件.

然而在其他场景下, 如果这个时间戳反映的是工作副本里的文件 最后一次在仓库里被修改的时间—这在某些情况下会非常方便. 命令 svn export 总是把它所生成的目录树的时间 戳设置成 “最后一次提交的时间”. 如果把 use-commit-times 设置成 yes, 那么命令 svn checkout, svn update, svn switch 和 svn revert 也会把它们所修改的文件的时间戳设置成最后一次提交的时间.

开启工作副本的 SQLite 互斥锁, 它可用于提升位于网络磁盘上 的工作副本的性能. 如果把该选项设置成 svn, Subversion 命令行客户端将使用互斥锁, 这会降低加锁的开销, 但 并不是说同一时刻只能允许一个客户端访问工作副本, 如果工作副本 已经被锁定了, 那么试图访问工作副本的其他客户端会阻塞 10 秒钟, 然后返回一个错误. 在大多数情况下, 人们更喜欢用共享锁, 但是如果 工作副本是在网络磁盘 (而不是本地磁盘) 上, 那么锁的开销就更值得 关注. 对于放在网络磁盘上的大型工作副本, 使用互斥锁会得到很大的 性能提升, 在某些情况下甚至能达到两三倍的提升. 该选项在 Subversion 1.8 引入.

如果把该选项设置成 true, 将为所有 Subversion 1.8 客户端开启工作副本的互斥锁, 而某些客户端可能 会无法正常工作. 选项的默认值是 false, 在 Subversion 1.8 引入.

选项包含了客户端支持的 HTTP 认证类型, 类型之间用分号分开. 有效的认证类型包括 basic, digest 和 negotiate, 默认行为是允许所有的认证类型. 举个例子, 如果客户端要求不能以 明文方式传输认证证书, 可以把该选项设置成 digest;negotiate—忽略 basic 类型. (注意, 这种设置只对基于 Neon 的 HTTP 模块才有效.)

指定是否对发往 DAV 已就绪的服务器的网络数据进行压缩, 默认值是 yes (但只有在网络层支持压缩的 情况下才会真正对数据进行压缩). 把选项设置成 no 将禁止压缩, 例如当我们需要对网络传输 进行调试时.

该选项允许用户指定他们更愿意使用哪种 WebDAV 访问模块 (通常是每服务器配置). 在 1.8 版之前, Subversion 提供了两种 WebDAV 访问模块: 较老的 libsvn_ra_neon (对应的选项值是 neon) 和较新的 libsvn_ra_serf (对应的选项值是 serf). 从 1.8 开始, 虽然 Subversion 只支持 libsvn_ra_serf, 但这个配置选项还是保留了 下来, 因为运行时配置区域无法知晓 Subversion 的版本. 如果用户 的系统中安装了多种 Subversion 版本, 在使用旧版客户端访问服务 器时, 他们可能仍然希望为 http-library 设置上 libsvn_ra_neon.

选项值是由逗号分隔的列表, 列表的元素是仓库服务器的主机 名模式, 符合模式的服务器将不会使用代理, 而是直接访问. 模式 的写法和 Unix Shell 的文件名模式写法相同.

指定基于 HTTP 的 Subversion 请求必须经过的代理服务器的 主机名. 默认值是空, 这意味着 Subversion 不会尝试把 HTTP 请 求路由给代理服务器, 而是直接发给目标服务器.

指定提供给代理服务器的密码, 默认值是空.

指定代理服务器的端口号, 默认值是空.

指定提供给代理服务器的用户名, 默认值是空.

指定服务器响应的等待时间, 以秒为单位. 如果用户发现低速 的网络常常导致 Subversion 命令超时, 那你应该把 http-timeout 调大. Subversion 1.8 (或更 老的, 基于 Serf 的版本) 用 0 表示不设置 超时.

选项值是一个整数掩码, Neon HTTP 库函数将根据这个掩码来 决定打印哪些调试信息, 默认值是 0, 这会 禁止打印所有的调试信息. 在 1.8 之前的版本, 大多数 Subversion 客户端都使用 Neon (借助 libsvn_ra_neon 仓库访问模块) 完成客户端和服务器之间的 WebDAV/HTTP 通信. 但从 Subversion 1.8 开始不再支持 libsvn_ra_neon, 所以这个选项在新版 Subversion 里被淘汰了.

选项值是分号分隔的路径列表, 其中每个路径都指向一个文件, 该文件包含了认证机构的证书, 当 Subversion 客户端使用 HTTPS 访问仓库时将信任这些证书.

如果一个主机 (或多个主机) 要求提供一个 SSL 客户端证书, 用户通常会收到一个要求输入证书路径的提示信息. 把该选项设置 成证书的路径, Subversion 就可以自动搜索到证书, 而不会再提示 用户输入证书路径. 并不存在一个存在证书的标准位置, Subversion 会从用户指定的任意位置读取证书.

如果用户的 SSL 客户端证书被一个密码加密, 每当 Subversion 使用证书都会提示用户输入密码. 如果你觉得这有点烦人, 而且你也 不介意把密码写到 servers 文件里, 那就 把该选项设置成证书的密码, 这样你就不会再收到要求输入证书密码的 提示.

选项值是 PKCS#11 提供商的名字, 它刻画了 SSL 客户端的证书 (如果服务器要求提供证书的话). 这个设置只对 Subversion 基于 Neon 的 HTTP 模块才有效, 而这种模块在 Subversion 1.8 中已经被移除了.

如果用户希望 Subversion 自动信任 OpenSSL 附带的默认证书 的话, 就把它设置成 yes.

该选项基于上和 store-passwords 相同, 唯一的不同点是它用于开启或禁止 所有的 认证信息缓存, 包括用户名, 密码, 服务器证书, 以及其他能被缓存 的凭证.

指定 Subversion 是否应该缓存用户密码, 这个密码是服务器 要求认证时用户输入的. 默认值是 yes, 如果 设置成 no 将禁止缓存密码. 用户可以使用 svn 的命令行选项 --no-auth-cache 覆盖掉 store-passwords 的设置 (当然, 这种覆盖只 对支持 --no-auth-cache 的子命令才有意义). 关于密码缓存的更多信息, 见 “缓存证书”一节. 注意, 无论是否设置 store-passwords, Subversion 都不会以明文方式存放密码, 除非 store-plaintext-passwords 被设置成 yes.

该选项只在类 Unix 系统上才需要注意. 如果密码只能以明文方式 缓存在磁盘上 (具体的位置是 ~/.subversion/auth/), 此时 Subversion 将 根据该选项决定接下来该怎么做. 如果把它设置成 yes 或 no, 将分别允许 或禁止以明文方式缓存密码. 默认值是 ask, 于是 Subversion 每当遇到一个 新的 密码时, 都会询问用户是否以明文方式把它缓存到 ~/.subversion/auth/.

该选项用于设置 Subversion 是否应该缓存用户输入的 SSL 客户端证书密码, 默认值是 yes, 设置成 no 将禁止缓存.

当 Subversion 尝试缓存 SSL 客户端证书密码时, 该选项用于 控制是否允许以明文方式存放到磁盘上. 默认值是 ask, 使得 Subversion 每次遇到一个 新的 SSL 客户端证书密码时都会向用户询问 是否以明文方式缓存到 ~/.subversion/auth/, 把选项设置成 yes 或 no 将允许或禁止明文缓存, Subversion 也不会再询问用户.