dgit(1): Add caveats to --dry-run and --damp-run

Closes: #973896
Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>

1 files changed, 8 insertions, 0 deletions

diff --git a/dgit.1 b/dgit.1
index 2596b17..7bd8b05 100644
--- a/dgit.1
+++ b/dgit.1
@@ -1318,11 +1318,19 @@ Go through the motions, fetching all information needed, but do not
 actually update the output(s).  For push, dgit does
 the required checks and leaves the new .dsc in a temporary file,
 but does not sign, tag, push or upload.
+
+This is not a very good simulation.
+It can easily go wrong for ways that a for-real push wouldn't.
 .TP
 .BR \-\-damp-run " | " \-L
 Go through many more of the motions: do everything that doesn't
 involve either signing things, or making changes on the public
 servers.
+
+Using this will make unsigned tags,
+and possibly other local changes,
+that will get in the way of a for-real push.
+So be prepared to burn the version number you're using.
 .TP
 .BI \-\-force- something
 Instructs dgit to try to proceed despite detecting