Changes the description of the template method pattern (as discussed in Issue1099)

[dgruntz]

Adds a comment that the template method should be declared final (as discussed in Issue #1099).
Moreover a real-world example is added.

[iluwatar]

I see there's documentation changes, but the actual changing the method to final is not present (anymore).

[dgruntz]

I see there's documentation changes, but the actual changing the method to final is not present (anymore).

The actual change has been submitted as a separate pull request (#1100). I first only changed the code (in #1100) and then in another branch changed the documentation (#1101), but unfortunately I branched off this new branch from the wrong branch and then mannyally reverted the code change.

There is a problem with the other pull request, namely that the tests do not pass (a problem with mockito and its unability to work with final methods). Due to this problem I think it was a good idea to separate these changes in separate pull requests.

[iluwatar]

Thanks @dgruntz for this contribution.

[iluwatar]

#1099