Added errors doc

1 files changed, 10 insertions, 0 deletions

diff --git a/bp.1 b/bp.1
index 4921be7..5bdca11 100644
--- a/bp.1
+++ b/bp.1
@@ -271,6 +271,16 @@ not contain the word \f[B]\[lq]IGNORE\[rq]\f[R])
 \f[I]name\f[R]\f[B]:\f[R] \f[I]pat\f[R]
 Define \f[I]name\f[R] to mean \f[I]pat\f[R] (pattern definition)
 .TP
+\f[B](!)\f[R] \f[I]error-pat\f[R]
+If \f[I]error-pat\f[R] matches, \f[B]bp\f[R] will not print any results
+in this file and instead print an error message highlighting the
+matching position of \f[I]error-pat\f[R] in the file and printing the
+text of \f[I]error-pat\f[R] as an error message.
+Then, \f[B]bp\f[R] will exit with a failure status and not process any
+further files.
+(e.g.\ \f[B]bp -G -p `(!){NOCOMMIT}=>\[dq]Cannot commit because of
+this\[dq]' && git commit -a\f[R])
+.TP
 \f[B]#\f[R] \f[I]comment\f[R]
 A line comment
 .SH GRAMMAR FILES