Bug#4327: hsearch(3) man page patches
Package: manpages
Version: 1.11-4
I suggest that the following patch be applied to
``/usr/man/man3/hsearch.3''.
-BEGIN------------------------------------------------------------------
--- hsearch.3.orig Wed Aug 28 21:52:40 1996
+++ hsearch.3 Wed Aug 28 22:00:33 1996
@@ -29,11 +29,14 @@
.nf
.B #include <search.h>
.sp
-.BI "ENTRY *hsearch(ENTRY " item ", ACTION " action ");
-.RE
+.BI "ENTRY *hsearch(ENTRY " item ", ACTION " action ");"
+.sp
+.BI "int hsearch(unsigned " nel ");"
+.sp
+.BI "void hdestroy(void);"
.fi
.SH DESCRIPTION
-This three functions allow the user to create a hash table of type
+These three functions allow the user to create a hash table of type
\fIENTRY\fP (defined in \fB<search.h>\fP) which associates a key
with any data. The implementation uses \fBmalloc(3)\fP.
.PP
@@ -41,7 +44,7 @@
\fInel\fP is an estimation of the table size which will suffice the
needs. For better algorithms this value can be corrected upwards.
.PP
-The corresponding function \fIhdestroy()\fP frees the memory occupied by
+The corresponding function \fBhdestroy()\fP frees the memory occupied by
the hash table for that a new table can be constructed.
.PP
\fIhsearch()\fP is the function for searching and inserting. Which action
@@ -51,9 +54,9 @@
and \fIFIND\fP means to only search. Unsuccesful actions result in a
return value \fINULL\fP.
.SH "RETURN VALUE"
-\fBhcreate()\fP return zero if the hash table cannot be succesfully installed.
+\fBhcreate()\fP returns zero if the hash table cannot be succesfully installed.
.PP
-\fBhsearch()\fP return \fINULL\fP if either action is \fIENTER\fP and the
+\fBhsearch()\fP returns \fINULL\fP if either action is \fIENTER\fP and the
hash table is full or action is \fIFIND\fP and the \fIitem\fP cannot be find
in the hash table.
.SH BUGS
-END--------------------------------------------------------------------
--
Richard Kettlewell richard@greenend.org.uk richard@elmail.co.uk
http://www.elmail.co.uk/staff/richard/
Reply to: