From a1895de118a183e9c91333cea499856954620355 Mon Sep 17 00:00:00 2001 From: Joey Hess Date: Fri, 23 Aug 2013 13:55:18 -0400 Subject: [PATCH] mention git annex sync since people seem to be confused about how to sync direct mode repositories --- doc/direct_mode.mdwn | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/doc/direct_mode.mdwn b/doc/direct_mode.mdwn index b0e9a0adb5..a6a2003a79 100644 --- a/doc/direct_mode.mdwn +++ b/doc/direct_mode.mdwn @@ -56,7 +56,15 @@ A very few commands don't work in direct mode, and will refuse to do anything. Direct mode also works well with the git-annex assistant. -You can use `git commit --staged`, or plain `git commit`. +The most important command to use in a direct mode repository is `git annex +sync`. This will commit any files you have run `git annex add` on, as well +as files that were added earlier and have been modified. It will push +the changes to other repositories for `git annex sync` there to pick up, +and will pull and merge any changes made on other repositories into the +local repository. + +While you generally will just use `git annex sync`, if you want to, +you can use `git commit --staged`, or plain `git commit`. But not `git commit -a`, or `git commit ` .. that'd commit whole large files into git!