aboutsummaryrefslogtreecommitdiff
path: root/bp.1
diff options
context:
space:
mode:
authorBruce Hill <bruce@bruce-hill.com>2024-06-23 19:23:02 -0400
committerBruce Hill <bruce@bruce-hill.com>2024-06-23 19:23:02 -0400
commit5a6d4e4b8b2739f4b3520aa707421e99f5939e3e (patch)
treec01e0815056bc706b2c1e64ce3824f6fce77ebf4 /bp.1
parentfaba716e87b6201784fa71542e76073ca25963e8 (diff)
Deprecate JSON output formatmaster
Diffstat (limited to 'bp.1')
-rw-r--r--bp.128
1 files changed, 1 insertions, 27 deletions
diff --git a/bp.1 b/bp.1
index 5f1a01c..88565b2 100644
--- a/bp.1
+++ b/bp.1
@@ -1,30 +1,12 @@
-.\" Automatically generated by Pandoc 3.1.6
+.\" Automatically generated by Pandoc 3.1.8
.\"
-.\" Define V font for inline verbatim, using C font in formats
-.\" that render this, and otherwise B font.
-.ie "\f[CB]x\f[]"x" \{\
-. ftr V B
-. ftr VI BI
-. ftr VB B
-. ftr VBI BI
-.\}
-.el \{\
-. ftr V CR
-. ftr VI CI
-. ftr VB CB
-. ftr VBI CBI
-.\}
.TH "BP" "1" "May 17 2021" "" ""
-.hy
.SH NAME
-.PP
bp - Bruce\[aq]s Parsing Expression Grammar tool
.SH SYNOPSIS
-.PP
\f[B]bp\f[R] [\f[I]options\&...\f[R]] \f[I]pattern\f[R] [[\f[B]--\f[R]]
\f[I]files\&...\f[R]]
.SH DESCRIPTION
-.PP
\f[B]bp\f[R] is a tool that matches parsing expression grammars using a
custom syntax.
.SH OPTIONS
@@ -42,10 +24,6 @@ Surround a string pattern with word boundaries (equivalent to \f[B]bp
\f[B]-e\f[R], \f[B]--explain\f[R]
Print a visual explanation of the matches.
.TP
-\f[B]-j\f[R], \f[B]--json\f[R]
-Print a JSON list of the matches.
-(Pairs with \f[B]--verbose\f[R] for more detail)
-.TP
\f[B]-l\f[R], \f[B]--list-files\f[R]
Print only the names of files containing matches instead of the matches
themselves.
@@ -115,7 +93,6 @@ used instead.
If neither are provided, \f[B]bp\f[R] will search through all files in
the current directory and its subdirectories (recursively).
.SH STRING PATTERNS
-.PP
One of the most common use cases for pattern matching tools is matching
plain, literal strings, or strings that are primarily plain strings,
with one or two patterns.
@@ -132,7 +109,6 @@ character literal: \f[B]{\[ga]{}\f[R], the string literal:
\f[B]{\[dq]{\[dq]}\f[R], or a pair of matching curly braces using the
\f[B]braces\f[R] rule: \f[B]{braces}\f[R].
.SH PATTERNS
-.PP
\f[B]bp\f[R] patterns are based off of a combination of Parsing
Expression Grammars and regular expression syntax.
The syntax is designed to map closely to verbal descriptions of the
@@ -377,7 +353,6 @@ that also attaches a metadata tag of the same name)
\f[B]#\f[R] \f[I]comment\f[R]
A line comment, ignored by BP
.SH GRAMMAR FILES
-.PP
\f[B]bp\f[R] allows loading extra grammar files, which define patterns
which may be used for matching.
The \f[B]builtins\f[R] grammar file is loaded by default, and it defines
@@ -430,7 +405,6 @@ following command:
\f[B]bp -g c++ \[aq]{comment \[ti] \[dq]TODO\[dq]}\[aq] *.cpp\f[R]
.RE
.SH EXAMPLES
-.PP
Find files containing the literal string \[lq]foo.baz\[rq] (a string
pattern):
.RS