Overview

======
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.  


-------
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
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.