documentation enhancements
fix an ugly workaround
fix namespace and filetype definition
add documentation, fix parameter handling