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.
--- 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.
"""