FreeBSD 文档的源代码和安装版本都可以通过 CVSup 来以与基本系统 (参考 第 25.7 节 “重新编译 “world””) 类似的方法来升级。 这一节中将会介绍：

从源代码联编 FreeBSD 文档需要大量的工具。 这些工具并不是 FreeBSD 基本系统的一部分， 因为这些工具需要占用大量的磁盘空间， 而且并不是对所有 FreeBSD 用户都有用； 只有活跃地撰写 FreeBSD 新文档， 或经常从源代码更新文档的用户才需要这些工具。

全部所需的工具， 均可通过 Ports 套件来安装。 textproc/docproj port 是由 FreeBSD 文档计划开发的方便安装和更新这些工具的主 port。

如欲了解关于安装和使用 CVSup 的进一步信息， 请参阅 使用 CVSup。

CVSup 工具能够下载文档源代码的原始副本， 您可使用 /usr/share/examples/cvsup/doc-supfile 文件作为配置模板来修改。 在 doc-supfile 中的默认主机名是一个无效的占位主机名， 但 cvsup(1) 能够通过命令行来指定主机名， 因此文档源代码可以使用下面的命令从 CVSup 服务器获得：

您应将 cvsup.FreeBSD.org 改为最近的 CVSup 服务器。 参见 第 A.6.7 节 “CVSup 站点” 关于镜像站点的完整列表。

初始的文档源代码下载需要一些时间， 您需要耐心等待它完成。

后续的更新可以用同样的命令来进行。 由于 CVSup 工具只下载上次运行之后所发生过的更新， 因此在首次运行之后再运行 CVSup 应该是很快的。

在签出源代码之后， 还可以使用另一种由 /usr/doc 目录中的 Makefile 支持的方法来更新它。 通过在 /etc/make.conf 中配置 SUP_UPDATE、 SUPHOST 和 DOCSUPFILE， 可以通过运行：

来完成更新。 典型的 /etc/make.conf 中的 make(1) 选项是：

FreeBSD 文档的更新和联编系统支持一些方便只更新一部分文档， 或只联编特定格式及译文的选项。 这些选项可以在 /etc/make.conf 文件中配置， 也可以通过 make(1) 工具来指定。

这些选项包括：

如欲了解 FreeBSD 中其他可供配置的全局 make 变量， 请参阅 make.conf(5)。

关于 FreeBSD 文档联编系统的其他详情， 请参阅 FreeBSD 文档计划入门之新手必读部分。

在 /usr/doc 中下载了最新的文档源代码快照之后， 就可以开始动手联编文档了。

要更新全部 DOC_LANG 中定义的语言的文档， 需要执行下面的命令：

如果在 make.conf 中配置了正确的 DOCSUPFILE、 SUPHOST 和 SUP_UPDATE 选项， 则可以将更新源代码和安装一步完成：

如果只需要更新某个特定语言的文档， 可以在 /usr/doc 中与之对应的目录中运行 make(1)：

此外， 还可以透过 make 变量 FORMATS 来控制输出格式， 例如：

在之前的章节中， 我们已展示了从源代码更新 FreeBSD 文档的方法。 基于源代码的更新的方法可能并不是对于所有的 FreeBSD 系统都可行有效。 编译文档源代码需要一大堆的工具， 文档工具链， 对于 CVS 的一定了解和从仓库中检出源代码， 还有一些编译已检出代码的手工步骤。 这一章节我们将介绍一种使用 Ports 来更新已安装的 FreeBSD 文档：

这两种更新 FreeBSD 文档的方法都由一组 文档工程组 <doceng@FreeBSD.org> 每月更新的 文档 ports 提供支持。 这些都列在了 FreeBSD Ports docs 虚拟分类下面。