git-annex/doc/walkthrough/adding_files.mdwn

	$ cd ~/annex
	$ cp /tmp/big_file .
	$ cp /tmp/debian.iso .
	$ git annex add .
	add big_file (checksum...) ok
	add debian.iso (checksum...) ok
	$ git commit -a -m added

When you add a file to the annex and commit it, only a symlink to
the content is committed to git. The content itself is stored in
`.git/annex/objects/`
this is not all run as root 2019-03-27 15:15:03 +00:00			`$ cd ~/annex`
			`$ cp /tmp/big_file .`
			`$ cp /tmp/debian.iso .`
			`$ git annex add .`
use SHA256 by default To get old behavior, add a .gitattributes containing: * annex.backend=WORM I feel that SHA256 is a better default for most people, as long as their systems are fast enough that checksumming their files isn't a problem. git-annex should default to preserving the integrity of data as well as git does. Checksum backends also work better with editing files via unlock/lock. I considered just using SHA1, but since that hash is believed to be somewhat near to being broken, and git-annex deals with large files which would be a perfect exploit medium, I decided to go to a SHA-2 hash. SHA512 is annoyingly long when displayed, and git-annex displays it in a few places (and notably it is shown in ls -l), so I picked the shorter hash. Considered SHA224 as it's even shorter, but feel it's a bit weird. I expect git-annex will use SHA-3 at some point in the future, but probably not soon! Note that systems without a sha256sum (or sha256) program will fall back to defaulting to SHA1. 2011-11-04 19:21:45 +00:00			`add big_file (checksum...) ok`
			`add debian.iso (checksum...) ok`
this is not all run as root 2019-03-27 15:15:03 +00:00			`$ git commit -a -m added`
split the walkthrough and inline back together 2011-02-27 16:45:48 +00:00
			`When you add a file to the annex and commit it, only a symlink to`
tweak wording 2014-02-10 15:59:23 +00:00			`the content is committed to git. The content itself is stored in`
Automatically convert direct mode repositories to v7 with adjusted unlocked branches * Automatically convert direct mode repositories to v7 with adjusted unlocked branches and set annex.thin. * init: When run on a crippled filesystem with --version=5, will error out, since version 7 is needed for adjusted unlocked branch. * direct: This command always errors out as direct mode is no longer supported. * indirect: This command has become a deprecated noop. * proxy: This command is deprecated because it was only needed in direct mode. (But it continues to work.) Also removed mentions of direct mode throughough the documentation. I have not removed all the direct mode code yet. 2019-08-26 18:52:55 +00:00			`.git/annex/objects/`