minor comments and refactor
collapse white space in comments and dashes in file names
further comment
minor
do do flickr comments
rationalise BASE_DIR
will not update comments