From 95073168c1d03c1c9edf4050fa32607806e586b9 Mon Sep 17 00:00:00 2001
From: Thomas von Dein <tom@vondein.org>
Date: Fri, 21 Nov 2025 00:40:31 +0100
Subject: [PATCH] turn into md, update to meson build

---
 README => README.md | 81 +++++++++++++++++++++++----------------------
 1 file changed, 42 insertions(+), 39 deletions(-)
 rename README => README.md (50%)

diff --git a/README b/README.md
similarity index 50%
rename from README
rename to README.md
index 0bb26e9..7fda415 100644
--- a/README
+++ b/README.md
@@ -1,5 +1,4 @@
-README for dbtool 1.9 (14/05/2015)
-============================================================
+# README for dbtool 1.9.1 (21/11/2025)
 
 dbtool can be used to store and retrieve data in a key/value
 format in a hash database. Perl compatible regular expressions
@@ -10,50 +9,57 @@ data and speed.
  
 
 
-Requirements
-============================================================
+# Requirements
 
 You need either the GNU gdbm library or the Berkeley database
 system. You can find gdbm at:
   http://www.gnu.org/software/gdbm/gdbm.html
 And the berkeley library at: http://www.sleepycat.com.
 
+You will also need `meson` and `ninja`: https://mesonbuild.com/.
 
-
-Installation from source
-============================================================
-
-If you build  directly from the git repo, you'll  need to generate the
-configure script first with 'autogen.sh'.
-
-For installation run:
-
-% ./configure
-% make
-% su
-# make install
-
-You can supply some additional parameters to configure,
-type ./configure --help for details.
+If you want to build the manual page, you'll need perl as well.
 
 
 
+# Installation from source
 
-Documentation
-============================================================
+Check out the source and execute:
+
+```default
+meson setup build
+ninja -C build
+```
+
+You can supply some additional parameters to meson,
+type `meson configuration` for details.
+
+To install, execute:
+
+```default
+sudo ninja -C install
+```
+
+
+# Documentation
 
 After successfully installation read the installed man-
 page:
 
-% man dbtool
+```default
+man dbtool
+```
+
+You can also read the manual page [online](dbtool.pod).
+
+# Report bugs
+
+[Please open an issue](https://codeberg.org/scip/dbtool/issues). Thanks!
 
 
+# License and Disclaimer
 
-
-License and Disclaimer
-============================================================
-
-dbtool is Copyright (c) 2001-2015 by T.v. Dein. dbtool may be
+dbtool is Copyright (c) 2001-2025 by T.v. Dein. dbtool may be
 used and distributed under the terms of the GNU General Public
 License. All other brand and product names are trademarks,
 registered trademarks or service marks of their respective
@@ -65,19 +71,16 @@ warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 See the GNU General Public License for more details.
 
 You should have received a copy of the GNU General Public License
-along with this distribution; if not, write to the 
-  Free Software Foundation, Inc.
-  59 Temple Place
-  Suite 330
-  Boston, MA 02111
-  USA
+along with this distribution; if not, write to the
+
+
+    Free Software Foundation, Inc.
+    59 Temple Place
+    Suite 330
+    Boston, MA 02111
+    USA
 
 
 
 
 
-============================================================
-
-T.v. Dein <tlinden@cpan.org>
-http://www.daemon.de/DBTOOL
-