Defines an example alias immediately

* This is in line with other `alias_*` methods like `alias_example_to`
Adds test to verify that custom example method exposes the current example correctly
Merge pull request #1 from alindeman/add-configurable-current-example

Add configurable current example