many improvements and some example files