--- a/hgext/children.py	Wed Jan 06 17:17:49 2016 +0000
+++ b/hgext/children.py	Wed Jan 06 17:18:18 2016 +0000
@@ -40,6 +40,14 @@
     be printed. If a file argument is given, revision in which the
     file was last changed (after the working directory revision or the
     argument to --rev if given) is printed.
+
+    Please use :hg:`log` instead::
+
+        hg children => hg log -r 'children()'
+        hg children -r REV => hg log -r 'children(REV)'
+
+    See :hg:`help log` and :hg:`help revsets.children`.
+
     """
     rev = opts.get('rev')
     if file_: