Bug 44414 - hashtab.h functions are undocumented
Summary: hashtab.h functions are undocumented
Status: UNCONFIRMED
Alias: None
Product: gcc
Classification: Unclassified
Component: other (show other bugs)
Version: 4.6.0
: P3 normal
Target Milestone: ---
Assignee: Not yet assigned to anyone
URL:
Keywords: documentation
Depends on:
Blocks:
 
Reported: 2010-06-04 12:29 UTC by Rainer Orth
Modified: 2010-06-04 12:58 UTC (History)
2 users (show)

See Also:
Host:
Target:
Build:
Known to work:
Known to fail:
Last reconfirmed:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Rainer Orth 2010-06-04 12:29:18 UTC
When I recently needed to use htab_* functions from libiberty's hashtab.h, I found
that they are completely undocumented: the comments in the header aren't enough
to use them, so I had to look at both the implementation and other uses to figure
things out.
Comment 1 Richard Biener 2010-06-04 12:32:18 UTC
libiberty has documentation in source libiberty/hashtab.c.
Comment 2 Rainer Orth 2010-06-04 12:58:00 UTC
This is not proper documentation: most part of libiberty use comments which
can be extracted and put into the .texi files, while hashtab.c does not.