I wonder if such a beast exists? If not, I think I'd like to lay claim to the idea right now.
Basically, as a programmer, beginner or otherwise, you may not always know what function exists within what header or may not be able to comprehend the contents of a header file.
Wouldn't a program that reads a header and gives you a common use for it be a grand application for a programmer, beginner or otherwise?
For example, taken from stdio.h:
_CRTIMP int __cdecl printf (const char*, ...);
Um, say what? Does it really matter that it is a constant pointer to some text to a beginning programmer? Not really. And knowing this in the beginning to me is not that big of a deal because pointers is something that should be learned on their own and otherwise, variable and type defining is another thing that should be learned separately.
Instead the program would output something like:
printf("Here is a string: %s", sVar);
%s represents a string and will be replaced with the variable or constant that you provide printf.
sVar represents any valid string reference or constant.
So, the idea is something like API Viewer, only for headers. However, I would enable the ability to create custom views allowing other types of files as well. For example, keywords and keyword definitions so someone could define the way another type of "header" is written, thereby enabling this program to read and display that information as well. Also, it would overcome the shortcomings of API Viewer by being a friendly and intuitive application for beginners as well as advanced programmers.
I have several other ideas and features for the program, but those are mine to share only with those who might contribute to the program's birth, fixes, and upgrades.
So, does something like this exist in some form already? Again, if not, it's my idea!