vcsh - 家庭目录下的版本控制系统

vcsh 是一款允许你在 $HOME 目录下维护多个 Git 仓库的工具。它们各自维护自己的工作树，不会相互干扰。默认情况下，所有通过 vcsh 维护的 Git 仓库将文件存储在 $HOME 目录下，但你可以根据需要覆盖这个设置。

以下是对 vcsh 的详细技术文档，包括安装指南、使用说明以及 API 使用文档。

安装指南

在许多现代的基于 UNIX 的系统中，vcsh 提供了软件包。如果你的系统中没有，可以阅读 [INSTALL.md](doc/INSTALL.md) 来获取从源代码安装或者为你的系统创建软件包的指导。如果你最终打包了 vcsh，请告诉我们，以便我们可以记录软件包的可用性。

项目的使用说明

快速入门

尽管 vcsh 的文档可能看起来很复杂，但实际使用起来非常简单。假设你想对 vim 配置进行版本控制：

vcsh init vim
vcsh vim add ~/.vimrc ~/.vim
vcsh vim commit -m '初始提交我的 Vim 配置'
# 可选地，将你的文件推送到远程仓库
vcsh vim remote add origin <远程仓库地址>
vcsh vim push -u origin master
# 之后你可以像这样推送额外的提交
vcsh vim push

如果这些看起来和标准的 git 命令很相似，那并非巧合；这正是设计的一部分。

详细说明

vcsh 允许你为每个应用程序或应用程序家族维护一个仓库，例如 zsh、vim、ssh 等。这意味着你可以将自定义的配置集合克隆到不同的机器上，甚至为不同的用户克隆不同的配置；选择和混合你在哪里使用哪些配置。例如，你可能不需要在服务器上或有 root 权限的机器上配置 mplayer，你可能还想为个人和工作机器维护不同的 ssh 配置。

项目 API 使用文档

vcsh 的 API 设计与标准 git 命令类似，使得对仓库的操作直观且简单。具体的 API 文档可以在项目的 [详细文档](doc/README.md) 中找到。

项目安装方式

以下是 vcsh 的几种安装方式：

1. 使用系统软件包管理器安装（如果可用）。
2. 从源代码安装，可以参考 [INSTALL.md](doc/INSTALL.md)。
3. 如果你熟悉打包过程，可以为你的系统创建软件包。

请确保在安装前查看你的系统是否支持 vcsh，并遵循相应的安装指南。