clear away the parts which caused warnings and add examples
add examples and a little drying