Fix for JDatabaseQuery->union method.  See #32995.

Also minor corrections and improvements to docblocks for union methods.

Union method currently just doesn't work at all.  This fixes it.  See tracker #32995 and PR #1629.  If accepted this fix also needs to go into Joomla 2.5 and Framework 1.x.