reorder function and add some more documentation
reorder function and add some more documentation

ArvinPan/atomspace,yantrabuddhi/atomspace,inflector/atomspace,rodsol/atomspace,ArvinPan/atomspace,misgeatgit/atomspace,inflector/atomspace,misgeatgit/atomspace,ceefour/atomspace,rTreutlein/atomspace,yantrabuddhi/atomspace,yantrabuddhi/atomspace,inflector/atomspace,AmeBel/atomspace,yantrabuddhi/atomspace,misgeatgit/atomspace,rTreutlein/atomspace,yantrabuddhi/atomspace,ceefour/atomspace,rodsol/atomspace,rodsol/atomspace,ceefour/atomspace,inflector/atomspace,rTreutlein/atomspace,rTreutlein/atomspace,ArvinPan/atomspace,misgeatgit/atomspace,ceefour/atomspace,inflector/atomspace,ArvinPan/atomspace,misgeatgit/atomspace,rTreutlein/atomspace,AmeBel/atomspace,rodsol/atomspace,AmeBel/atomspace,AmeBel/atomspace,AmeBel/atomspace