You are right Steve this info should be in the documentation. I'll work on adding a sentence or two to the doc to make this clearer.
Nathan - can you tell me a bit more about your use case? Why do you want to display multiple popups? How will users interact with the map to display the popups (clicking a feature, drawing a rectangle)? More details may help us come up with a way for you to display this info.
Kelly