Better document the intended purpose of Partitioner::partition().
Better document the intended purpose of Partitioner::partition().

hrittich/libmesh,dschwen/libmesh,dmcdougall/libmesh,hrittich/libmesh,90jrong/libmesh,permcody/libmesh,coreymbryant/libmesh,friedmud/libmesh,dschwen/libmesh,benkirk/libmesh,vikramvgarg/libmesh,dschwen/libmesh,cahaynes/libmesh,pbauman/libmesh,BalticPinguin/libmesh,aeslaughter/libmesh,friedmud/libmesh,dmcdougall/libmesh,balborian/libmesh,dknez/libmesh,dmcdougall/libmesh,svallaghe/libmesh,dschwen/libmesh,90jrong/libmesh,benkirk/libmesh,hrittich/libmesh,dmcdougall/libmesh,dschwen/libmesh,balborian/libmesh,friedmud/libmesh,roystgnr/libmesh,coreymbryant/libmesh,aeslaughter/libmesh,vikramvgarg/libmesh,pbauman/libmesh,pbauman/libmesh,vikramvgarg/libmesh,BalticPinguin/libmesh,friedmud/libmesh,aeslaughter/libmesh,BalticPinguin/libmesh,dmcdougall/libmesh,libMesh/libmesh,BalticPinguin/libmesh,aeslaughter/libmesh,BalticPinguin/libmesh,pbauman/libmesh,jwpeterson/libmesh,svallaghe/libmesh,aeslaughter/libmesh,giorgiobornia/libmesh,svallaghe/libmesh,pbauman/libmesh,balborian/libmesh,permcody/libmesh,capitalaslash/libmesh,libMesh/libmesh,benkirk/libmesh,permcody/libmesh,cahaynes/libmesh,svallaghe/libmesh,cahaynes/libmesh,capitalaslash/libmesh,giorgiobornia/libmesh,roystgnr/libmesh,svallaghe/libmesh,giorgiobornia/libmesh,hrittich/libmesh,90jrong/libmesh,coreymbryant/libmesh,cahaynes/libmesh,giorgiobornia/libmesh,roystgnr/libmesh,jwpeterson/libmesh,libMesh/libmesh,coreymbryant/libmesh,coreymbryant/libmesh,roystgnr/libmesh,balborian/libmesh,jwpeterson/libmesh,friedmud/libmesh,90jrong/libmesh,hrittich/libmesh,benkirk/libmesh,dknez/libmesh,90jrong/libmesh,jwpeterson/libmesh,cahaynes/libmesh,permcody/libmesh,capitalaslash/libmesh,permcody/libmesh,roystgnr/libmesh,balborian/libmesh,capitalaslash/libmesh,dknez/libmesh,svallaghe/libmesh,libMesh/libmesh,dschwen/libmesh,vikramvgarg/libmesh,aeslaughter/libmesh,benkirk/libmesh,capitalaslash/libmesh,aeslaughter/libmesh,roystgnr/libmesh,dknez/libmesh,90jrong/libmesh,pbauman/libmesh,balborian/libmesh,cahaynes/libmesh,benkirk/libmesh,dmcdougall/libmesh,libMesh/libmesh,dmcdougall/libmesh,capitalaslash/libmesh,dschwen/libmesh,balborian/libmesh,giorgiobornia/libmesh,jwpeterson/libmesh,vikramvgarg/libmesh,jwpeterson/libmesh,friedmud/libmesh,hrittich/libmesh,svallaghe/libmesh,aeslaughter/libmesh,90jrong/libmesh,dknez/libmesh,libMesh/libmesh,friedmud/libmesh,dmcdougall/libmesh,balborian/libmesh,giorgiobornia/libmesh,BalticPinguin/libmesh,libMesh/libmesh,benkirk/libmesh,vikramvgarg/libmesh,BalticPinguin/libmesh,svallaghe/libmesh,hrittich/libmesh,hrittich/libmesh,pbauman/libmesh,roystgnr/libmesh,pbauman/libmesh,capitalaslash/libmesh,hrittich/libmesh,coreymbryant/libmesh,vikramvgarg/libmesh,giorgiobornia/libmesh,benkirk/libmesh,90jrong/libmesh,roystgnr/libmesh,permcody/libmesh,vikramvgarg/libmesh,cahaynes/libmesh,vikramvgarg/libmesh,90jrong/libmesh,friedmud/libmesh,coreymbryant/libmesh,dschwen/libmesh,libMesh/libmesh,balborian/libmesh,capitalaslash/libmesh,jwpeterson/libmesh,dknez/libmesh,pbauman/libmesh,giorgiobornia/libmesh,svallaghe/libmesh,dknez/libmesh,friedmud/libmesh,permcody/libmesh,balborian/libmesh,benkirk/libmesh,coreymbryant/libmesh,giorgiobornia/libmesh,aeslaughter/libmesh,jwpeterson/libmesh,cahaynes/libmesh,dknez/libmesh,permcody/libmesh,BalticPinguin/libmesh