PMC: created convenience registration macro

- we are using this in the example test
- documentation included in comments

fixes #5