[repository api] definitly kill usage of word 'pool' to refer to connections set used by a session
Also document session's data storage and some other internals.
Hopefuly things will get clearer.
Closes #1684860: vocabulary confusion in repository code: notion of 'pool'
fromcubicwebimportUnknownEidsource,=__args__sql("DELETE FROM entities WHERE type='Int'")ecnx=session.cnxset.connection(source)foreinrql('Any X WHERE X cw_source S, S name %(name)s',{'name':source}).entities():meta=e.cw_metainformation()assertmeta['source']['uri']==sourcetry:suri=ecnx.describe(meta['extid'])[1]exceptUnknownEid:print'cant describe',e.__regid__,e.eid,metacontinueifsuri!='system':try:print'deleting',e.__regid__,e.eid,suri,e.dc_title().encode('utf8')repo.delete_info(session,e,suri,meta['extid'],scleanup=True)exceptUnknownEid:print' cant delete',e.__regid__,e.eid,metacommit()