More general javadoc modification + moved sample code into an
appropriate package + gradually preparing to allow for
util.Interpolation to be integrated into menu items.