manpage out of date

[rillian]

In the 1.0.0 release (and master) the rustc and rustdoc man pages say they document version '0.13.0 March 2014'.

Looks like some of the contents are stable as well, e.g. the rust manpage suggests '-C target-cpu=help' for which rustc --help gives 'llc -mcpu=help'.

[emberian]

@rillian would you like to send a PR updating the man page (they're in https://github.com/rust-lang/rust/tree/master/man), or should someone else?

[rillian]

I prepared pull requests. We should probably figure out a way to update or generate these as part of the build though.

[brson]

Yeah, it least using a template to plugin the version number automatically would help.

[steveklabnik]

Changing to A-build as the immediate documenation situation has been addressed.

[sanmai-NL]

Current master has a man page title as if it's still Rust 1.2.0.

rust/man/rustc.1

Line 1 in a76698b

.TH RUSTC "1" "August 2015" "rustc 1.2.0" "User Commands"

@steveklabnik, is there perhaps work underway, planned or desired to autoproduce the man pages?

[brson]

@sanmai-NL, there's no such effort underway.

As a first step, I'd be interested in a patch that just fills in the version automatically.

In the long-term I'm not sure if producing the full man pages is desirable or not, but relates to the problem of man pages being useless on windows.

A reason the man pages aren't updated much may be that they are rarely seen. If this information was written as part of the published documentation, so more people could use it, then converted to man pages it may get more contributions.

[steveklabnik]

IIRC, there was some work in Cargo to do generated manpages.