Overview

.. -*- rst -*-

Integration of largefiles and hgweb
===================================

The standard largefiles extension has no integration with the
Mercurial webserver started by ``hg serve`` or by Apache.

In particular, this means that the manifest view will show the
``.hglf/`` directory::

    http://localhost:8000/file/

Also, directories containing nothing but largefiles don't show up as
normal directories in the manifest view -- they are only shown inside
the ``.hglf/`` directory.

This extension overrides the manifest view so that largefiles are
shown in-place. This makes it possible to see the real directory
structure when browsing in hgweb.

Installation
------------

Load the extension by adding a reference to this directory::

  [extensions]
  hgweb-largefiles = /path/to/this/directory/

The extension works with Mercurial 2.0 and later.

Caveats
-------

* While the largefiles appear to be integrated with the normal files,
  the links still go to the *standin* files. This makes it possible to
  see the file log for a largefile, but all patches show the changes
  to the version controlled hash value.

* It is now an error to browse the ``.hglf/`` directory directly in
  hgweb. Going to ::

      http://localhost:8000/file/tip/.hglf/

  returns a "404 Not Found" error page

Contact
-------

This extension was written by `aragost Trifork`_ for a client. Feel
free to contact Martin Geisler <mg@aragost.com> discuss any further
improvements to the extension.

.. _aragost Trifork: http://aragost.com/mercurial/

License
-------

The extension is licensed under the GNU GPL version 2 or later. Please
see the ``COPYING`` file for details.