> This approach is far less useful for languages which haven't got > separate spec files
But there aren't many of those! In C, a ".h" file can easily be viewed as a "separate spec file" and interface documentation can and should be placed there, though I understand that few coding conventions call for that.
