[stdlib] Comments and clarification
[stdlib] Comments and clarification

The code was too dense; this reorg makes it easier

Swift SVN r21463

Ivacker/swift,adrfer/swift,tinysun212/swift-windows,SwiftAndroid/swift,tinysun212/swift-windows,practicalswift/swift,codestergit/swift,dduan/swift,gribozavr/swift,milseman/swift,rudkx/swift,frootloops/swift,rudkx/swift,lorentey/swift,swiftix/swift.old,xwu/swift,slavapestov/swift,ken0nek/swift,mightydeveloper/swift,jckarter/swift,swiftix/swift.old,dduan/swift,aschwaighofer/swift,uasys/swift,roambotics/swift,airspeedswift/swift,airspeedswift/swift,KrishMunot/swift,codestergit/swift,mightydeveloper/swift,johnno1962d/swift,jmgc/swift,allevato/swift,Ivacker/swift,hooman/swift,stephentyrone/swift,mightydeveloper/swift,frootloops/swift,sdulal/swift,JGiola/swift,russbishop/swift,dduan/swift,jmgc/swift,atrick/swift,gmilos/swift,devincoughlin/swift,jopamer/swift,Ivacker/swift,karwa/swift,nathawes/swift,austinzheng/swift,gottesmm/swift,gregomni/swift,felix91gr/swift,parkera/swift,huonw/swift,hooman/swift,tinysun212/swift-windows,deyton/swift,frootloops/swift,tkremenek/swift,IngmarStein/swift,manavgabhawala/swift,milseman/swift,benlangmuir/swift,gmilos/swift,cbrentharris/swift,emilstahl/swift,sdulal/swift,glessard/swift,jckarter/swift,sschiau/swift,frootloops/swift,SwiftAndroid/swift,harlanhaskins/swift,tardieu/swift,deyton/swift,lorentey/swift,felix91gr/swift,xwu/swift,felix91gr/swift,uasys/swift,shajrawi/swift,kperryua/swift,sdulal/swift,amraboelela/swift,kusl/swift,djwbrown/swift,OscarSwanros/swift,allevato/swift,milseman/swift,aschwaighofer/swift,huonw/swift,amraboelela/swift,SwiftAndroid/swift,gottesmm/swift,johnno1962d/swift,lorentey/swift,slavapestov/swift,JGiola/swift,hooman/swift,frootloops/swift,shajrawi/swift,gribozavr/swift,IngmarStein/swift,xedin/swift,lorentey/swift,Jnosh/swift,tardieu/swift,ahoppen/swift,adrfer/swift,huonw/swift,ahoppen/swift,nathawes/swift,austinzheng/swift,manavgabhawala/swift,gribozavr/swift,aschwaighofer/swift,manavgabhawala/swift,alblue/swift,xedin/swift,danielmartin/swift,devincoughlin/swift,aschwaighofer/swift,shajrawi/swift,IngmarStein/swift,kstaring/swift,natecook1000/swift,stephentyrone/swift,JaSpa/swift,swiftix/swift,apple/swift,ken0nek/swift,calebd/swift,cbrentharris/swift,kstaring/swift,karwa/swift,SwiftAndroid/swift,ken0nek/swift,austinzheng/swift,modocache/swift,ben-ng/swift,KrishMunot/swift,felix91gr/swift,practicalswift/swift,cbrentharris/swift,slavapestov/swift,xedin/swift,calebd/swift,arvedviehweger/swift,IngmarStein/swift,tardieu/swift,lorentey/swift,SwiftAndroid/swift,shahmishal/swift,airspeedswift/swift,arvedviehweger/swift,gregomni/swift,jckarter/swift,LeoShimonaka/swift,calebd/swift,jopamer/swift,IngmarStein/swift,alblue/swift,JGiola/swift,modocache/swift,atrick/swift,johnno1962d/swift,alblue/swift,practicalswift/swift,harlanhaskins/swift,milseman/swift,kentya6/swift,shahmishal/swift,austinzheng/swift,LeoShimonaka/swift,kusl/swift,danielmartin/swift,deyton/swift,zisko/swift,practicalswift/swift,ahoppen/swift,apple/swift,practicalswift/swift,JGiola/swift,kusl/swift,allevato/swift,emilstahl/swift,karwa/swift,Jnosh/swift,ahoppen/swift,SwiftAndroid/swift,gottesmm/swift,jopamer/swift,KrishMunot/swift,swiftix/swift,natecook1000/swift,hughbe/swift,karwa/swift,shajrawi/swift,uasys/swift,jmgc/swift,stephentyrone/swift,djwbrown/swift,deyton/swift,kusl/swift,swiftix/swift,return/swift,calebd/swift,CodaFi/swift,benlangmuir/swift,sdulal/swift,harlanhaskins/swift,ben-ng/swift,deyton/swift,gmilos/swift,ben-ng/swift,ben-ng/swift,benlangmuir/swift,huonw/swift,gribozavr/swift,return/swift,therealbnut/swift,mightydeveloper/swift,stephentyrone/swift,brentdax/swift,rudkx/swift,tjw/swift,JGiola/swift,adrfer/swift,tardieu/swift,atrick/swift,bitjammer/swift,JaSpa/swift,dduan/swift,gregomni/swift,tinysun212/swift-windows,stephentyrone/swift,aschwaighofer/swift,uasys/swift,arvedviehweger/swift,xedin/swift,manavgabhawala/swift,amraboelela/swift,dreamsxin/swift,modocache/swift,swiftix/swift.old,atrick/swift,slavapestov/swift,jtbandes/swift,kentya6/swift,danielmartin/swift,jmgc/swift,zisko/swift,glessard/swift,sschiau/swift,tjw/swift,apple/swift,amraboelela/swift,tkremenek/swift,allevato/swift,kusl/swift,sschiau/swift,xwu/swift,benlangmuir/swift,roambotics/swift,jckarter/swift,allevato/swift,natecook1000/swift,swiftix/swift.old,kstaring/swift,nathawes/swift,mightydeveloper/swift,zisko/swift,LeoShimonaka/swift,dduan/swift,Jnosh/swift,xedin/swift,JGiola/swift,adrfer/swift,danielmartin/swift,glessard/swift,cbrentharris/swift,milseman/swift,sdulal/swift,dreamsxin/swift,cbrentharris/swift,practicalswift/swift,shahmishal/swift,nathawes/swift,sdulal/swift,ben-ng/swift,tjw/swift,MukeshKumarS/Swift,return/swift,OscarSwanros/swift,devincoughlin/swift,manavgabhawala/swift,IngmarStein/swift,nathawes/swift,felix91gr/swift,IngmarStein/swift,roambotics/swift,deyton/swift,SwiftAndroid/swift,xedin/swift,gmilos/swift,johnno1962d/swift,adrfer/swift,dduan/swift,swiftix/swift,tkremenek/swift,OscarSwanros/swift,ken0nek/swift,hooman/swift,russbishop/swift,gribozavr/swift,devincoughlin/swift,aschwaighofer/swift,natecook1000/swift,jtbandes/swift,parkera/swift,huonw/swift,hughbe/swift,slavapestov/swift,hughbe/swift,return/swift,russbishop/swift,harlanhaskins/swift,sschiau/swift,JaSpa/swift,LeoShimonaka/swift,russbishop/swift,ken0nek/swift,therealbnut/swift,gmilos/swift,tardieu/swift,nathawes/swift,slavapestov/swift,harlanhaskins/swift,danielmartin/swift,sschiau/swift,glessard/swift,Ivacker/swift,austinzheng/swift,alblue/swift,practicalswift/swift,MukeshKumarS/Swift,uasys/swift,djwbrown/swift,shahmishal/swift,kstaring/swift,arvedviehweger/swift,zisko/swift,jopamer/swift,CodaFi/swift,therealbnut/swift,CodaFi/swift,MukeshKumarS/Swift,OscarSwanros/swift,zisko/swift,gregomni/swift,rudkx/swift,bitjammer/swift,ken0nek/swift,jopamer/swift,lorentey/swift,jmgc/swift,gottesmm/swift,jckarter/swift,kusl/swift,tjw/swift,calebd/swift,uasys/swift,johnno1962d/swift,LeoShimonaka/swift,roambotics/swift,JaSpa/swift,johnno1962d/swift,zisko/swift,kusl/swift,hughbe/swift,cbrentharris/swift,swiftix/swift,russbishop/swift,KrishMunot/swift,bitjammer/swift,kstaring/swift,swiftix/swift.old,shahmishal/swift,codestergit/swift,gottesmm/swift,kentya6/swift,natecook1000/swift,khizkhiz/swift,calebd/swift,devincoughlin/swift,mightydeveloper/swift,rudkx/swift,harlanhaskins/swift,parkera/swift,mightydeveloper/swift,ahoppen/swift,airspeedswift/swift,xwu/swift,natecook1000/swift,uasys/swift,shahmishal/swift,swiftix/swift.old,emilstahl/swift,tardieu/swift,jckarter/swift,apple/swift,karwa/swift,karwa/swift,austinzheng/swift,kperryua/swift,shajrawi/swift,jmgc/swift,hughbe/swift,modocache/swift,codestergit/swift,hughbe/swift,jmgc/swift,djwbrown/swift,devincoughlin/swift,jopamer/swift,ahoppen/swift,gribozavr/swift,russbishop/swift,emilstahl/swift,parkera/swift,lorentey/swift,return/swift,OscarSwanros/swift,Jnosh/swift,emilstahl/swift,atrick/swift,khizkhiz/swift,jopamer/swift,MukeshKumarS/Swift,alblue/swift,bitjammer/swift,sdulal/swift,kstaring/swift,arvedviehweger/swift,frootloops/swift,OscarSwanros/swift,sschiau/swift,stephentyrone/swift,amraboelela/swift,stephentyrone/swift,kentya6/swift,parkera/swift,benlangmuir/swift,MukeshKumarS/Swift,johnno1962d/swift,swiftix/swift.old,tjw/swift,swiftix/swift,cbrentharris/swift,huonw/swift,brentdax/swift,kentya6/swift,djwbrown/swift,felix91gr/swift,mightydeveloper/swift,khizkhiz/swift,danielmartin/swift,LeoShimonaka/swift,CodaFi/swift,tinysun212/swift-windows,manavgabhawala/swift,alblue/swift,kperryua/swift,jtbandes/swift,jckarter/swift,nathawes/swift,xwu/swift,brentdax/swift,Jnosh/swift,brentdax/swift,cbrentharris/swift,jtbandes/swift,codestergit/swift,Ivacker/swift,swiftix/swift,amraboelela/swift,Jnosh/swift,hooman/swift,emilstahl/swift,kusl/swift,kperryua/swift,glessard/swift,brentdax/swift,bitjammer/swift,return/swift,airspeedswift/swift,alblue/swift,xedin/swift,xwu/swift,therealbnut/swift,practicalswift/swift,tjw/swift,aschwaighofer/swift,bitjammer/swift,arvedviehweger/swift,devincoughlin/swift,kentya6/swift,CodaFi/swift,KrishMunot/swift,atrick/swift,codestergit/swift,tjw/swift,JaSpa/swift,modocache/swift,MukeshKumarS/Swift,modocache/swift,emilstahl/swift,jtbandes/swift,airspeedswift/swift,JaSpa/swift,amraboelela/swift,kentya6/swift,khizkhiz/swift,apple/swift,LeoShimonaka/swift,benlangmuir/swift,khizkhiz/swift,sdulal/swift,harlanhaskins/swift,djwbrown/swift,ben-ng/swift,adrfer/swift,Ivacker/swift,gottesmm/swift,xedin/swift,tinysun212/swift-windows,khizkhiz/swift,gmilos/swift,emilstahl/swift,sschiau/swift,devincoughlin/swift,gregomni/swift,shajrawi/swift,sschiau/swift,CodaFi/swift,MukeshKumarS/Swift,Ivacker/swift,glessard/swift,bitjammer/swift,shajrawi/swift,brentdax/swift,gribozavr/swift,felix91gr/swift,karwa/swift,austinzheng/swift,gmilos/swift,natecook1000/swift,huonw/swift,calebd/swift,karwa/swift,tinysun212/swift-windows,parkera/swift,CodaFi/swift,manavgabhawala/swift,therealbnut/swift,shahmishal/swift,lorentey/swift,rudkx/swift,shahmishal/swift,jtbandes/swift,tkremenek/swift,khizkhiz/swift,ken0nek/swift,allevato/swift,frootloops/swift,milseman/swift,return/swift,deyton/swift,parkera/swift,kperryua/swift,LeoShimonaka/swift,ben-ng/swift,gribozavr/swift,airspeedswift/swift,swiftix/swift.old,gottesmm/swift,arvedviehweger/swift,codestergit/swift,roambotics/swift,slavapestov/swift,kstaring/swift,JaSpa/swift,tkremenek/swift,gregomni/swift,OscarSwanros/swift,dduan/swift,zisko/swift,hooman/swift,shajrawi/swift,hughbe/swift,roambotics/swift,kperryua/swift,therealbnut/swift,danielmartin/swift,adrfer/swift,brentdax/swift,djwbrown/swift,parkera/swift,jtbandes/swift,apple/swift,KrishMunot/swift,kentya6/swift,therealbnut/swift,tkremenek/swift,KrishMunot/swift,milseman/swift,allevato/swift,xwu/swift,Jnosh/swift,Ivacker/swift,tardieu/swift,russbishop/swift,tkremenek/swift,kperryua/swift,hooman/swift,modocache/swift