swap 'singular' for negated 'broadcast' arg

also, as the default is still 'True', the default *behavior* is swapped.

docs and examples updated to reflect this