Remove reference to sparse boolean in javadoc

The JavaDoc referred to a sparse boolean. However, in the current method signature this is no longer present.
Merge remote-tracking branch 'tmarkus/patch-1' into next
Fix bogus deprecated: These methods to edit the menus are perfectly acceptable, but they affect the menus globally. At one point somebody was using them to send a customised page/menu, which was bad, but that doesn't happen now.
Add suppress warnings and a FIXME explaining (thanks Bombe)