From 27f6c391c8da6efe49b11f73f5258d5cb124590b Mon Sep 17 00:00:00 2001
From: Bruce Hill <bruce@bruce-hill.com>
Date: Thu, 20 May 2021 00:46:53 -0700
Subject: Added errors doc

---
 bp.1 | 10 ++++++++++
 1 file changed, 10 insertions(+)

(limited to 'bp.1')

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
-- 
cgit v1.2.3