From 8ecc705ba41c091b5b09bd00b8630e77e2bff677 Mon Sep 17 00:00:00 2001
From: Fred Drake <fdrake@acm.org>
Date: Tue, 17 Feb 1998 20:31:08 +0000
Subject: Added comment explaining the only warning produced by makeindex,
 since there doesn't appear to be a way to fix that's reasonable.

---
 Doc/lib/libgdbm.tex | 14 ++++++++++++++
 Doc/libgdbm.tex     | 14 ++++++++++++++
 2 files changed, 28 insertions(+)

diff --git a/Doc/lib/libgdbm.tex b/Doc/lib/libgdbm.tex
index d42bf85..73fc9ab 100644
--- a/Doc/lib/libgdbm.tex
+++ b/Doc/lib/libgdbm.tex
@@ -2,6 +2,20 @@
 \label{module-gdbm}
 \bimodindex{gdbm}
 
+% Note that if this section appears on the same page as the first
+% paragraph of the dbm module section, makeindex will produce the
+% warning:
+%
+% ## Warning (input = lib.idx, line = 1184; output = lib.ind, line = 852):
+%    -- Conflicting entries: multiple encaps for the same page under same key.
+%
+% This is because the \bimodindex{gdbm} and \refbimodindex{gdbm}
+% entries in the .idx file are slightly different (the \bimodindex{}
+% version includes "|textbf" at the end to make the defining occurance 
+% bold).  There doesn't appear to be anything that can be done about
+% this; it's just a little annoying.  The warning can be ignored, but
+% the index produced uses the non-bold version.
+
 This module is quite similar to the \code{dbm} module, but uses \code{gdbm}
 instead to provide some additional functionality.  Please note that
 the file formats created by \code{gdbm} and \code{dbm} are incompatible.
diff --git a/Doc/libgdbm.tex b/Doc/libgdbm.tex
index d42bf85..73fc9ab 100644
--- a/Doc/libgdbm.tex
+++ b/Doc/libgdbm.tex
@@ -2,6 +2,20 @@
 \label{module-gdbm}
 \bimodindex{gdbm}
 
+% Note that if this section appears on the same page as the first
+% paragraph of the dbm module section, makeindex will produce the
+% warning:
+%
+% ## Warning (input = lib.idx, line = 1184; output = lib.ind, line = 852):
+%    -- Conflicting entries: multiple encaps for the same page under same key.
+%
+% This is because the \bimodindex{gdbm} and \refbimodindex{gdbm}
+% entries in the .idx file are slightly different (the \bimodindex{}
+% version includes "|textbf" at the end to make the defining occurance 
+% bold).  There doesn't appear to be anything that can be done about
+% this; it's just a little annoying.  The warning can be ignored, but
+% the index produced uses the non-bold version.
+
 This module is quite similar to the \code{dbm} module, but uses \code{gdbm}
 instead to provide some additional functionality.  Please note that
 the file formats created by \code{gdbm} and \code{dbm} are incompatible.
-- 
cgit v0.12

