spelling correction
[unix-history] / usr / src / old / libndbm / ndbm.3
index df4704a..fe5c074 100644 (file)
@@ -2,9 +2,9 @@
 .\" All rights reserved.  The Berkeley software License Agreement
 .\" specifies the terms and conditions for redistribution.
 .\"
-.\"    @(#)ndbm.3      6.3 (Berkeley) %G%
+.\"    @(#)ndbm.3      6.6 (Berkeley) %G%
 .\"
-.TH NDBM 3X  ""
+.TH NDBM 3  ""
 .UC 6
 .SH NAME
 dbm_open, dbm_close, dbm_fetch, dbm_store, dbm_delete, dbm_firstkey, dbm_nextkey, dbm_error, dbm_clearerr \- data base subroutines
@@ -64,6 +64,9 @@ int dbm_clearerr(db)
 These functions maintain key/content pairs in a data base.
 The functions will handle very large (a billion blocks)
 databases and will access a keyed item in one or two file system accesses.
+This package replaces the earlier
+.IR dbm (3x)
+library, which managed only a single database.
 .PP
 .IR Key s
 and
@@ -122,7 +125,7 @@ This code will traverse the data base:
 (key = dbm_firstkey(db); key.dptr != NULL; key = dbm_nextkey(db))
 .PP
 .I Dbm_error
-returns non-zero when an error has occured reading or writing the database.
+returns non-zero when an error has occurred reading or writing the database.
 .I Dbm_clearerr
 resets the error condition on the named database.
 .SH DIAGNOSTICS
@@ -133,6 +136,14 @@ Routines that return a
 .I datum
 indicate errors with a null (0)
 .I dptr.
+If
+.IR dbm_store
+called with a
+.I flags
+value of
+.B DBM_INSERT
+finds an existing entry with the same key
+it returns 1.
 .SH BUGS
 The `.pag' file will contain holes so that its apparent size is about
 four times its actual content.  Older UNIX systems may create real
@@ -158,3 +169,5 @@ The order of keys presented by
 and
 .I dbm_nextkey
 depends on a hashing function, not on anything interesting.
+.SH SEE ALSO
+dbm(3X)