|
Size: 3522
Comment: First draft using the content of hgext/largefiles/usage.txt
|
Size: 433
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| #pragma section-numbers 2 = Largefiles extension = Large binary files tend to be not very compressible, not very "diffable", and not at all mergeable. Such files are not handled well by Mercurial's storage format ([[Revlog]]), which is based on compressed binary deltas. largefiles solves this problem by adding a centralized client-server layer on top of Mercurial: largefiles live in a ''central store'' out on the network somewhere, and you only fetch the ones that you need when you need them. <<TableOfContents>> == Status == '''This extension is distributed with Mercurial.''' ''Author: '' ''Various'' == Overview == The largefiles extension allows for tracking large, incompressible binary files in Mercurial without requiring excessive bandwidth for clones and pulls. Files added as largefiles are not tracked directly by Mercurial; rather, their revisions are identified by a checksum, and Mercurial tracks these checksums. This way, when you clone a repository or pull in changesets, the large files in older revisions of the repository are not needed, and only the ones needed to update to the current version are downloaded. This saves both disk space and bandwidth. If you are starting a new repository or adding new large binary files, using largefiles for them is as easy as adding '--large' to your hg add command. For example: {{{ $ dd if=/dev/urandom of=thisfileislarge count=2000 $ hg add --large thisfileislarge $ hg commit -m 'add thisfileislarge, which is large, as a largefile' }}} When you push a changeset that affects largefiles to a remote repository, its largefile revisions will be uploaded along with it. Note that the remote Mercurial must also have the largefiles extension enabled for this to work. When you pull a changeset that affects largefiles from a remote repository, nothing different from Mercurial's normal behavior happens. However, when you update to such a revision, any largefiles needed by that revision are downloaded and cached if they have never been downloaded before. This means that network access is required to update to revision you have not yet updated to. If you already have large files tracked by Mercurial without the largefiles extension, you will need to convert your repository in order to benefit from largefiles. This is done with the '`hg lfconvert`' command: {{{ $ hg lfconvert --size 10 oldrepo newrepo }}} By default, in repositories that already have largefiles in them, any new file over 10MB will automatically be added as largefiles. To change this threshhold, set `largefiles.size` in your Mercurial config file to the minimum size in megabytes to track as a largefile: {{{ [largefiles] size = 2 }}} or use the `--lfsize` option to the add command (also in megabytes): {{{ $ hg add --lfsize 2 }}} The `largefiles.patterns` config option allows you to specify specific space-separated filename patterns (in shell glob syntax) that should always be tracked as largefiles: {{{ [largefiles] patterns = *.jpg *.{png,bmp} library.zip content/audio/* }}} == Configuration == Configure your config file to enable the extension by adding following lines: {{{ [extensions] largefiles = }}} == See also == There are a number of older extensions for managing large files. This extension is a descendant of the BfilesExtension and is now the recommended way to handle such files. Alternatives are BigfilesExtension and SnapExtension. ---- CategoryBundledExtension |
Hey there. Let me start by introducing the author, her name is Dorene. Managing we is how she has [[http://www.Sharkbayte.com/keyword/produced|produced]] money. She's always loved living to South Dakota and she will never move. The favorite hobby to be with her and her kids is magic and she certainly not stop doing it. She's not effective in design but you need to check her website: http://midtree.co/article/article.php?id=5951 |
Hey there. Let me start by introducing the author, her name is Dorene. Managing we is how she has produced money. She's always loved living to South Dakota and she will never move. The favorite hobby to be with her and her kids is magic and she certainly not stop doing it. She's not effective in design but you need to check her website: http://midtree.co/article/article.php?id=5951