c-generic examples/sync-demo: Spell out parameter names for pubnub method calls

This should be the first example users will read, so it helps to guide
them here a bit.
c-generic TODO: Reorder a bit, +exec wrapper idea
c-generic README.md: Add some general documentation

Detailed API description is missing.