Flag: output path

[steveklabnik]

This issue is part of #125

-o/--output: output path

Using this flag looks like this:

$ rustdoc src/lib.rs -o target\\doc
$ rustdoc src/lib.rs --output target\\doc

By default, rustdoc's output appears in a directory named doc in
the current working directory. With this flag, it will place all output
into the directory you specify.

---

Should we keep this flag or not?

[steveklabnik]

This seems important to keep.

Our default is different than this one; we assume Cargo and write to target/doc. Today's Cargo passes this flag to rustdoc to write to that location, and rustdoc defaults to ./doc.

[euclio]

Looks like -o is already claimed by rustdoc build --open.

[mgattozzi]

Maybe just leave --open as a long flag only and have -o/--output be the other flags? Conventionally for many compilers and programs -o is used for output directories

[steveklabnik]

Yes, we should leave --open as a long flag only, and take -o for this.

[hjr3]

There is some inconsistency with manifest-path having -path and --output not having -path. Also, #133 specifies --library-path.