Documentation of javascript_catalog when packages parameter is None

[Rafael S. Suguiura]

Hello!

I'm starting to use javascript_catalog, I use makemessages to collect all (few) strings from my whole project in one .po file located at project root.

Documentation[1] states the following:

Each string in packages should be in Python dotted-package syntax (the same format as the strings in INSTALLED_APPS) and should refer to a package that contains a locale directory. If you specify multiple packages, all those catalogs are merged into one catalog. This is useful if you have JavaScript that uses strings from different applications.

It doesn't say what happens when the "packages" parameter is left with the default (None) value, even though my intuition says I'm going to have all strings from my project, which seems to be confirmed by my non-scientific empiric tests.

So, my question is: Is this how javascript_catalog actually behave?

Extra: Can this behavior be described in documentation?

Rafael

References:

[1] https://docs.djangoproject.com/en/1.7/topics/i18n/translation/