Fixed some confusing examples and added other Menu documentation

I believe the Menu documentation example was out of date. I attempted to clarify it and some other Menu API calls. 

For reference: https://github.com/MacGapProject/MacGap2/issues/17