add documentation for multi-argument behavior