summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--repoze/bfg/i18n.py9
1 files changed, 7 insertions, 2 deletions
diff --git a/repoze/bfg/i18n.py b/repoze/bfg/i18n.py
index 433dfed5a..adbdb1db6 100644
--- a/repoze/bfg/i18n.py
+++ b/repoze/bfg/i18n.py
@@ -126,17 +126,22 @@ def get_translator(request, translator_factory=None):
return translator
class InterpolationOnlyTranslator(object):
+
""" A class implementing the :term:`translator factory` interface
as its constructor and the :term:`translator` interface as its
``__call__`` method. Useful as a minimal translator factory, this
class only does basic interpolation of mapping values; it does not
- actually do any language translations. Use::
+ actually do any language translations and ignores all
+ :term:`translation domain` information. To use it explicitly::
from repoze.bfg.configuration import Configurator
from repoze.bfg.i18n import InterpolationOnlyTranslator
config = Configurator(translator_factory=InterpolationOnlyTranslator)
- """
+ An instance of this class is returned by
+ :func:`repoze.bfg.i18n.get_translator` if no explicit translator
+ factory is registered.
+ """
classProvides(ITranslatorFactory)
implements(ITranslator)
def __init__(self, request):