README: mention that the idea came from John Whitley
[config/vcsh.git] / README
1 vcsh configuration to handle collisions of files common to distinct vcsh
2 repositories using the sparse-checkout functionality of git.
3
4 Based on John Whitley's setup at https://github.com/jwhitley/vcsh-root
5
6 The patterns for the colliding files are in .config/vcsh/sparse-checkout and
7 a pre-upgrade hook is used to make vcsh repositories use it.
8
9 Many git commands (e.g. git-merge, git-checkout) will automatically use the
10 information in $GIT_DIR/info/sparse-checkout when dealing with files in the
11 git work directory, so generally a calling git-read-tree explicitly is not
12 needed.
13
14 However when the content of $GIT_DIR/info/sparse-checkout changes it is
15 necessary to call "git read-tree -mu HEAD" to update the content of the
16 working directory.