censor: document that some commands simply ignore censored data
authorJordi Gutiérrez Hermoso <jordigh@octave.org>
Tue, 22 Oct 2019 10:01:48 -0400
changeset 43434 bec734015b70
parent 43433 13b8097dccbf
child 43435 0371a8c84827
censor: document that some commands simply ignore censored data I can't see a benefit for hg grep to ever error out early when it encounters censored data.
hgext/censor.py
--- a/hgext/censor.py	Tue Oct 22 09:56:40 2019 -0400
+++ b/hgext/censor.py	Tue Oct 22 10:01:48 2019 -0400
@@ -23,6 +23,9 @@
 ``hg update``, must be capable of tolerating censored data to continue to
 function in a meaningful way. Such commands only tolerate censored file
 revisions if they are allowed by the "censor.policy=ignore" config option.
+
+A few informative commands such as ``hg grep`` will unconditionally
+ignore censored data and merely report that it was encountered.
 """
 
 from __future__ import absolute_import