2010-10-19 18:37:19 +00:00
|
|
|
git-annex allows managing files with git, without checking the file
|
|
|
|
|
contents into git. While that may seem paradoxical, it is useful when
|
|
|
|
|
dealing with files larger than git can currently easily handle, whether due
|
|
|
|
|
to limitations in memory, checksumming time, or disk space.
|
|
|
|
|
|
|
|
|
|
Even without file content tracking, being able to manage files with git,
|
|
|
|
|
move files around and delete files with versioned directory trees, and use
|
|
|
|
|
branches and distributed clones, are all very handy reasons to use git. And
|
|
|
|
|
annexed files can co-exist in the same git repository with regularly
|
|
|
|
|
versioned files, which is convenient for maintaining documents, Makefiles,
|
|
|
|
|
etc that are associated with annexed files but that benefit from full
|
|
|
|
|
revision control.
|
|
|
|
|
|
2010-10-20 00:07:50 +00:00
|
|
|
To get a feel for it, see the [[walkthrough]].
|
|
|
|
|
|
2010-10-19 23:28:29 +00:00
|
|
|
[[!sidebar content="""
|
2010-11-14 01:37:47 +00:00
|
|
|
[[!img logo_small.png link=no]]
|
2010-11-14 01:29:30 +00:00
|
|
|
|
2010-10-19 18:37:19 +00:00
|
|
|
* **[[download]]**
|
2010-10-19 20:32:40 +00:00
|
|
|
* [[install]]
|
2010-10-19 18:37:19 +00:00
|
|
|
* [[news]]
|
|
|
|
|
* [[bugs]]
|
2010-10-25 15:47:45 +00:00
|
|
|
* [[todo]]
|
2010-11-14 18:08:20 +00:00
|
|
|
* [[forum]]
|
2010-10-19 18:37:19 +00:00
|
|
|
* [[contact]]
|
2010-10-19 23:28:29 +00:00
|
|
|
"""]]
|
|
|
|
|
|
|
|
|
|
## sample use cases
|
|
|
|
|
|
|
|
|
|
<table>
|
|
|
|
|
<tr>
|
|
|
|
|
<td>[[!inline feeds=no template=bare pages=use_case/bob]]</td>
|
|
|
|
|
<td>[[!inline feeds=no template=bare pages=use_case/alice]]</td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
|
|
|
|
|
If that describes you, or if you're some from column A and some from column
|
|
|
|
|
B, then git-annex may be the tool you've been looking for to expand from
|
|
|
|
|
keeping all your small important files in git, to managing your large
|
|
|
|
|
files with git.
|
2010-10-19 18:37:19 +00:00
|
|
|
|
2010-10-19 19:59:40 +00:00
|
|
|
## documentation
|
|
|
|
|
|
2010-10-19 20:07:33 +00:00
|
|
|
* [[git-annex man page|git-annex]]
|
2010-10-19 19:59:40 +00:00
|
|
|
* [[key-value backends|backends]] for data storage
|
|
|
|
|
* [[location_tracking]] reminds you where git-annex has seen files
|
|
|
|
|
* git-annex prevents accidential data loss by [[tracking copies|copies]]
|
|
|
|
|
of your files
|
2010-10-19 23:28:29 +00:00
|
|
|
* [[what git annex is not|not]]
|
2010-10-19 20:17:29 +00:00
|
|
|
* git-annex is Free Software, licensed under the [[GPL]].
|
2010-10-19 19:59:40 +00:00
|
|
|
|
2010-10-19 18:37:19 +00:00
|
|
|
----
|
|
|
|
|
|
|
|
|
|
git-annex's wiki is powered by [Ikiwiki](http://ikiwiki.info/) and
|
|
|
|
|
hosted by [Branchable](http://branchable.com/).
|
