Documentation improved

Improved documentation and fixed some minor issues connected with the
'file # bug'.  The issue is not solved yet, but now  appears not that
often. Testing has to be done to verify integrity of my code regarding
the retrieval of  file # from the image.