Rationalise 'heading' comments
Caveat for README
Removed non-necessary 'extern C' definitions