git-lfs/docs
Taylor Blau be411309fd commands/command_migrate.go: loosen meaning of '--everything'
In [1] and [2], callers of the 'git lfs migrate' command were surprised
when `--everything` did not migrate over everything, as its name
implies.

In the documentation, we specified that `--everything` applies only to
local references, as the default behavior of 'git lfs migrate' is to
never require a force-push unless asked to do so explicitly.

--everything sounds dangerous enough that it would imply that a user
wants _everything_ in their repository migrated. So, let's loosen the
requirement and make it mean that.

Alternatively, we could change the meaning of `--everything` in this
fashion and replace it with `--everything-local`. We could also
introduce `--force`, leave the meaning of `--evrything` unchanged, and
only exhibit this behavior with `--everything --force`. Both of these
options add too much surface area and complexity for use cases that seem
less-common, and/or could be accomplished with clever `git for-each-ref`
and `xargs`-ing.

[1]: https://github.com/git-lfs/git-lfs/issues/2984
[2]: https://github.com/git-lfs/git-lfs/issues/3118
2018-07-09 14:49:43 -05:00
..
api refspec docs 2018-01-17 11:54:08 -07:00
man commands/command_migrate.go: loosen meaning of '--everything' 2018-07-09 14:49:43 -05:00
proposals update other github/git-lfs references 2016-11-15 10:07:11 -07:00
custom-transfers.md Support standalonetransferagent based on API URL prefix match 2017-09-20 15:04:25 +02:00
extensions.md Fix typo 2015-10-06 01:11:55 +09:00
linux-build.md Format CentOS bullet points in linux-build.md 2015-08-24 16:23:14 -07:00
README.md Allow using custom transfer agents directly 2017-07-31 16:28:07 +02:00
spec.md spec: mention that an empty file is its own LFS pointer 2017-07-28 16:42:17 -04:00

Git LFS Documentation

Reference Manual

Each Git LFS subcommand is documented in the official man pages. Any of these can also be viewed from the command line:

$ git lfs help <command>
$ git lfs <command> -h

Videos

Developer Docs

Details of how the Git LFS client works are in the official specification.

Details of how the GIT LFS server works are in the API specification.