# HG changeset patch
# User Martin von Zweigbergk <martinvonz@google.com>
# Date 1424893154 28800
# Node ID 9cb1f82a2571619776a92eb5b5a0028adc853969
# Parent  fbc4d550a6ab5ab81c5bef5ba160227aaf10a2b4
debugsetparent: document one common caveat specifically

After calling debugsetparent, it's quite common that status is
incorrect. The command's help text already says that it should be used
with care, but let's describe this caveat explicitly since it's
probably the most common one.

diff -r fbc4d550a6ab -r 9cb1f82a2571 mercurial/commands.py
--- a/mercurial/commands.py	Fri Feb 20 13:55:01 2015 -0800
+++ b/mercurial/commands.py	Wed Feb 25 11:39:14 2015 -0800
@@ -2893,7 +2893,8 @@
     """manually set the parents of the current working directory
 
     This is useful for writing repository conversion tools, but should
-    be used with care.
+    be used with care. For example, neither the working copy nor the dirstate
+    is updated, so file status may be incorrect after running this command.
 
     Returns 0 on success.
     """