Let me mention just two examples:
1) Darcs send was changed to not send mail by default, instead you must
use --mail to get that back. This is nowhere mentioned in the help text.
2) Darcs fetch --help still claims "[it] will use the repository from
which you have most recently either pushed or pulled", which not even
true in 2.8.5: you have to use --set-default explicitly to get that.
I think a general review of teh help texts is in order. Are we any
further w.r.t. getting away from the multi-line string literals in the
code? They make it awfully hard to update the help texts. (I so wish we
had something like HERE docs in Haskell...)