-'''hgban is a Mercurial extension which can set up a pretxnchangegroup
-and/or a precommit hook. Any changesets to be pushed / pulled / bundled or
-committed into the repository will have their revision ids matched against a
-list of banned revision sets specified in repo/.hgbanned.
+'''hgban is a Mercurial extension that can be used to abort any push / pull or
+bundle, or any commit operation that matches a given criteria.
+In order to do so, the extension can setup a pretxnchangegroup and/or a
+precommit hook in which the changesets that are to be pushed / pulled / bundled
+or committed into a repository will have their revision ids matched against a
+list of banned revision sets specified in the file repo/.hgbanned.
The banned revision sets can be from simple revision ids to complex revision