cleaned up flag use, added documentation for -to

`up` and `down` have documentation describing
the exact way that the `-to` flag affects both
of them.