Add more documentation to TClonesArray::BypassStreamer.    // When the kBypassStreamer bit is set, the automatically    // generated Streamer can call directly TClass::WriteBuffer.    // Bypassing the Streamer improves the performance when writing/reading    // the objects in the TClonesArray. However there is a drawback:    // When a TClonesArray is written with split=0 bypassing the Streamer,    // the StreamerInfo of the class in the array being optimized,    // one cannot use later the TClonesArray with split>0. For example,    // there is a problem with the following scenario:    //  1- a class Foo has a TClonesArray of Bar objects    //  2- the Foo object is written with split=0 to Tree T1.    //     In this case the StreamerInfo for the class Bar is created    //     in optimized mode in such a way that data members of the same type    //     are written as an array improving the I/O performance.    //  3- in a new program, T1 is read and a new Tree T2 is created    //      with the object Foo in split>1    //  4- When the T2 branch is created, the StreamerInfo for the class Bar    //     is created with no optimization (mandatory for the split mode).    //     The optimized Bar StreamerInfo is going to be used to read    //     the TClonesArray in T1. The result will be Bar objects with    //     data member values not in the right sequence.    // The solution to this problem is to call BypassStreamer(kFALSE)    // for the TClonesArray. In this case, the normal Bar::Streamer function    // will be called. The BAR::Streamer function works OK independently    // if the Bar StreamerInfo had been generated in optimized mode or not.
Add more documentation to TClonesArray::BypassStreamer.
   // When the kBypassStreamer bit is set, the automatically
   // generated Streamer can call directly TClass::WriteBuffer.
   // Bypassing the Streamer improves the performance when writing/reading
   // the objects in the TClonesArray. However there is a drawback:
   // When a TClonesArray is written with split=0 bypassing the Streamer,
   // the StreamerInfo of the class in the array being optimized,
   // one cannot use later the TClonesArray with split>0. For example,
   // there is a problem with the following scenario:
   //  1- a class Foo has a TClonesArray of Bar objects
   //  2- the Foo object is written with split=0 to Tree T1.
   //     In this case the StreamerInfo for the class Bar is created
   //     in optimized mode in such a way that data members of the same type
   //     are written as an array improving the I/O performance.
   //  3- in a new program, T1 is read and a new Tree T2 is created
   //      with the object Foo in split>1
   //  4- When the T2 branch is created, the StreamerInfo for the class Bar
   //     is created with no optimization (mandatory for the split mode).
   //     The optimized Bar StreamerInfo is going to be used to read
   //     the TClonesArray in T1. The result will be Bar objects with
   //     data member values not in the right sequence.
   // The solution to this problem is to call BypassStreamer(kFALSE)
   // for the TClonesArray. In this case, the normal Bar::Streamer function
   // will be called. The BAR::Streamer function works OK independently
   // if the Bar StreamerInfo had been generated in optimized mode or not.


git-svn-id: acec3fd5b7ea1eb9e79d6329d318e8118ee2e14f@2657 27541ba8-7e3a-0410-8455-c3a389f83636

olifre/root,mhuwiler/rootauto,krafczyk/root,Y--/root,davidlt/root,buuck/root,jrtomps/root,satyarth934/root,zzxuanyuan/root,gganis/root,cxx-hep/root-cern,Duraznos/root,gbitzes/root,beniz/root,ffurano/root5,omazapa/root,BerserkerTroll/root,davidlt/root,olifre/root,jrtomps/root,mkret2/root,strykejern/TTreeReader,esakellari/root,dfunke/root,dfunke/root,perovic/root,smarinac/root,veprbl/root,omazapa/root-old,thomaskeck/root,mkret2/root,mhuwiler/rootauto,smarinac/root,smarinac/root,sawenzel/root,omazapa/root,esakellari/root,esakellari/my_root_for_test,esakellari/root,ffurano/root5,sawenzel/root,zzxuanyuan/root,evgeny-boger/root,vukasinmilosevic/root,bbockelm/root,davidlt/root,ffurano/root5,abhinavmoudgil95/root,zzxuanyuan/root,sawenzel/root,satyarth934/root,Y--/root,pspe/root,abhinavmoudgil95/root,ffurano/root5,sirinath/root,dfunke/root,Duraznos/root,davidlt/root,abhinavmoudgil95/root,krafczyk/root,sawenzel/root,gganis/root,sbinet/cxx-root,Dr15Jones/root,mattkretz/root,Duraznos/root,tc3t/qoot,nilqed/root,davidlt/root,gbitzes/root,Y--/root,satyarth934/root,jrtomps/root,zzxuanyuan/root,arch1tect0r/root,perovic/root,BerserkerTroll/root,Y--/root,mkret2/root,olifre/root,agarciamontoro/root,kirbyherm/root-r-tools,strykejern/TTreeReader,smarinac/root,karies/root,simonpf/root,nilqed/root,jrtomps/root,perovic/root,omazapa/root,abhinavmoudgil95/root,Dr15Jones/root,root-mirror/root,abhinavmoudgil95/root,ffurano/root5,simonpf/root,omazapa/root,sbinet/cxx-root,vukasinmilosevic/root,mattkretz/root,lgiommi/root,esakellari/my_root_for_test,abhinavmoudgil95/root,nilqed/root,beniz/root,bbockelm/root,CristinaCristescu/root,georgtroska/root,esakellari/root,tc3t/qoot,veprbl/root,Y--/root,thomaskeck/root,jrtomps/root,satyarth934/root,Y--/root,sawenzel/root,olifre/root,sawenzel/root,omazapa/root-old,georgtroska/root,strykejern/TTreeReader,CristinaCristescu/root,sbinet/cxx-root,CristinaCristescu/root,tc3t/qoot,vukasinmilosevic/root,pspe/root,mattkretz/root,root-mirror/root,zzxuanyuan/root-compressor-dummy,satyarth934/root,Dr15Jones/root,0x0all/ROOT,CristinaCristescu/root,evgeny-boger/root,perovic/root,sirinath/root,lgiommi/root,mhuwiler/rootauto,gganis/root,vukasinmilosevic/root,lgiommi/root,lgiommi/root,CristinaCristescu/root,CristinaCristescu/root,karies/root,georgtroska/root,satyarth934/root,Dr15Jones/root,gganis/root,gganis/root,vukasinmilosevic/root,davidlt/root,karies/root,georgtroska/root,veprbl/root,Duraznos/root,satyarth934/root,root-mirror/root,BerserkerTroll/root,olifre/root,abhinavmoudgil95/root,gganis/root,dfunke/root,alexschlueter/cern-root,bbockelm/root,vukasinmilosevic/root,zzxuanyuan/root-compressor-dummy,root-mirror/root,mattkretz/root,esakellari/my_root_for_test,abhinavmoudgil95/root,agarciamontoro/root,buuck/root,jrtomps/root,beniz/root,BerserkerTroll/root,beniz/root,0x0all/ROOT,Dr15Jones/root,arch1tect0r/root,dfunke/root,simonpf/root,mhuwiler/rootauto,omazapa/root-old,sbinet/cxx-root,evgeny-boger/root,zzxuanyuan/root,agarciamontoro/root,georgtroska/root,strykejern/TTreeReader,thomaskeck/root,Y--/root,gbitzes/root,Y--/root,karies/root,Y--/root,root-mirror/root,smarinac/root,root-mirror/root,zzxuanyuan/root,bbockelm/root,omazapa/root-old,nilqed/root,zzxuanyuan/root-compressor-dummy,karies/root,agarciamontoro/root,pspe/root,lgiommi/root,Duraznos/root,lgiommi/root,0x0all/ROOT,pspe/root,agarciamontoro/root,beniz/root,tc3t/qoot,thomaskeck/root,Dr15Jones/root,mhuwiler/rootauto,beniz/root,simonpf/root,ffurano/root5,BerserkerTroll/root,strykejern/TTreeReader,dfunke/root,karies/root,simonpf/root,arch1tect0r/root,mkret2/root,gbitzes/root,root-mirror/root,gbitzes/root,nilqed/root,zzxuanyuan/root,krafczyk/root,agarciamontoro/root,jrtomps/root,davidlt/root,esakellari/my_root_for_test,kirbyherm/root-r-tools,olifre/root,sawenzel/root,Y--/root,georgtroska/root,0x0all/ROOT,alexschlueter/cern-root,omazapa/root-old,gbitzes/root,omazapa/root,root-mirror/root,esakellari/root,beniz/root,gbitzes/root,veprbl/root,BerserkerTroll/root,buuck/root,arch1tect0r/root,zzxuanyuan/root-compressor-dummy,dfunke/root,mattkretz/root,gganis/root,arch1tect0r/root,omazapa/root-old,mkret2/root,beniz/root,kirbyherm/root-r-tools,agarciamontoro/root,pspe/root,krafczyk/root,bbockelm/root,agarciamontoro/root,veprbl/root,vukasinmilosevic/root,root-mirror/root,buuck/root,mattkretz/root,lgiommi/root,sbinet/cxx-root,zzxuanyuan/root,perovic/root,Dr15Jones/root,esakellari/root,krafczyk/root,cxx-hep/root-cern,omazapa/root-old,arch1tect0r/root,simonpf/root,buuck/root,buuck/root,arch1tect0r/root,kirbyherm/root-r-tools,georgtroska/root,mattkretz/root,mattkretz/root,georgtroska/root,evgeny-boger/root,georgtroska/root,pspe/root,cxx-hep/root-cern,arch1tect0r/root,pspe/root,omazapa/root,esakellari/my_root_for_test,gbitzes/root,jrtomps/root,strykejern/TTreeReader,karies/root,beniz/root,gbitzes/root,mkret2/root,abhinavmoudgil95/root,davidlt/root,krafczyk/root,gbitzes/root,vukasinmilosevic/root,krafczyk/root,veprbl/root,zzxuanyuan/root,esakellari/my_root_for_test,davidlt/root,zzxuanyuan/root,karies/root,perovic/root,arch1tect0r/root,zzxuanyuan/root-compressor-dummy,jrtomps/root,agarciamontoro/root,dfunke/root,omazapa/root-old,sirinath/root,mkret2/root,nilqed/root,sirinath/root,ffurano/root5,mkret2/root,veprbl/root,Duraznos/root,krafczyk/root,bbockelm/root,thomaskeck/root,esakellari/my_root_for_test,CristinaCristescu/root,beniz/root,thomaskeck/root,sawenzel/root,0x0all/ROOT,tc3t/qoot,mkret2/root,satyarth934/root,sirinath/root,zzxuanyuan/root,zzxuanyuan/root-compressor-dummy,zzxuanyuan/root-compressor-dummy,evgeny-boger/root,sirinath/root,agarciamontoro/root,CristinaCristescu/root,cxx-hep/root-cern,buuck/root,veprbl/root,0x0all/ROOT,davidlt/root,Duraznos/root,Duraznos/root,CristinaCristescu/root,karies/root,esakellari/root,zzxuanyuan/root,smarinac/root,BerserkerTroll/root,sbinet/cxx-root,buuck/root,satyarth934/root,tc3t/qoot,gganis/root,perovic/root,jrtomps/root,nilqed/root,sawenzel/root,mattkretz/root,Duraznos/root,mhuwiler/rootauto,veprbl/root,sbinet/cxx-root,zzxuanyuan/root-compressor-dummy,tc3t/qoot,evgeny-boger/root,smarinac/root,sirinath/root,lgiommi/root,0x0all/ROOT,CristinaCristescu/root,zzxuanyuan/root-compressor-dummy,nilqed/root,pspe/root,abhinavmoudgil95/root,zzxuanyuan/root-compressor-dummy,krafczyk/root,omazapa/root-old,root-mirror/root,simonpf/root,tc3t/qoot,lgiommi/root,abhinavmoudgil95/root,mhuwiler/rootauto,zzxuanyuan/root-compressor-dummy,mhuwiler/rootauto,thomaskeck/root,omazapa/root,tc3t/qoot,Y--/root,buuck/root,esakellari/my_root_for_test,Duraznos/root,gganis/root,cxx-hep/root-cern,evgeny-boger/root,omazapa/root,nilqed/root,evgeny-boger/root,alexschlueter/cern-root,simonpf/root,CristinaCristescu/root,root-mirror/root,arch1tect0r/root,bbockelm/root,agarciamontoro/root,mkret2/root,bbockelm/root,buuck/root,sbinet/cxx-root,georgtroska/root,sirinath/root,simonpf/root,perovic/root,pspe/root,BerserkerTroll/root,evgeny-boger/root,simonpf/root,buuck/root,sirinath/root,cxx-hep/root-cern,vukasinmilosevic/root,evgeny-boger/root,esakellari/my_root_for_test,krafczyk/root,bbockelm/root,sawenzel/root,satyarth934/root,sirinath/root,strykejern/TTreeReader,thomaskeck/root,0x0all/ROOT,olifre/root,omazapa/root-old,omazapa/root,omazapa/root,perovic/root,sbinet/cxx-root,omazapa/root-old,alexschlueter/cern-root,gganis/root,0x0all/ROOT,nilqed/root,nilqed/root,olifre/root,mattkretz/root,vukasinmilosevic/root,jrtomps/root,Duraznos/root,veprbl/root,satyarth934/root,smarinac/root,kirbyherm/root-r-tools,gbitzes/root,sbinet/cxx-root,omazapa/root,kirbyherm/root-r-tools,cxx-hep/root-cern,BerserkerTroll/root,sbinet/cxx-root,esakellari/root,dfunke/root,mhuwiler/rootauto,georgtroska/root,olifre/root,veprbl/root,vukasinmilosevic/root,mattkretz/root,thomaskeck/root,alexschlueter/cern-root,beniz/root,pspe/root,lgiommi/root,karies/root,krafczyk/root,simonpf/root,esakellari/root,perovic/root,bbockelm/root,esakellari/root,alexschlueter/cern-root,karies/root,BerserkerTroll/root,esakellari/root,pspe/root,tc3t/qoot,lgiommi/root,perovic/root,smarinac/root,sirinath/root,arch1tect0r/root,dfunke/root,BerserkerTroll/root,olifre/root,olifre/root,alexschlueter/cern-root,thomaskeck/root,mhuwiler/rootauto,bbockelm/root,evgeny-boger/root,mkret2/root,smarinac/root,davidlt/root,cxx-hep/root-cern,dfunke/root,gganis/root,mhuwiler/rootauto,sawenzel/root,esakellari/my_root_for_test,kirbyherm/root-r-tools