1 files changed, 9 insertions, 2 deletions

diff --git a/src/mailman/commands/docs/create.rst b/src/mailman/commands/docs/create.rst
index 1a5d2a3ab..aee6b1f05 100644
--- a/src/mailman/commands/docs/create.rst
+++ b/src/mailman/commands/docs/create.rst
@@ -33,6 +33,9 @@ domain.  Both the mailing list and domain will be created.
     >>> command.process(FakeArgs)
     Created mailing list: test@example.xx
 
+This is the default behaviour. Even if you do not specify any option, 
+Mailman will itself make the domain if it doesn't exist.
+
 Now both the domain and the mailing list exist in the database.
 ::
 
@@ -46,8 +49,8 @@ Now both the domain and the mailing list exist in the database.
     >>> getUtility(IDomainManager).get('example.xx')
     <Domain example.xx, base_url: http://example.xx>
 
-You can also create mailing lists in existing domains without the
-auto-creation flag.
+You can also create mailing lists in existing domains by using the
+``-D`` or ``--no-domain`` flag.
 ::
 
     >>> FakeArgs.domain = False
@@ -58,6 +61,10 @@ auto-creation flag.
     >>> list_manager.get('test1@example.com')
     <mailing list "test1@example.com" at ...>
 
+Although the ``--no-domain`` flag is not required when domain already 
+exists it can be used to error out when domain doesn't exist. In such
+case, Mailman will give an error message.
+
 The command can also operate quietly.
 ::