"""
Any module that needs non-Python-module files to work correctly should import
this module, and call requireFile at module scope like this:

requireFile(FilePath(__file__).sibling('some_file'))

This allows Deepfreeze to know which static files are necessary for each
individual module.  (The distutils setup.py approach of setting package_data
is not fine-grained enough.)

Any module that imports brequire *must* be safe to import (i.e., it does not
actually "do anything" on import).  Existing software (incl. Deepfreeze)
relies on this guarantee.
"""

__version__ = '11.5.4'


allRequires = set()

def requireFile(fpath):
	"""
	@param fpath: a C{str} or C{unicode} representing an absolute file path.
	"""
	allRequires.add(fpath)


def requireFiles(fpaths):
	for fpath in fpaths:
		requireFile(fpath)

@@ -176,16 +176,136 @@
 sibling(
+'some_file').path)%0A%0Aor if you don't want to use filepath.FilePath:%0A%0ArequireFile(os.path.join(os.path.dirname(__file__), 
 'some_fi
@@ -752,137 +752,528 @@
 %22%22%0A%09
-@param fpath: a C%7Bstr%7D or C%7Bunicode%7D representing an absolute file path.%0A%09%22%22%22%0A%09allRequires.add(fpath)%0A%0A%0Adef requireFiles(fpaths):
+Declare that C%7Bfpath%7D is necessary for the program to work.  C%7Bfpath%7D%0A%09should be a file inside one of your C%7Bsys.path%7D directories.%0A%0A%09@param fpath: a C%7Bstr%7D or C%7Bunicode%7D representing an absolute file path.%0A%09%22%22%22%0A%09allRequires.add(fpath)%0A%0A%0Adef requireFiles(fpaths):%0A%09%22%22%22%0A%09Declare that every path in C%7Bfpaths%7D is necessary for the program to%0A%09work.  Each path should be a file inside one of your C%7Bsys.path%7D%0A%09directories.%0A%0A%09@param fpaths: an iterable of C%7Bstr%7D or C%7Bunicode%7D, each representing an%0A%09%09absolute file path.%0A%09%22%22%22
 %0A%09fo

Write some better docstrings