1. Anton Markov
  2. bfiles-auto-status

Overview

HTTPS SSH
======
bfiles
======

``bfiles`` is a Mercurial extension for handling large binary files.
You can enable it like any other Mercurial extension: add

  bfiles = /path/to/bfiles.py

to the ``[extensions]`` section of your ``.hgrc`` or ``.hg/hgrc`` file.

See usage.txt for information on using the extension.

bfiles was written by Greg Ward (greg at gerg dot ca) with
design/interface help from Peter Neelin.

bfiles requires Mercurial 1.3 or later.


-------
Support
-------

Please use the main Mercurial user mailing list for bfiles questions:

  mercurial@selenic.com

If you want to contribute patches, great!  Please use the patchbomb
extension to prepare and send patches.  Send them to the
mercurial-devel@selenic.com list with the flag "bfiles", e.g.

  hg email -t mercurial-devel@selenic.com --flag bfiles -r tip

Just follow all the guidelines for submitting Mercurial patches:

  http://mercurial.selenic.com/wiki/ContributingChanges
  http://mercurial.selenic.com/wiki/SuccessfulPatch


--------------
Latest version
--------------

You can get the latest version by cloning my canonical public
repository:

  http://vc.gerg.ca/hg/hg-bfiles/

There's also a backup on bitbucket.org:

  http://bitbucket.org/gward/hg-bfiles/


-----------
Bug reports
-----------

I'm using bitbucket.org's issue tracker:

  http://bitbucket.org/gward/hg-bfiles/issues/

Please search the tracker before reporting new bugs!


-------
Hacking
-------

If you want to hack on bfiles, design.txt contains obsolete but
easy-to-read design information.  The source code is the final word,
though.

To run the tests, you need a Mercurial source directory for the testing
infrastructure.  The easiest way to do this is to clone hg-crew as a
sibling of hg-bfiles::

  hg clone http://hg.intevation.org/mercurial/crew/ ../hg-crew

Then you can run the bfiles tests::

  cd tests
  ./run-tests.py

Everything you know about running Mercurial's tests applies here.  For
example, you can test bfiles with different Mercurial versions easily::

  hg -R ../hg-crew update 1.3.1
  cd tests
  ./run-tests.py