extended documentation for scalar example

Extended documentation of the scalar example.
Use two subsequent stars `**` at the beginning of a block to tell Doxygen to pick up the documentation comment.