Ticket #17799: 17799-2.diff

docs/howto/custom-management-commands.txt

@@ -243 +243 @@
     :class:`CommandError`, intercept it and print it sensibly to
     stderr.
 
+.. admonition:: Calling a management command in your code
+
+    ``execute()`` should not be called directly from your code to execute a
+    command. Use :ref:`call_command <call-command>` instead.
+
 .. method:: BaseCommand.handle(*args, **options)
 
     The actual logic of the command. Subclasses must implement this method.

docs/ref/django-admin.txt

@@ -1490 +1490 @@
 Running management commands from your code
 ==========================================
 
+.. _call-command:
+
 .. function:: django.core.management.call_command(name, *args, **options)
 
 To call a management command from code use ``call_command``.