better examples
added user options to providence.sh