Need documentation on how to specify inputs and outputs

The documentation needs examples for e.g. how you transform all files in a directory tree in-place, how you transform each file into a new file beside the original, how you transform from a source tree to a destination tree, and so on.