Auto merge of #31378 - nagisa:target-man, r=alexcrichton

Author: bors

man/rustc.1

@@ -53,10 +53,9 @@ Comma separated list of types of crates for the compiler to emit.
 Specify the name of the crate being built.
 .TP
 \fB\-\-emit\fR [asm|llvm\-bc|llvm\-ir|obj|link|dep\-info][=\fIPATH\fR]
-Configure the output that \fBrustc\fR will produce.
-
-Each emission may also have an optional explicit output \fIPATH\fR specified for that particular
-emission kind. This path takes precedence over the \fB-o\fR option.
+Configure the output that \fBrustc\fR will produce. Each emission may also have
+an optional explicit output \fIPATH\fR specified for that particular emission
+kind. This path takes precedence over the \fB-o\fR option.
 .TP
 \fB\-\-print\fR [crate\-name|file\-names|sysroot]
 Comma separated list of compiler information to print on stdout.
@@ -68,13 +67,11 @@ Equivalent to \fI\-C\ debuginfo=2\fR.
 Equivalent to \fI\-C\ opt\-level=2\fR.
 .TP
 \fB\-o\fR \fIFILENAME\fR
-Write output to \fIFILENAME\fR.
-Ignored if multiple \fI\-\-emit\fR outputs are specified which don't have an
-explicit path otherwise.
+Write output to \fIFILENAME\fR. Ignored if multiple \fI\-\-emit\fR outputs are specified which
+don't have an explicit path otherwise.
 .TP
 \fB\-\-out\-dir\fR \fIDIR\fR
-Write output to compiler\[hy]chosen filename in \fIDIR\fR.
-Ignored if \fI\-o\fR is specified.
+Write output to compiler\[hy]chosen filename in \fIDIR\fR. Ignored if \fI\-o\fR is specified.
 Defaults to the current directory.
 .TP
 \fB\-\-explain\fR \fIOPT\fR
@@ -83,12 +80,26 @@ Provide a detailed explanation of an error message.
 \fB\-\-test\fR
 Build a test harness.
 .TP
-\fB\-\-target\fR \fITRIPLE\fR
-Target triple \fIcpu\fR\-\fImanufacturer\fR\-\fIkernel\fR[\-\fIos\fR]
-to compile for (see chapter 3.4 of
-.UR http://www.sourceware.org/autobook/
-.UE
-for details).
+\fB\-\-target\fR \fITARGET\fR
+Target triple for which the code is compiled. This option defaults to the host’s target
+triple. The target triple has the general format <arch><sub>\-<vendor>\-<sys>\-<abi>, where:
+.RS
+.TP
+.B <arch>
+x86, arm, thumb, mips, etc.
+.TP
+.B <sub>
+for example on ARM: v5, v6m, v7a, v7m, etc.
+.TP
+.B <vendor>
+pc, apple, nvidia, ibm, etc.
+.TP
+.B <sys>
+none, linux, win32, darwin, cuda, etc.
+.TP
+.B <abi>
+eabi, gnu, android, macho, elf, etc.
+.RE
 .TP
 \fB\-W help\fR
 Print 'lint' options and default settings.

src/librustc/session/config.rs

@@ -845,11 +845,7 @@ pub fn rustc_short_optgroups() -> Vec<RustcOptGroup> {
         opt::opt("", "explain", "Provide a detailed explanation of an error \
                                message", "OPT"),
         opt::flag("", "test", "Build a test harness"),
-        opt::opt("", "target", "Target triple cpu-manufacturer-kernel[-os] \
-                              to compile for (see chapter 3.4 of \
-                              http://www.sourceware.org/autobook/
-                              for details)",
-               "TRIPLE"),
+        opt::opt("", "target", "Target triple for which the code is compiled", "TARGET"),
         opt::multi("W", "warn", "Set lint warnings", "OPT"),
         opt::multi("A", "allow", "Set lint allowed", "OPT"),
         opt::multi("D", "deny", "Set lint denied", "OPT"),