Skip to content

Commit e2eb4b8

Browse files
committed
---
yaml --- r: 190047 b: refs/heads/auto c: 3ac89d3 h: refs/heads/master i: 190045: 40b08a1 190043: d7fb503 190039: 0770af0 190031: 7633607 190015: c8a2ab0 v: v3
1 parent f3eb1db commit e2eb4b8

File tree

151 files changed

+1468
-1877
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

151 files changed

+1468
-1877
lines changed

[refs]

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ refs/tags/release-0.3: b5f0d0f648d9a6153664837026ba1be43d3e2503
1010
refs/tags/release-0.3.1: 495bae036dfe5ec6ceafd3312b4dca48741e845b
1111
refs/tags/release-0.4: e828ea2080499553b97dfe33b3f4d472b4562ad7
1212
refs/tags/release-0.5: 7e3bcfbf21278251ee936ad53e92e9b719702d73
13-
refs/heads/auto: 21b024ae278dcfde9169071b9d01595a24c85c84
13+
refs/heads/auto: 3ac89d372faf888e2482ac4a07c991e26f737259
1414
refs/heads/servo: af82457af293e2a842ba6b7759b70288da276167
1515
refs/tags/release-0.6: b4ebcfa1812664df5e142f0134a5faea3918544c
1616
refs/tags/0.1: b19db808c2793fe2976759b85a355c3ad8c8b336

branches/auto/configure

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -701,8 +701,8 @@ probe CFG_ADB adb
701701

702702
if [ ! -z "$CFG_PANDOC" ]
703703
then
704-
# Extract "MAJOR MINOR" from Pandoc's version number
705704
PV_MAJOR_MINOR=$(pandoc --version | grep '^pandoc' |
705+
# Extract "MAJOR MINOR" from Pandoc's version number
706706
sed -E 's/pandoc(.exe)? ([0-9]+)\.([0-9]+).*/\2 \3/')
707707

708708
MIN_PV_MAJOR="1"

branches/auto/man/rustc.1

Lines changed: 112 additions & 155 deletions
Original file line numberDiff line numberDiff line change
@@ -7,267 +7,224 @@ rustc \- The Rust compiler
77

88
.SH DESCRIPTION
99
This program is a compiler for the Rust language, available at
10-
.UR https://www.rust\-lang.org
11-
.UE .
10+
<\fBhttps://www.rust-lang.org\fR>.
1211

1312
.SH OPTIONS
1413

1514
.TP
1615
\fB\-h\fR, \fB\-\-help\fR
17-
Display the help message.
16+
Display the help message
1817
.TP
19-
\fB\-\-cfg\fR \fISPEC\fR
20-
Configure the compilation environment.
18+
\fB\-\-cfg\fR SPEC
19+
Configure the compilation environment
2120
.TP
22-
\fB\-L\fR [\fIKIND\fR=]\fIPATH\fR
23-
Add a directory to the library search path.
24-
The optional \fIKIND\fR can be one of:
25-
.RS
21+
\fB\-L\fR [KIND=]PATH
22+
Add a directory to the library search path. The optional KIND can be one of:
23+
dependency = only lookup transitive dependencies here
24+
crate = only lookup local `extern crate` directives here
25+
native = only lookup native libraries here
26+
framework = only look for OSX frameworks here
27+
all = look for anything here (the default)
2628
.TP
27-
\fBdependency\fR
28-
only lookup transitive dependencies here
29+
\fB\-l\fR [KIND=]NAME
30+
Link the generated crate(s) to the specified native library NAME. The optional
31+
KIND can be one of, static, dylib, or framework. If omitted, dylib is assumed.
2932
.TP
30-
.B crate
31-
only lookup local `extern crate` directives here
33+
\fB\-\-crate-type\fR [bin|lib|rlib|dylib|staticlib]
34+
Comma separated list of types of crates for the compiler to emit
3235
.TP
33-
.B native
34-
only lookup native libraries here
36+
\fB\-\-crate-name NAME\fR
37+
Specify the name of the crate being built
3538
.TP
36-
.B framework
37-
only look for OSX frameworks here
39+
\fB\-\-emit\fR [asm|llvm-bc|llvm-ir|obj|link|dep-info]
40+
Configure the output that rustc will produce
3841
.TP
39-
.B all
40-
look for anything here (the default)
41-
.RE
42-
.TP
43-
\fB\-l\fR [\fIKIND\fR=]\fINAME\fR
44-
Link the generated crate(s) to the specified native library \fINAME\fR.
45-
The optional \fIKIND\fR can be one of \fIstatic\fR, \fIdylib\fR, or
46-
\fIframework\fR.
47-
If omitted, \fIdylib\fR is assumed.
48-
.TP
49-
\fB\-\-crate\-type\fR [bin|lib|rlib|dylib|staticlib]
50-
Comma separated list of types of crates for the compiler to emit.
51-
.TP
52-
\fB\-\-crate\-name\fR \fINAME\fR
53-
Specify the name of the crate being built.
54-
.TP
55-
\fB\-\-emit\fR [asm|llvm\-bc|llvm\-ir|obj|link|dep\-info]
56-
Configure the output that \fBrustc\fR will produce.
57-
.TP
58-
\fB\-\-print\fR [crate\-name|file\-names|sysroot]
59-
Comma separated list of compiler information to print on stdout.
42+
\fB\-\-print\fR [crate-name|file-names|sysroot]
43+
Comma separated list of compiler information to print on stdout
6044
.TP
6145
\fB\-g\fR
62-
Equivalent to \fI\-C\ debuginfo=2\fR.
46+
Equivalent to \fI\-C\fR debuginfo=2
6347
.TP
6448
\fB\-O\fR
65-
Equivalent to \fI\-C\ opt\-level=2\fR.
49+
Equivalent to \fI\-C\fR opt-level=2
6650
.TP
67-
\fB\-o\fR \fIFILENAME\fR
68-
Write output to \fIFILENAME\fR.
69-
Ignored if multiple \fI\-\-emit\fR outputs are specified.
51+
\fB\-o\fR FILENAME
52+
Write output to <filename>. Ignored if multiple \fI\-\-emit\fR outputs are
53+
specified.
7054
.TP
71-
\fB\-\-out\-dir\fR \fIDIR\fR
72-
Write output to compiler\[hy]chosen filename in \fIDIR\fR.
73-
Ignored if \fI\-o\fR is specified.
74-
Defaults to the current directory.
55+
\fB\-\-out\-dir\fR DIR
56+
Write output to compiler-chosen filename in <dir>. Ignored if \fI\-o\fR is
57+
specified. Defaults to the current directory.
7558
.TP
76-
\fB\-\-explain\fR \fIOPT\fR
77-
Provide a detailed explanation of an error message.
59+
\fB\-\-explain\fR OPT
60+
Provide a detailed explanation of an error message
7861
.TP
7962
\fB\-\-test\fR
80-
Build a test harness.
63+
Build a test harness
8164
.TP
82-
\fB\-\-target\fR \fITRIPLE\fR
83-
Target triple \fIcpu\fR\-\fImanufacturer\fR\-\fIkernel\fR[\-\fIos\fR]
84-
to compile for (see chapter 3.4 of
85-
.UR http://www.sourceware.org/autobook/
86-
.UE
87-
for details).
65+
\fB\-\-target\fR TRIPLE
66+
Target triple cpu-manufacturer-kernel[-os] to compile for (see chapter 3.4 of
67+
http://www.sourceware.org/autobook/ for details)
8868
.TP
89-
\fB\-W help\fR
90-
Print 'lint' options and default settings.
69+
\fB\-W\fR help
70+
Print 'lint' options and default settings
9171
.TP
92-
\fB\-W\fR \fIOPT\fR, \fB\-\-warn\fR \fIOPT\fR
93-
Set lint warnings.
72+
\fB\-W\fR OPT, \fB\-\-warn\fR OPT
73+
Set lint warnings
9474
.TP
95-
\fB\-A\fR \fIOPT\fR, \fB\-\-allow\fR \fIOPT\fR
96-
Set lint allowed.
75+
\fB\-A\fR OPT, \fB\-\-allow\fR OPT
76+
Set lint allowed
9777
.TP
98-
\fB\-D\fR \fIOPT\fR, \fB\-\-deny\fR \fIOPT\fR
99-
Set lint denied.
78+
\fB\-D\fR OPT, \fB\-\-deny\fR OPT
79+
Set lint denied
10080
.TP
101-
\fB\-F\fR \fIOPT\fR, \fB\-\-forbid\fR \fIOPT\fR
102-
Set lint forbidden.
81+
\fB\-F\fR OPT, \fB\-\-forbid\fR OPT
82+
Set lint forbidden
10383
.TP
104-
\fB\-C\fR \fIFLAG\fR[=\fIVAL\fR], \fB\-\-codegen\fR \fIFLAG\fR[=\fIVAL\fR]
105-
Set a codegen\[hy]related flag to the value specified.
106-
Use \fI\-C help\fR to print available flags.
107-
See CODEGEN OPTIONS below.
84+
\fB\-C\fR FLAG[=VAL], \fB\-\-codegen\fR FLAG[=VAL]
85+
Set a codegen-related flag to the value specified. Use "-C help" to print
86+
available flags. See CODEGEN OPTIONS below
10887
.TP
10988
\fB\-V\fR, \fB\-\-version\fR
110-
Print version info and exit.
89+
Print version info and exit
11190
.TP
11291
\fB\-v\fR, \fB\-\-verbose\fR
113-
Use verbose output.
92+
Use verbose output
11493
.TP
115-
\fB\-\-extern\fR \fINAME\fR=\fIPATH\fR
116-
Specify where an external rust library is located.
94+
\fB\-\-extern\fR NAME=PATH
95+
Specify where an external rust library is located
11796
.TP
118-
\fB\-\-sysroot\fR \fIPATH\fR
119-
Override the system root.
97+
\fB\-\-sysroot\fR PATH
98+
Override the system root
12099
.TP
121-
\fB\-Z\fR \fIFLAG\fR
122-
Set internal debugging options.
123-
Use \fI\-Z help\fR to print available options.
100+
\fB\-Z\fR FLAG
101+
Set internal debugging options. Use "-Z help" to print available options.
124102
.TP
125103
\fB\-\-color\fR auto|always|never
126104
Configure coloring of output:
127-
.RS
128-
.TP
129-
.B auto
130-
colorize, if output goes to a tty (default);
131-
.TP
132-
.B always
133-
always colorize output;
134-
.TP
135-
.B never
136-
never colorize output.
137-
.RE
105+
auto = colorize, if output goes to a tty (default);
106+
always = always colorize output;
107+
never = never colorize output
138108

139109
.SH CODEGEN OPTIONS
140110

141111
.TP
142-
\fBar\fR=\fI/path/to/ar\fR
112+
\fBar\fR=/path/to/ar
143113
Path to the archive utility to use when assembling archives.
144114
.TP
145-
\fBlinker\fR=\fI/path/to/cc\fR
115+
\fBlinker\fR=/path/to/cc
146116
Path to the linker utility to use when linking libraries, executables, and
147117
objects.
148118
.TP
149-
\fBlink\-args\fR='\fI\-flag1 \-flag2\fR'
150-
A space\[hy]separated list of extra arguments to pass to the linker when the linker
119+
\fBlink-args\fR='-flag1 -flag2'
120+
A space-separated list of extra arguments to pass to the linker when the linker
151121
is invoked.
152122
.TP
153123
\fBlto\fR
154-
Perform LLVM link\[hy]time optimizations.
124+
Perform LLVM link-time optimizations.
155125
.TP
156-
\fBtarget\-cpu\fR=\fIhelp\fR
157-
Selects a target processor.
158-
If the value is 'help', then a list of available CPUs is printed.
126+
\fBtarget-cpu\fR=help
127+
Selects a target processor. If the value is 'help', then a list of available
128+
CPUs is printed.
159129
.TP
160-
\fBtarget\-feature\fR='\fI+feature1\fR,\fI\-feature2\fR'
161-
A comma\[hy]separated list of features to enable or disable for the target.
162-
A preceding '+' enables a feature while a preceding '\-' disables it.
163-
Available features can be discovered through \fItarget\-cpu=help\fR.
130+
\fBtarget-feature\fR='+feature1,-feature2'
131+
A comma-separated list of features to enable or disable for the target. A
132+
preceding '+' enables a feature while a preceding '-' disables it. Available
133+
features can be discovered through target-cpu=help.
164134
.TP
165-
\fBpasses\fR=\fIval\fR
166-
A space\[hy]separated list of extra LLVM passes to run.
167-
A value of 'list' will cause \fBrustc\fR to print all known passes and
168-
exit.
169-
The passes specified are appended at the end of the normal pass manager.
135+
\fBpasses\fR=list
136+
A space-separated list of extra LLVM passes to run. A value of 'list' will
137+
cause rustc to print all known passes and exit. The passes specified are
138+
appended at the end of the normal pass manager.
170139
.TP
171-
\fBllvm\-args\fR='\fI\-arg1\fR \fI\-arg2\fR'
172-
A space\[hy]separated list of arguments to pass through to LLVM.
140+
\fBllvm-args\fR='-arg1 -arg2'
141+
A space-separated list of arguments to pass through to LLVM.
173142
.TP
174-
\fBsave\-temps\fR
175-
If specified, the compiler will save more files (.bc, .o, .no\-opt.bc) generated
143+
\fBsave-temps\fR
144+
If specified, the compiler will save more files (.bc, .o, .no-opt.bc) generated
176145
throughout compilation in the output directory.
177146
.TP
178147
\fBrpath\fR
179148
If specified, then the rpath value for dynamic libraries will be set in
180149
either dynamic library or executable outputs.
181150
.TP
182-
\fBno\-prepopulate\-passes\fR
183-
Suppresses pre\[hy]population of the LLVM pass manager that is run over the module.
151+
\fBno-prepopulate-passes\fR
152+
Suppresses pre-population of the LLVM pass manager that is run over the module.
184153
.TP
185-
\fBno\-vectorize\-loops\fR
154+
\fBno-vectorize-loops\fR
186155
Suppresses running the loop vectorization LLVM pass, regardless of optimization
187156
level.
188157
.TP
189-
\fBno\-vectorize\-slp\fR
158+
\fBno-vectorize-slp\fR
190159
Suppresses running the LLVM SLP vectorization pass, regardless of optimization
191160
level.
192161
.TP
193-
\fBsoft\-float\fR
162+
\fBsoft-float\fR
194163
Generates software floating point library calls instead of hardware
195164
instructions.
196165
.TP
197-
\fBprefer\-dynamic\fR
166+
\fBprefer-dynamic\fR
198167
Prefers dynamic linking to static linking.
199168
.TP
200-
\fBno\-integrated\-as\fR
169+
\fBno-integrated-as\fR
201170
Force usage of an external assembler rather than LLVM's integrated one.
202171
.TP
203-
\fBno\-redzone\fR
172+
\fBno-redzone\fR
204173
Disable the use of the redzone.
205174
.TP
206-
\fBrelocation\-model\fR=[pic,static,dynamic\-no\-pic]
207-
The relocation model to use.
208-
(Default: \fIpic\fR)
175+
\fBrelocation-model\fR=[pic,static,dynamic-no-pic]
176+
The relocation model to use. (Default: pic)
209177
.TP
210-
\fBcode\-model\fR=[small,kernel,medium,large]
178+
\fBcode-model\fR=[small,kernel,medium,large]
211179
Choose the code model to use.
212180
.TP
213-
\fBmetadata\fR=\fIval\fR
181+
\fBmetadata\fR=val
214182
Metadata to mangle symbol names with.
215183
.TP
216-
\fBextra\-filename\fR=\fIval\fR
184+
\fBextra-filename\fR=val
217185
Extra data to put in each output filename.
218186
.TP
219-
\fBcodegen\-units\fR=\fIn\fR
220-
Divide crate into \fIn\fR units to optimize in parallel.
187+
\fBcodegen-units\fR=val
188+
Divide crate into N units to optimize in parallel.
221189
.TP
222-
\fBremark\fR=\fIval\fR
190+
\fBremark\fR=val
223191
Print remarks for these optimization passes (space separated, or "all").
224192
.TP
225-
\fBno\-stack\-check\fR
226-
Disable checks for stack exhaustion (a memory\[hy]safety hazard!).
193+
\fBno-stack-check\fR
194+
Disable checks for stack exhaustion (a memory-safety hazard!).
227195
.TP
228-
\fBdebuginfo\fR=\fIval\fR
196+
\fBdebuginfo\fR=val
229197
Debug info emission level:
230-
.RS
231-
.TP
232-
.B 0
233-
no debug info;
234-
.TP
235-
.B 1
236-
line\[hy]tables only (for stacktraces and breakpoints);
237-
.TP
238-
.B 2
239-
full debug info with variable and type information.
240-
.RE
198+
0 = no debug info;
199+
1 = line-tables only (for stacktraces and breakpoints);
200+
2 = full debug info with variable and type information.
241201
.TP
242-
\fBopt\-level\fR=\fIVAL\fR
243-
Optimize with possible levels 0\[en]3
202+
\fBopt-level\fR=val
203+
Optimize with possible levels 0-3
244204

245205
.SH "EXAMPLES"
246206
To build an executable from a source file with a main function:
247-
$ rustc \-o hello hello.rs
207+
$ rustc -o hello hello.rs
248208

249209
To build a library from a source file:
250-
$ rustc \-\-crate\-type=lib hello\-lib.rs
210+
$ rustc --crate-type=lib hello-lib.rs
251211

252212
To build either with a crate (.rs) file:
253213
$ rustc hello.rs
254214

255215
To build an executable with debug info:
256-
$ rustc \-g \-o hello hello.rs
216+
$ rustc -g -o hello hello.rs
257217

258218
.SH "SEE ALSO"
259219

260-
.BR rustdoc (1)
220+
rustdoc
261221

262222
.SH "BUGS"
263-
See
264-
.UR https://github.com/rust\-lang/rust/issues
265-
.UE
266-
for issues.
223+
See <\fBhttps://github.com/rust-lang/rust/issues\fR> for issues.
267224

268225
.SH "AUTHOR"
269-
See \fIAUTHORS.txt\fR in the Rust source distribution.
226+
See \fBAUTHORS.txt\fR in the Rust source distribution.
270227

271228
.SH "COPYRIGHT"
272-
This work is dual\[hy]licensed under Apache\ 2.0 and MIT terms.
273-
See \fICOPYRIGHT\fR file in the rust source distribution.
229+
This work is dual-licensed under Apache 2.0 and MIT terms. See \fBCOPYRIGHT\fR
230+
file in the rust source distribution.

0 commit comments

Comments
 (0)