summaryrefslogtreecommitdiffstats
path: root/crates/core/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'crates/core/README.md')
-rw-r--r--crates/core/README.md15
1 files changed, 15 insertions, 0 deletions
diff --git a/crates/core/README.md b/crates/core/README.md
new file mode 100644
index 00000000..44920e43
--- /dev/null
+++ b/crates/core/README.md
@@ -0,0 +1,15 @@
+ripgrep core
+------------
+This is the core ripgrep crate. In particular, `main.rs` is where the `main`
+function lives.
+
+Most of ripgrep core consists of two things:
+
+* The definition of the CLI interface, including docs for every flag.
+* Glue code that brings the `grep-matcher`, `grep-regex`, `grep-searcher` and
+ `grep-printer` crates together to actually execute the search.
+
+Currently, there are no plans to make ripgrep core available as an independent
+library. However, much of the heavy lifting of ripgrep is done via its
+constituent crates, which can be reused independent of ripgrep. Unfortunately,
+there is no guide or tutorial to teach folks how to do this yet.