From bcd66b20d4a6f149eafdb579c7e5bfea94311756 Mon Sep 17 00:00:00 2001
From: BonfaceKilz <bonfacemunyoki@gmail.com>
Date: Fri, 11 Sep 2020 02:06:54 +0300
Subject: [PATCH] recsel: add page (#4309)

---
 pages/common/recsel.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)
 create mode 100644 pages/common/recsel.md

diff --git a/pages/common/recsel.md b/pages/common/recsel.md
new file mode 100644
index 000000000..c380a35ca
--- /dev/null
+++ b/pages/common/recsel.md
@@ -0,0 +1,16 @@
+# recsel
+
+> Print records from a recfile: a human-editable, plain text database.
+> More information: <https://www.gnu.org/software/recutils/manual/recutils.html>.
+
+- Extract name and version field:
+
+`recsel -p name,version {{data.rec}}`
+
+- Use "~" to match a string with a given regular expression:
+
+`recsel -e "{{field_name}}  ~ '{{pattern_regex}}' {{data.rec}}"`
+
+- Use a predicate to match a name and a version:
+
+`recsel -e "name ~ '{{pattern_regex}}' && version ~ '{{pattern_regex}}'" {{data.rec}}`