39 lines
1.2 KiB
ReStructuredText
39 lines
1.2 KiB
ReStructuredText
.. _hg-big-files:
|
|
|
|
|hg| Large Files Extension
|
|
==========================
|
|
|
|
Large files, such as image or zip files can cause a lot of bandwidth overhead
|
|
during clone, push, and pull operations. To remove this inefficiency, |hg|
|
|
has a large files extension which tracks their revisions by checksums. This
|
|
means that the large files are only downloaded when they are needed as part
|
|
of the current revision. This saves both disk space and bandwidth.
|
|
|
|
To find out more, see the |hg| `Large Files Extensions Documentation`_.
|
|
|
|
To configure the large files extension, you need to set up your
|
|
:file:`~/.hgrc` file.
|
|
|
|
1. Open your :file:`~/.hgrc` file.
|
|
2. Add ``largefiles =`` to the ``[extensions]`` section.
|
|
3. Configure the ``[largefiles]`` section with the patterns and file size you
|
|
wish |hg| to handle as large. The ``minsize`` option is specified in
|
|
megabytes.
|
|
4. Save your changes.
|
|
|
|
.. code-block:: ini
|
|
|
|
[extensions]
|
|
hgext.churn =
|
|
largefiles =
|
|
rebase =
|
|
record =
|
|
histedit =
|
|
|
|
[largefiles]
|
|
patterns = re:.*\.(png|bmp|jpg|zip|tar|tar.gz|rar)$
|
|
minsize = 10
|
|
|
|
For a complete :file:`~/.hgrc` file example, see :ref:`config-hgrc`.
|
|
|
|
.. _Large Files Extensions Documentation: http://mercurial.selenic.com/wiki/LargefilesExtension
|