documentation
expand and flatten string lists