Ticket #5522: django-admin.diff

django/core/management/commands/messagesunique.py

@@ +1 @@
+import os
+import sys
+from django.core.management.base import BaseCommand, CommandError, get_locale_dir
+
+class Command(BaseCommand):
+    help = "Unifies recursively duplicate translations of the same message ID."
+
+    requires_model_validation = False
+    can_import_settings = False
+
+    def handle(self, *args, **options):
+        if len(args) != 0:
+            raise CommandError("Command doesn't accept any arguments")
+        basedir = get_locale_dir()
+        for (dirpath, dirnames, filenames) in os.walk(basedir):
+            for f in filenames:
+                if f.endswith('.po'):
+                    sys.stderr.write('processing file %s in %s\n' % (f, dirpath))
+                    pf = os.path.splitext(os.path.join(dirpath, f))[0]
+                    cmd = 'msguniq "%s.po"' % pf
+                    stdout = os.popen(cmd)
+                    msg = stdout.read()
+                    open('%s.po' % pf, 'w').write(msg)

django/core/management/commands/messagesmake.py

@@ +1 @@
+import re
+import os
+import sys
+from itertools import dropwhile
+from optparse import make_option
+from django.core.management.base import CommandError, BaseCommand, get_locale_dir
+from django.utils.translation import templatize
+
+# Need to ensure that the i18n framework is enabled
+from django.conf import settings
+settings.configure(USE_I18N = True)
+
+pythonize_re = re.compile(r'\n\s*//')
+
+class Command(BaseCommand):
+    option_list = BaseCommand.option_list + (
+        make_option('-l', '--locale', default=None, dest='locale',
+            help='Creates or updates the message files only for the given locale (e.g. pt_BR).'),
+        make_option('-d', '--domain', default='django', dest='domain',
+            help='The domain of the message files (default: "django").'),
+        make_option('-v', '--verbosity', action='store', dest='verbosity', default='1',
+            type='choice', choices=['0', '1', '2'],
+            help='Verbosity level; 0=minimal output, 1=normal output, 2=all output'),
+        make_option('-a', '--all', action='store_false', dest='all', default=False,
+            help='Reexamines all source code and templates for new translation strings and updates all message files for all available languages.'),
+    )
+    help = "Runs over the entire source tree of the current directory and pulls out all strings marked for translation. It creates (or updates) a message file in the conf/locale (in the django tree) or locale (for project and application) directory."
+
+    requires_model_validation = False
+    can_import_settings = False
+
+    def handle(self, *args, **options):
+        if len(args) != 0:
+            raise CommandError("Command doesn't accept any arguments")
+
+        localedir = get_locale_dir()
+        locale = options.get('locale', None)
+        domain = options.get('domain', 'django')
+        verbosity = int(options.get('verbosity', 1))
+        all = options.get('all', False)
+
+        if domain not in ('django', 'djangojs'):
+            raise CommandError("currently messagesmake only supports domains 'django' and 'djangojs'")
+        if (locale is None and not all) or domain is None:
+            # backwards compatible error message
+            if not sys.argv[0].endswith("make-messages.py"):
+                message = "Type '%s help %s' for usage.\n" % (os.path.basename(sys.argv[0]), sys.argv[1])
+            else:
+                message = "usage: make-messages.py -l <language>\n   or: make-messages.py -a\n"
+            sys.stderr.write(message)
+            sys.exit(1)
+
+        languages = []
+
+        if locale is not None:
+            languages.append(locale)
+        elif all:
+            languages = [el for el in os.listdir(localedir) if not el.startswith('.')]
+
+        for locale in languages:
+            if verbosity > 0:
+                print "processing language", locale
+            basedir = os.path.join(localedir, locale, 'LC_MESSAGES')
+            if not os.path.isdir(basedir):
+                os.makedirs(basedir)
+
+            pofile = os.path.join(basedir, '%s.po' % domain)
+            potfile = os.path.join(basedir, '%s.pot' % domain)
+
+            if os.path.exists(potfile):
+                os.unlink(potfile)
+
+            for (dirpath, dirnames, filenames) in os.walk("."):
+                for file in filenames:
+                    if domain == 'djangojs' and file.endswith('.js'):
+                        if verbosity > 1:
+                            sys.stdout.write('processing file %s in %s\n' % (file, dirpath))
+                        src = open(os.path.join(dirpath, file), "rb").read()
+                        src = pythonize_re.sub('\n#', src)
+                        open(os.path.join(dirpath, '%s.py' % file), "wb").write(src)
+                        thefile = '%s.py' % file
+                        cmd = 'xgettext %s -d %s -L Perl --keyword=gettext_noop --keyword=gettext_lazy --keyword=ngettext_lazy:1,2 --from-code UTF-8 -o - "%s"' % (
+                            os.path.exists(potfile) and '--omit-header' or '', domain, os.path.join(dirpath, thefile))
+                        (stdin, stdout, stderr) = os.popen3(cmd, 't')
+                        msgs = stdout.read()
+                        errors = stderr.read()
+                        if errors:
+                            print "errors happened while running xgettext on %s" % file
+                            print errors
+                            sys.exit(8)
+                        old = '#: '+os.path.join(dirpath, thefile)[2:]
+                        new = '#: '+os.path.join(dirpath, file)[2:]
+                        msgs = msgs.replace(old, new)
+                        if msgs:
+                            open(potfile, 'ab').write(msgs)
+                        os.unlink(os.path.join(dirpath, thefile))
+                    elif domain == 'django' and (file.endswith('.py') or file.endswith('.html')):
+                        thefile = file
+                        if file.endswith('.html'):
+                            src = open(os.path.join(dirpath, file), "rb").read()
+                            thefile = '%s.py' % file
+                            open(os.path.join(dirpath, thefile), "wb").write(templatize(src))
+                        if verbosity > 1:
+                            sys.stdout.write('processing file %s in %s\n' % (file, dirpath))
+                        cmd = 'xgettext -d %s -L Python --keyword=gettext_noop --keyword=gettext_lazy --keyword=ngettext_lazy:1,2 --keyword=ugettext_noop --keyword=ugettext_lazy --keyword=ungettext_lazy:1,2 --from-code UTF-8 -o - "%s"' % (
+                            domain, os.path.join(dirpath, thefile))
+                        (stdin, stdout, stderr) = os.popen3(cmd, 't')
+                        msgs = stdout.read()
+                        errors = stderr.read()
+                        if errors:
+                            print "errors happened while running xgettext on %s" % file
+                            print errors
+                            sys.exit(8)
+                        if thefile != file:
+                            old = '#: '+os.path.join(dirpath, thefile)[2:]
+                            new = '#: '+os.path.join(dirpath, file)[2:]
+                            msgs = msgs.replace(old, new)
+                        if os.path.exists(potfile):
+                            # Strip the header
+                            msgs = '\n'.join(dropwhile(len, msgs.split('\n')))
+                        else:
+                            msgs = msgs.replace('charset=CHARSET', 'charset=UTF-8')
+                        if msgs:
+                            open(potfile, 'ab').write(msgs)
+                        if thefile != file:
+                            os.unlink(os.path.join(dirpath, thefile))
+
+            if os.path.exists(potfile):
+                (stdin, stdout, stderr) = os.popen3('msguniq --to-code=utf-8 "%s"' % potfile, 'b')
+                msgs = stdout.read()
+                errors = stderr.read()
+                if errors:
+                    print "errors happened while running msguniq"
+                    print errors
+                    sys.exit(8)
+                open(potfile, 'w').write(msgs)
+                if os.path.exists(pofile):
+                    (stdin, stdout, stderr) = os.popen3('msgmerge -q "%s" "%s"' % (pofile, potfile), 'b')
+                    msgs = stdout.read()
+                    errors = stderr.read()
+                    if errors:
+                        print "errors happened while running msgmerge"
+                        print errors
+                        sys.exit(8)
+                open(pofile, 'wb').write(msgs)
+                os.unlink(potfile)

django/core/management/commands/messagescompile.py

@@ +1 @@
+#!/usr/bin/env python
+import os
+import sys
+from optparse import make_option
+from django.core.management.base import BaseCommand, CommandError, get_locale_dir
+from django.core.management.color import no_style
+
+class Command(BaseCommand):
+    option_list = BaseCommand.option_list + (
+        make_option('-l', '--locale', dest='locale',
+            help='The locale to process. Default is to process all.'),
+    )
+    help = 'Compiles .po files to .mo files for use with builtin gettext support.'
+
+    requires_model_validation = False
+    can_import_settings = False
+
+    def handle(self, **options):
+        basedir = get_locale_dir()
+        locale = options.get('locale', None)
+        if locale is not None:
+            basedir = os.path.join(basedir, locale, 'LC_MESSAGES')
+
+        for dirpath, dirnames, filenames in os.walk(basedir):
+            for f in filenames:
+                if f.endswith('.po'):
+                    sys.stderr.write('processing file %s in %s\n' % (f, dirpath))
+                    pf = os.path.splitext(os.path.join(dirpath, f))[0]
+                    # Store the names of the .mo and .po files in an environment
+                    # variable, rather than doing a string replacement into the
+                    # command, so that we can take advantage of shell quoting, to
+                    # quote any malicious characters/escaping.
+                    # See http://cyberelk.net/tim/articles/cmdline/ar01s02.html
+                    os.environ['djangocompilemo'] = pf + '.mo'
+                    os.environ['djangocompilepo'] = pf + '.po'
+                    if sys.platform == 'win32': # Different shell-variable syntax
+                        cmd = 'msgfmt --check-format -o "%djangocompilemo%" "%djangocompilepo%"'
+                    else:
+                        cmd = 'msgfmt --check-format -o "$djangocompilemo" "$djangocompilepo"'
+                    os.system(cmd)

django/core/management/commands/cleanup.py

@@ +1 @@
+import datetime
+from django.core.management.base import NoArgsCommand
+
+class Command(NoArgsCommand):
+    help = "Can be run as a cronjob or directly to clean out old data from the database (only expired sessions at the moment)."
+
+    def handle_noargs(self, **options):
+        from django.db import transaction
+        from django.contrib.sessions.models import Session
+        Session.objects.filter(expire_date__lt=datetime.datetime.now()).delete()
+        transaction.commit_unless_managed()

django/core/management/base.py

@@ -203 +203 @@
-            except OSError:
-                sys.stderr.write(style.NOTICE("Notice: Couldn't set permission bits on %s. You're probably using an uncommon filesystem setup. No problem.\n" % path_new))
-
+def get_locale_dir():
+    "Returns the locale directory from the Django SVN tree or an application/project"
+    if os.path.isdir(os.path.join('conf', 'locale')):
+        basedir = os.path.abspath(os.path.join('conf', 'locale'))
+    elif os.path.isdir('locale'):
+        basedir = os.path.abspath('locale')
+    else:
+        raise CommandError("This script should be run from the Django SVN tree or your project or app tree. If you did indeed run it from the SVN checkout or your project or application, maybe you are just missing the conf/locale (in the django tree) or locale (for project and application) directory? It is not created automatically, you have to create it by hand if you want to enable i18n for your project or application.")
+    return basedir
+
-def _make_writeable(filename):
-    "Makes sure that the file is writeable. Useful if our source is read-only."
-    import stat

django/bin/daily_cleanup.py

@@ -7 +7 @@
-sessions at the moment).
-"""
-
-
-
-
+
-
-def clean_up():
-    """Clean up expired sessions."""
-    Session.objects.filter(expire_date__lt=datetime.datetime.now()).delete()
-    transaction.commit_unless_managed()
-
-if __name__ == "__main__":
-clean_up(
+management.call_command('cleanup'

django/bin/unique-messages.py

@@ -1 +1 @@
-#!/usr/bin/env python
+from django.core import management
-
-import os
-import sys
-
-def unique_messages():
-    basedir = None
-
-    if os.path.isdir(os.path.join('conf', 'locale')):
-        basedir = os.path.abspath(os.path.join('conf', 'locale'))
-    elif os.path.isdir('locale'):
-        basedir = os.path.abspath('locale')
-    else:
-        print "this script should be run from the django svn tree or your project or app tree"
-        sys.exit(1)
-
-    for (dirpath, dirnames, filenames) in os.walk(basedir):
-        for f in filenames:
-            if f.endswith('.po'):
-                sys.stderr.write('processing file %s in %s\n' % (f, dirpath))
-                pf = os.path.splitext(os.path.join(dirpath, f))[0]
-                cmd = 'msguniq "%s.po"' % pf
-                stdout = os.popen(cmd)
-                msg = stdout.read()
-                open('%s.po' % pf, 'w').write(msg)
-
-if __name__ == "__main__":
-unique_messages(
+management.call_command('messagesunique'

django/bin/compile-messages.py

@@ -1 +1 @@
-#!/usr/bin/env python
-
-import optparse
-import os
-import sys
+import optparse
+from django.core import management
-
-def compile_messages(locale=None):
-    basedir = None
-
-    if os.path.isdir(os.path.join('conf', 'locale')):
-        basedir = os.path.abspath(os.path.join('conf', 'locale'))
-    elif os.path.isdir('locale'):
-        basedir = os.path.abspath('locale')
-    else:
-        print "This script should be run from the Django SVN tree or your project or app tree."
-        sys.exit(1)
-
-    if locale is not None:
-        basedir = os.path.join(basedir, locale, 'LC_MESSAGES')
-
-    for dirpath, dirnames, filenames in os.walk(basedir):
-        for f in filenames:
-            if f.endswith('.po'):
-                sys.stderr.write('processing file %s in %s\n' % (f, dirpath))
-                pf = os.path.splitext(os.path.join(dirpath, f))[0]
-                # Store the names of the .mo and .po files in an environment
-                # variable, rather than doing a string replacement into the
-                # command, so that we can take advantage of shell quoting, to
-                # quote any malicious characters/escaping.
-                # See http://cyberelk.net/tim/articles/cmdline/ar01s02.html
-                os.environ['djangocompilemo'] = pf + '.mo'
-                os.environ['djangocompilepo'] = pf + '.po'
-                if sys.platform == 'win32': # Different shell-variable syntax
-                    cmd = 'msgfmt --check-format -o "%djangocompilemo%" "%djangocompilepo%"'
-                else:
-                    cmd = 'msgfmt --check-format -o "$djangocompilemo" "$djangocompilepo"'
-                os.system(cmd)
-
-def main():
-    parser = optparse.OptionParser()
-    parser.add_option('-l', '--locale', dest='locale',
-    
+
-    options, args = parser.parse_args()
-    if len(args):
-        parser.error("This program takes no arguments")
-compile_messages(
+management.call_command('messagescompile', locale=
-
-if __name__ == "__main__":
-    main()

django/bin/make-messages.py

@@ -1 +1 @@
-#!/usr/bin/env python
-
-# Need to ensure that the i18n framework is enabled
-from django.conf import settings
-settings.configure(USE_I18N = True)
-
-from django.utils.translation import templatize
-import re
-import os
-import sys
-import getopt
-
+
+
-
-
+
+
+
+
+
+
+
+
+
+
-
-
-
-
-
-
-
-
+
+
+
+
+
-    else:
-
-
-
-
-
-
-
+
-
-
+
+
-
-    lang = None
-    domain = 'django'
-    verbose = False
-    all = False
-
-    for o, v in opts:
-        if o == '-l':
-            lang = v
-        elif o == '-d':
-            domain = v
-        elif o == '-v':
-            verbose = True
-        elif o == '-a':
-            all = True
-
-    if domain not in ('django', 'djangojs'):
-        print "currently make-messages.py only supports domains 'django' and 'djangojs'"
-        sys.exit(1)
-    if (lang is None and not all) or domain is None:
-        print "usage: make-messages.py -l <language>"
-        print "   or: make-messages.py -a"
-        sys.exit(1)
-
-    languages = []
-
-    if lang is not None:
-        languages.append(lang)
-    elif all:
-        languages = [el for el in os.listdir(localedir) if not el.startswith('.')]
-
-    for lang in languages:
-
-        print "processing language", lang
-        basedir = os.path.join(localedir, lang, 'LC_MESSAGES')
-        if not os.path.isdir(basedir):
-            os.makedirs(basedir)
-
-        pofile = os.path.join(basedir, '%s.po' % domain)
-        potfile = os.path.join(basedir, '%s.pot' % domain)
-
-        if os.path.exists(potfile):
-            os.unlink(potfile)
-
-        for (dirpath, dirnames, filenames) in os.walk("."):
-            for file in filenames:
-                if domain == 'djangojs' and file.endswith('.js'):
-                    if verbose: sys.stdout.write('processing file %s in %s\n' % (file, dirpath))
-                    src = open(os.path.join(dirpath, file), "rb").read()
-                    src = pythonize_re.sub('\n#', src)
-                    open(os.path.join(dirpath, '%s.py' % file), "wb").write(src)
-                    thefile = '%s.py' % file
-                    cmd = 'xgettext %s -d %s -L Perl --keyword=gettext_noop --keyword=gettext_lazy --keyword=ngettext_lazy:1,2 --from-code UTF-8 -o - "%s"' % (
-                        os.path.exists(potfile) and '--omit-header' or '', domain, os.path.join(dirpath, thefile))
-                    (stdin, stdout, stderr) = os.popen3(cmd, 't')
-                    msgs = stdout.read()
-                    errors = stderr.read()
-                    if errors:
-                        print "errors happened while running xgettext on %s" % file
-                        print errors
-                        sys.exit(8)
-                    old = '#: '+os.path.join(dirpath, thefile)[2:]
-                    new = '#: '+os.path.join(dirpath, file)[2:]
-                    msgs = msgs.replace(old, new)
-                    if msgs:
-                        open(potfile, 'ab').write(msgs)
-                    os.unlink(os.path.join(dirpath, thefile))
-                elif domain == 'django' and (file.endswith('.py') or file.endswith('.html')):
-                    thefile = file
-                    if file.endswith('.html'):
-                        src = open(os.path.join(dirpath, file), "rb").read()
-                        thefile = '%s.py' % file
-                        open(os.path.join(dirpath, thefile), "wb").write(templatize(src))
-                    if verbose:
-                        sys.stdout.write('processing file %s in %s\n' % (file, dirpath))
-                    cmd = 'xgettext -d %s -L Python --keyword=gettext_noop --keyword=gettext_lazy --keyword=ngettext_lazy:1,2 --keyword=ugettext_noop --keyword=ugettext_lazy --keyword=ungettext_lazy:1,2 --from-code UTF-8 -o - "%s"' % (
-                        domain, os.path.join(dirpath, thefile))
-                    (stdin, stdout, stderr) = os.popen3(cmd, 't')
-                    msgs = stdout.read()
-                    errors = stderr.read()
-                    if errors:
-                        print "errors happened while running xgettext on %s" % file
-                        print errors
-                        sys.exit(8)
-                    if thefile != file:
-                        old = '#: '+os.path.join(dirpath, thefile)[2:]
-                        new = '#: '+os.path.join(dirpath, file)[2:]
-                        msgs = msgs.replace(old, new)
-                    if os.path.exists(potfile):
-                        # Strip the header
-                        msgs = '\n'.join(dropwhile(len, msgs.split('\n')))
-                    else:
-                        msgs = msgs.replace('charset=CHARSET', 'charset=UTF-8')
-                    if msgs:
-                        open(potfile, 'ab').write(msgs)
-                    if thefile != file:
-                        os.unlink(os.path.join(dirpath, thefile))
-
-        if os.path.exists(potfile):
-            (stdin, stdout, stderr) = os.popen3('msguniq --to-code=utf-8 "%s"' % potfile, 'b')
-            msgs = stdout.read()
-            errors = stderr.read()
-            if errors:
-                print "errors happened while running msguniq"
-                print errors
-                sys.exit(8)
-            open(potfile, 'w').write(msgs)
-            if os.path.exists(pofile):
-                (stdin, stdout, stderr) = os.popen3('msgmerge -q "%s" "%s"' % (pofile, potfile), 'b')
-                msgs = stdout.read()
-                errors = stderr.read()
-                if errors:
-                    print "errors happened while running msgmerge"
-                    print errors
-                    sys.exit(8)
-            open(pofile, 'wb').write(msgs)
-            os.unlink(potfile)
-
-if __name__ == "__main__":
-ke_messages
+in

extras/django_bash_completion

@@ -42 +42 @@
-    prev="${COMP_WORDS[COMP_CWORD-1]}"
-
-    # Standalone options
-
+locale --all --domain --
-    # Actions
-
-reset runfcgi runserver
-shell sql sqlall sqlclear sqlcustom sqlflush sqlindexes
-reset sqlsequencereset startapp startprojec
-
+cleanup 
+messagescompile messagesmake
+messagesunique reset runfcgi runserver shell sql sqlall
+clear sqlcustom sqlflush sqlindexes sqlrese
+qlsequencereset startapp startproject s
-    # Action's options
-    action_shell_opts="--plain"
-    action_runfcgi_opts="host port socket method maxspare minspare maxchildren daemonize pidfile workdir"
@@ -112 +112 @@
-                return 0
-                ;;
-
-
-
+
+
+
-            validate)
-                COMPREPLY=()
-                return 0

docs/settings.txt

@@ -567 +567 @@
-        ('en', gettext('English')),
-    )
-
-make-messages.py`` will still find and mark these
-
-
+django-admin messagesmake`` will still find and mark
+
+so 
-any code that uses ``LANGUAGES`` at runtime.
-
-LOGIN_REDIRECT_URL

docs/i18n.txt

@@ -122 +122 @@
-
-(The caveat with using variables or computed values, as in the previous two
-examples, is that Django's translation-string-detecting utility,
-make-messages.py
-ake-messages
+django-admin.py messagesmake
+essagesmake
-
-The strings you pass to ``_()`` or ``ugettext()`` can take placeholders,
-specified with Python's standard named-string interpolation syntax. Example::
@@ -384 +384 @@
-available translation strings and how they should be represented in the given
-language. Message files have a ``.po`` file extension.
-
-bin/make-messages.py
+django-admin.py messagesmake
-and upkeep of these files.
-
-To create or update a message file, run this command::
-
-bin/make-messages.py
+django-admin.py messagesmake
-
-...where ``de`` is the language code for the message file you want to create.
-The language code, in this case, is in locale format. For example, it's
@@ -414 +414 @@
-
-.. admonition:: No gettext?
-
-make-messages.py
+django-admin.py messagesmake
-    will create empty files. If that's the case, either install the ``gettext``
-    utilities or just copy the English message file
-    (``conf/locale/en/LC_MESSAGES/django.po``) and use it as a starting point;
@@ -431 +431 @@
-
-    _("Welcome to my site.")
-
-make-messages.py
+django-admin.py messagesmake
-following snippet -- a message::
-
-    #: path/to/python/module.py:23
@@ -464 +464 @@
-To reexamine all source code and templates for new translation strings and
-update all message files for **all** languages, run this::
-
-make-messages.py
+django-admin.py messagesmake
-
+Remove duplicate translations strings
+-------------------------------------
+
+Sometimes duplicate translations of the same message ID occur which are invalid
+for the Django underlying gettext mechanism. This tool merges the duplicates in
+the current directory recursively::
+
+    django-admin.py messagesunique
+
-Compiling message files
------------------------
-
-After you create your message file -- and each time you make changes to it --
-you'll need to compile it into a more efficient form, for use by ``gettext``.
-bin/compile-messages.py
+django-admin.py messagescompile
-
-This tool runs over all available ``.po`` files and creates ``.mo`` files,
-which are binary files optimized for use by ``gettext``. In the same directory
-make-messages.py``, run ``compile-messages.py`` like
-
+django-admin.py messagesmake``, run ``django-admin.py messagescompile``
+like 
-
-bin/compile-messages.py
+django-admin.py messagescompile
-
-That's it. Your translations are ready for use.
-
@@ -586 +595 @@
-              ('en', ugettext('English')),
-          )
-
-make-messages.py
+django-admin.py messagesmake
-      these strings for translation, but the translation won't happen at
-      runtime -- so you'll have to remember to wrap the languages in the *real*
-      ``ugettext()`` in any code that uses ``LANGUAGES`` at runtime.
@@ -703 +712 @@
-      searched in that order for ``<language>/LC_MESSAGES/django.(po|mo)``
-    * ``$PYTHONPATH/django/conf/locale/<language>/LC_MESSAGES/django.(po|mo)``
-
-make-messages.py`` tool as with the
-
-
-
-
-
+django-admin.py messagesmake`` tool as
+
+
+
+
+``django.mo`` files that 
-
-Application message files are a bit complicated to discover -- they need the
-``LocaleMiddleware``. If you don't use the middleware, only the Django message
@@ -718 +727 @@
-files. If your applications need to be delivered to other users and will
-be used in other projects, you might want to use app-specific translations.
-But using app-specific translations and project translations could produce
-ake-messages``: ``make-messages
+essagesmake``: ``messagesmake
-directories below the current path and so might put message IDs into the
-project message file that are already in application message files.
-
-The easiest way out is to store applications that are not part of the project
-(and so carry their own translations) outside the project tree. That way,
-ake-messages
+essagesmake
-connected to your explicit project and not strings that are distributed
-independently.
-
@@ -818 +827 @@
-----------------------------------------
-
-You create and update the translation catalogs the same way as the other Django
-{{{make-messages.py}}}
+``messagesmake``
-difference is you need to provide a ``-d djangojs`` parameter, like this::
-
-make-messages.py
+django-admin.py messagesmake
-
-This would create or update the translation catalog for JavaScript for German.
-compile-messages.py`` the same
-
+django-admin.py messagescompile``
+the same 
-
-Specialities of Django translation
-==================================

docs/django-admin.txt

@@ -85 +85 @@
-
-.. _Tutorial 2: ../tutorial02/
-
+cleanup
+-------
+
+Can be run as a cronjob or directly to clean out old data from the database
+(only expired sessions at the moment).
+
-createcachetable <tablename>
-----------------------------
-
@@ -314 +320 @@
-
-    django-admin.py loaddata --verbosity=2
-
+messagescompile
+---------------
+
+Compiles .po files created with ``messagesmake`` to .mo files for use with
+the builtin gettext support.
+
+.. i18n documentation: ../i18n/#compiling-message-files
+
+--locale
+~~~~~~~~
+
+Use the ``--locale`` or ``-l`` option to specify the locale to process.
+If not provided all locales are processed.
+
+Example usage::
+
+    django-admin.py messagescompile --locale=br_PT
+
+messagesmake
+------------
+
+Runs over the entire source tree of the current directory and pulls out all
+strings marked for translation. It creates (or updates) a message file in the
+conf/locale (in the django tree) or locale (for project and application)
+directory. After making changes to the messages files you need to compile them
+with ``messagescompile`` for use with the builtin gettext support.
+
+.. i18n documentation: ../i18n/#message-files
+
+--all
+~~~~~
+
+Use the ``--all`` or ``-a`` option to update the message files for all
+available languages.
+
+Example usage::
+
+    django-admin.py messagesmake --all
+
+--locale
+~~~~~~~~
+
+Use the ``--locale`` or ``-l`` option to specify the locale to process.
+
+Example usage::
+
+    django-admin.py messagesmake --locale=br_PT
+
+--domain
+~~~~~~~~
+
+Use the ``--domain`` or ``-d`` option to change the domain of the messages files.
+Currently supported::
+
+    * ``django`` for all *.py and *.html files (default) 
+    * ``djangojs`` for *.js files
+
+--verbosity
+~~~~~~~~~~~
+
+Use ``--verbosity`` or ``-v`` to specify the amount of notification and debug
+information that ``django-admin.py`` should print to the console.
+
+        * ``0`` means no input.
+        * ``1`` means normal input (default).
+        * ``2`` means verbose input.
+
+Example usage::
+
+    django-admin.py messagesmake --verbosity=2
+
+messagesunique
+--------------
+
+Unifies duplicate translations of the same message ID in the messages
+files created with ``messagesmake``.
+
-reset <appname appname ...>
----------------------------
-
@@ -505 +588 @@
-Creates a Django app directory structure for the given app name in the current
-directory.
-