Code comments in examples

[BeastyBlacksmith]

The examples need some reformatting, such that the comments inside code (e.g. inside of modules) are not becoming text (cf. fredrikekre/Literate.jl#37).
This hurts copy-pasteability a bit.

[j-fu]

It's a matter of taste... Of course you have a point here. OTOH, the way it is done currently allows for better readability of the documentation (once I find time to expand it ...).
All the example files are there as Julia sources in the examples directory.
I added the corresponding links below the headers.