how on earth do I get --output <FILE> to do what it's meant to?

There's no easily findable information here properly explaining anything useful about it