From df21098dee6cddac7ceb9961573c47705b48c3c4 Mon Sep 17 00:00:00 2001
From: Michael Kerrisk <mtk.manpages@gmail.com>
Date: Mon, 23 Apr 2012 07:47:35 +1200
Subject: [PATCH] btree.3, dbopen.3, hash.3, mpool.3, recno.3: Note that glibc
 no longer provides these interfaces

glibc stopped providing these interfaces with v2.2.
Nowadays, the user that finds these pages probably wants
the libdb API, so note this in the page.

See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=337581

Reported-by: Brian M. Carlson <sandals@crustytoothpaste.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
---
 man3/btree.3  | 9 ++++++++-
 man3/dbopen.3 | 9 ++++++++-
 man3/hash.3   | 9 ++++++++-
 man3/mpool.3  | 7 +++++++
 man3/recno.3  | 9 ++++++++-
 5 files changed, 39 insertions(+), 4 deletions(-)

diff --git a/man3/btree.3 b/man3/btree.3
index 59ab43b1f..1bc61eb5d 100644
--- a/man3/btree.3
+++ b/man3/btree.3
@@ -31,7 +31,7 @@
 .\"
 .\"	@(#)btree.3	8.4 (Berkeley) 8/18/94
 .\"
-.TH BTREE 3 1994-08-18 "" "Linux Programmer's Manual"
+.TH BTREE 3 2012-04-23 "" "Linux Programmer's Manual"
 .\".UC 7
 .SH NAME
 btree \- btree database access method
@@ -43,6 +43,13 @@ btree \- btree database access method
 .ft R
 .fi
 .SH DESCRIPTION
+.IR "Note well" :
+This page documents interfaces provided in glibc up until version 2.1.
+Since version 2.2, glibc no longer provides these interfaces.
+Probably, you are looking for the APIs provided by the
+.I libdb
+library instead.
+
 The routine
 .BR dbopen (3)
 is the library interface to database files.
diff --git a/man3/dbopen.3 b/man3/dbopen.3
index 9bfc16bbb..1b9f3a13c 100644
--- a/man3/dbopen.3
+++ b/man3/dbopen.3
@@ -31,7 +31,7 @@
 .\"
 .\"	@(#)dbopen.3	8.5 (Berkeley) 1/2/94
 .\"
-.TH DBOPEN 3 1994-01-02 "" "Linux Programmer's Manual"
+.TH DBOPEN 3 2012-04-23 "" "Linux Programmer's Manual"
 .UC 7
 .SH NAME
 dbopen \- database access methods
@@ -46,6 +46,13 @@ dbopen \- database access methods
 .BI "           const void *" openinfo );
 .fi
 .SH DESCRIPTION
+.IR "Note well" :
+This page documents interfaces provided in glibc up until version 2.1.
+Since version 2.2, glibc no longer provides these interfaces.
+Probably, you are looking for the APIs provided by the
+.I libdb
+library instead.
+
 .BR dbopen ()
 is the library interface to database files.
 The supported file formats are btree, hashed and UNIX file oriented.
diff --git a/man3/hash.3 b/man3/hash.3
index 24c194da9..645eb958d 100644
--- a/man3/hash.3
+++ b/man3/hash.3
@@ -31,7 +31,7 @@
 .\"
 .\"	@(#)hash.3	8.6 (Berkeley) 8/18/94
 .\"
-.TH HASH 3 1994-08-18 "" "Linux Programmer's Manual"
+.TH HASH 3 2012-04-23 "" "Linux Programmer's Manual"
 .UC 7
 .SH NAME
 hash \- hash database access method
@@ -43,6 +43,13 @@ hash \- hash database access method
 .ft R
 .fi
 .SH DESCRIPTION
+.IR "Note well" :
+This page documents interfaces provided in glibc up until version 2.1.
+Since version 2.2, glibc no longer provides these interfaces.
+Probably, you are looking for the APIs provided by the
+.I libdb
+library instead.
+
 The routine
 .BR dbopen (3)
 is the library interface to database files.
diff --git a/man3/mpool.3 b/man3/mpool.3
index 5a0643774..2a487c2de 100644
--- a/man3/mpool.3
+++ b/man3/mpool.3
@@ -58,6 +58,13 @@ mpool \- shared memory buffer pool
 .BI "int mpool_close(MPOOL *" mp );
 .fi
 .SH DESCRIPTION
+.IR "Note well" :
+This page documents interfaces provided in glibc up until version 2.1.
+Since version 2.2, glibc no longer provides these interfaces.
+Probably, you are looking for the APIs provided by the
+.I libdb
+library instead.
+
 .I Mpool
 is the library interface intended to provide page oriented buffer management
 of files.
diff --git a/man3/recno.3 b/man3/recno.3
index 2a6680582..9ca083d4a 100644
--- a/man3/recno.3
+++ b/man3/recno.3
@@ -31,7 +31,7 @@
 .\"
 .\"	@(#)recno.3	8.5 (Berkeley) 8/18/94
 .\"
-.TH RECNO 3 1994-08-18 "" "Linux Programmer's Manual"
+.TH RECNO 3 2012-04-23 "" "Linux Programmer's Manual"
 .UC 7
 .SH NAME
 recno \- record number database access method
@@ -43,6 +43,13 @@ recno \- record number database access method
 .ft R
 .fi
 .SH DESCRIPTION
+.IR "Note well" :
+This page documents interfaces provided in glibc up until version 2.1.
+Since version 2.2, glibc no longer provides these interfaces.
+Probably, you are looking for the APIs provided by the
+.I libdb
+library instead.
+
 The routine
 .BR dbopen (3)
 is the library interface to database files.