mirrors/git-annex
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages 1 Wiki Activity Actions

update docs more

Browse source
This commit is contained in:
Joey Hess 2013-01-06 17:22:02 -04:00
parent f12202f771
commit 0b665658b6
1 changed files with 9 additions and 23 deletions
Download patch file Download diff file Expand all files Collapse all files

32
doc/direct_mode.mdwn
View file

@ -34,33 +34,19 @@ any time). To do so:
## use a direct mode repository ## use a direct mode repository
Perhaps the best way to use a direct mode repository is with the git-annex You can use most git-annex commands as usual in a direct mode repository.
assistant. A few commands don't work in direct mode, and will refuse to do anything.
Otherwise, the main command that's used in direct mode repositories is Direct mode also works well with the git-annex assistant.
`git annex sync`. This automatically adds new files, commits all
changed files to git, pushes them out, pulls down any changes, etc.
`git annex add` and some other commands are not yet supported in direct You can use `git commit --staged`. But not `git commit -a` .. It'll
mode repositories. Feel free to try any git annex command though; ones that commit whole large files into git!
don't support direct mode will refuse to do anything.
You can use `git commit --staged`. (But not `git commit -a` .. It'll commit
whole large files into git!)
You can use `git log` and other git query commands.
## what doesn't work in direct mode ## what doesn't work in direct mode
In general git-annex commands will only work in direct mode repositories on `git annex status` show incomplete information. A few other commands,
files whose content is not present. That's because such files are still like `git annex unlock` don't make sense in direct mode and will refuse to
represented as symlinks, which git-annex commands know how to operate on. run.
So, `git annex get` works, but `git annex drop` and `git annex move` don't,
and things like `git annex status` show incomplete information.
It's technically possible to make all git-annex commands work in direct
mode repositories, so this might change. Check back to this page to see
current status about what works and what doesn't.
As for git commands, you can probably use some git working tree As for git commands, you can probably use some git working tree
manipulation commands, like `git checkout` and `git revert` in useful manipulation commands, like `git checkout` and `git revert` in useful
@ -70,4 +56,4 @@ had of something, it'll be lost.
This is one reason it's wise to make git-annex untrust your direct mode This is one reason it's wise to make git-annex untrust your direct mode
repositories. Still, you can lose data using these sort of git commands, so repositories. Still, you can lose data using these sort of git commands, so
use extreme caution. use extreme caution.