Comments and links for epydocs corrected after optimisations