about summary refs log tree commit diff
path: root/man/rustc.1
AgeCommit message (Collapse)AuthorLines
2017-09-08Move the man directory to a subdirectoryest31-307/+0
There is no reason it should be in the top directory.
2017-04-14add 'mir' as part of the --emit flag list in rustc --help menu and man doc.nate-1/+1
This is added because 'rustc' can now generate MIR (referencing to "Teach rustc --emit=mir #39891").
2016-08-31Update man pagesStefan Schindler-1/+1
2016-08-13Auto merge of #35414 - jupp0r:feature/test-threads-flag, r=alexcrichtonbors-1/+2
Add --test-threads option to test binaries This change allows parallelism of test runs to be specified by a command line flag names --test-threads in addition to the existing environment variable RUST_TEST_THREADS. Fixes #25636.
2016-08-07Add --test-threads option to test binariesJupp Müller-1/+2
This change allows parallelism of test runs to be specified by a command line flag names --test-threads in addition to the existing environment variable RUST_TEST_THREADS. Fixes #25636.
2016-08-04Update the man page rustc.1Stefan Schindler-2/+2
2016-07-12Mention the crate type cdylib in rustc's usageDridi Boukelmoune-1/+1
2016-03-31allow RUST_BACKTRACE=0 to act as if unsetEmanuel Czirai-2/+2
/# This is a combination of 16 commits. /# The first commit's message is: allow RUST_BACKTRACE=disabled to act as if unset When RUST_BACKTRACE is set to "disabled" then this acts as if the env. var is unset. /# This is the 2nd commit message: case insensitive "DiSaBLeD" RUST_BACKTRACE value previously it expected a lowercase "disabled" to treat the env. var as unset /# This is the 3rd commit message: RUST_BACKTRACE=0 acts as if unset previously RUST_BACKTRACE=disabled was doing the same thing /# This is the 4th commit message: RUST_BACKTRACE=0|n|no|off acts as if unset previously only RUST_BACKTRACE=0 acted as if RUST_BACKTRACE was unset Now added more options (case-insensitive): 'n','no' and 'off' eg. RUST_BACKTRACE=oFF /# This is the 5th commit message: DRY on the value of 2 DRY=don't repeat yourself Because having to remember to keep the two places of '2' in sync is not ideal, even though this is a simple enough case. /# This is the 6th commit message: Revert "DRY on the value of 2" This reverts commit 95a0479d5cf72a2b2d9d21ec0bed2823ed213fef. Nevermind this DRY on 2, because we already have a RY on 1, besides the code is less readable this way... /# This is the 7th commit message: attempt to document unsetting RUST_BACKTRACE /# This is the 8th commit message: curb allocations when checking for RUST_BACKTRACE this means we don't check for case-insensitivity anymore /# This is the 9th commit message: as decided, RUST_BACKTRACE=0 turns off backtrace /# This is the 10th commit message: RUST_TEST_NOCAPTURE=0 acts as if unset (that is, capture is on) Any other value acts as if nocapture is enabled (that is, capture is off) /# This is the 11th commit message: update other RUST_TEST_NOCAPTURE occurrences apparently only one place needs updating /# This is the 12th commit message: update RUST_BACKTRACE in man page /# This is the 13th commit message: handle an occurrence of RUST_BACKTRACE /# This is the 14th commit message: ensure consistency with new rules for backtrace /# This is the 15th commit message: a more concise comment for RUST_TEST_NOCAPTURE /# This is the 16th commit message: update RUST_TEST_NOCAPTURE in man page
2016-02-05Do not .UR in manSimonas Kazlauskas-7/+2
seems to not work on OS X (or requires label, which would make link repeat twice on non-OS X)
2016-02-03Improve wording of --target helpSimonas Kazlauskas-15/+26
2015-12-04Tweak manpage’s emit sectionSimonas Kazlauskas-4/+5
2015-09-30rustc: Support output filenames for each emit typeAlex Crichton-2/+5
Currently the compiler supports the ability to emit multiple output types as part of one compilation (e.g. asm, LLVM IR, bytecode, link, dep-info, etc). It does not, however, support the ability to customize the output filename for each of these output types. The `-o` flag is ignored if multiple emit types are specified (and the compiler emits a warning about this). Normally this doesn't matter too much, but in the case of `dep-info` it can lead to a number of problems (e.g. see #28716). By allowing customization of the output filename for each emit type we're able to solve the problems in that issue. This commit adds support for the `--emit` option to the compiler to look like: rustc foo.rs --emit dep-info=.deps/foo.d,link This indicates that the `dep-info` output type will be placed at `.deps/foo.d` and the `link` output type will otherwise be determined via the `--out-dir` and `-o` flags. Closes #28716
2015-08-18Make distinction between -l and --extern more clearSteve Klabnik-2/+3
Fixes #27686
2015-05-26Update rustc manpage.Ralph Giles-1/+1
rustc -C target-cpu=help is no longer supported. Recommend the llc tool intead like 'rustc --help'.
2015-05-26Bump manpage date and version for 1.2.0-dev.Ralph Giles-1/+1
Estimating August as the release date for 1.2.0.
2015-03-20environment variables -> environmentSteve Klabnik-1/+1
As @sanxiyn says, https://github.com/rust-lang/rust/pull/23527#issuecomment-83835448
2015-03-19Document environment variablesSteve Klabnik-0/+22
Fixes #16330
2015-02-26rustc.1: lowercase codegen replaceable optionsAngus Lees-10/+10
This is more consistent with `rustc -C help` output.
2015-02-26Standardize manpage markupAngus Lees-112/+155
Use consistent markup between rust and rustdoc manpages. Avoid use of the troublesome unquoted '-' troff character.
2015-02-04rustc: Recognize `-L framework=foo`Alex Crichton-4/+9
On OSX the linker has a separate framework lookup path which is specified via the `-F` flag. This adds a new kind of `-L` path recognized by the compiler for frameworks to be passed through to the linker. Closes #20259
2015-01-03Man page/--help dialog fixIvan Petkov-1/+1
* Running rustc with the --print option will accept "file-names" but not "output-file-names"
2014-12-22Update man page with the new optionsSimonas Kazlauskas-52/+79
This pull request updates the rustc manual page to represent post-#19900 state of rustc options better. A bit unrelatedly, --help output is changed to fix some issues too: * -g and -O descriptions were changed from deprected flags to the new codegen flags. * dep-info value was moved from crate-type to emit flag. Fixes #20111 Fixes #20131
2014-10-10auto merge of #17793 : simias/rust/master, r=huonwbors-2/+2
The man page stated that the list of features was space-separated when it's actually comma-separated.
2014-10-09Bump version to 0.13.0Brian Anderson-1/+1
2014-10-05Fix target-feature codegen option syntax in rustc man page.Lionel Flandrin-2/+2
The man page stated that the list of features was space-separated when it's actually comma-separated.
2014-09-15mk: Update how the build deals with version labels. #16677Brian Anderson-1/+1
Adds a new configure flag, --release-channel, which determines how the version number should be augmented with a release label, as well as how the distribution artifacts will be named. This is entirely for use by the build automation. --release-channel can be either 'source', 'nightly', 'beta', or 'stable'. Here's a summary of the affect of these values on version number and artifact naming, respectively: * source - '0.12.0-pre', 'rust-0.12.0-pre-...' * nightly - '0.12.0-nightly', 'rust-nightly-...' * beta - '0.12.0-beta', 'rust-beta-...' * stable - '0.12.0', 'rust-0.12.0-...' Per http://discuss.rust-lang.org/t/rfc-impending-changes-to-the-release-process/508/1
2014-07-16rustc.1: fix typoPhilipp Gesang-1/+1
Uses the same wording as ``config.rs`` now.
2014-07-12auto merge of #15610 : brson/rust/0.12.0, r=alexcrichtonbors-1/+1
2014-07-12auto merge of #15607 : lucidd/rust/master, r=pnkfelixbors-2/+3
I used the same description rustc --help outputs.
2014-07-11Bump version to 0.12.0-preBrian Anderson-1/+1
2014-07-11Add rustc --pretty flowgraph to man pageKevin Walter-2/+3
2014-07-10Some documentation fixes and improvementsYuri Albuquerque-0/+3
2014-07-08auto merge of #14832 : alexcrichton/rust/no-rpath, r=brsonbors-2/+2
This commit disables rustc's emission of rpath attributes into dynamic libraries and executables by default. The functionality is still preserved, but it must now be manually enabled via a `-C rpath` flag. This involved a few changes to the local build system: * --disable-rpath is now the default configure option * Makefiles now prefer our own LD_LIBRARY_PATH over the user's LD_LIBRARY_PATH in order to support building rust with rust already installed. * The compiletest program was taught to correctly pass through the aux dir as a component of LD_LIBRARY_PATH in more situations. The major impact of this change is that neither rustdoc nor rustc will work out-of-the-box in all situations because they are dynamically linked. It must be arranged to ensure that the libraries of a rust installation are part of the LD_LIBRARY_PATH. The default installation paths for all platforms ensure this, but if an installation is in a nonstandard location, then configuration may be necessary. Additionally, for all developers of rustc, it will no longer be possible to run $target/stageN/bin/rustc out-of-the-box. The old behavior can be regained through the `--enable-rpath` option to the configure script. This change brings linux/mac installations in line with windows installations where rpath is not possible. Closes #11747 [breaking-change]
2014-06-27Update to 0.11.0 0.11.0Alex Crichton-1/+1
2014-06-16rustc: Disable rpath settings by defaultAlex Crichton-2/+2
This commit disables rustc's emission of rpath attributes into dynamic libraries and executables by default. The functionality is still preserved, but it must now be manually enabled via a `-C rpath` flag. This involved a few changes to the local build system: * --disable-rpath is now the default configure option * Makefiles now prefer our own LD_LIBRARY_PATH over the user's LD_LIBRARY_PATH in order to support building rust with rust already installed. * The compiletest program was taught to correctly pass through the aux dir as a component of LD_LIBRARY_PATH in more situations. The major impact of this change is that neither rustdoc nor rustc will work out-of-the-box in all situations because they are dynamically linked. It must be arranged to ensure that the libraries of a rust installation are part of the LD_LIBRARY_PATH. The default installation paths for all platforms ensure this, but if an installation is in a nonstandard location, then configuration may be necessary. Additionally, for all developers of rustc, it will no longer be possible to run $target/stageN/bin/rustc out-of-the-box. The old behavior can be regained through the `--enable-rpath` option to the configure script. This change brings linux/mac installations in line with windows installations where rpath is not possible. Closes #11747 [breaking-change]
2014-06-16Update repo locationBrian Anderson-1/+1
2014-05-14Get rid of the android-cross-path flag to rustc.Luqman Aden-3/+0
There's no need to include this specific flag just for android. We can already deal with what it tries to solve by using -C linker=/path/to/cc and -C ar=/path/to/ar. The Makefiles for rustc already set this up when we're crosscompiling. I did add the flag to compiletest though so it can find gdb. Though, I'm pretty sure we don't run debuginfo tests on android anyways right now. [breaking-change]
2014-05-12Fix typos in rustc manpageAlexandre Gagnon-3/+3
2014-04-17auto merge of #13557 : FlaPer87/rust/ls-behind-z, r=brsonbors-3/+0
Closes #13549
2014-04-16auto merge of #13550 : brson/rust/man, r=alexcrichtonbors-6/+17
--no-analysis, --dep-info, -C relocation-model, remove --gen-crate-map
2014-04-16man: Add missing options to rustc.1Brian Anderson-6/+17
2014-04-16Move `--ls` behind `-Z ls`Flavio Percoco-3/+0
Closes #13549
2014-04-15Change AUTHORS section in the man pagesTobias Bucher-2/+1
The man pages no longer contain Graydon Hoare as the project lead. Fix #13509.
2014-04-03Bump version to 0.11-preBrian Anderson-1/+1
This also changes some of the download links in the documentation to 'nightly'.
2014-03-31Bump version to 0.10Alex Crichton-1/+1
2014-03-05Update version and date info in man pagesEduard Bopp-1/+1
Both for rustc and rustdoc the man pages contained out-of-date version info.
2014-02-10Consolidate codegen-related compiler flagsAlex Crichton-22/+76
Move them all behind a new -C switch. This migrates some -Z flags and some top-level flags behind this -C codegen option. The -C flag takes values of the form "-C name=value" where the "=value" is optional for some flags. Flags affected: * --llvm-args => -C llvm-args * --passes => -C passes * --ar => -C ar * --linker => -C linker * --link-args => -C link-args * --target-cpu => -C target-cpu * --target-feature => -C target-fature * --android-cross-path => -C android-cross-path * --save-temps => -C save-temps * --no-rpath => -C no-rpath * -Z no-prepopulate => -C no-prepopulate-passes * -Z no-vectorize-loops => -C no-vectorize-loops * -Z no-vectorize-slp => -C no-vectorize-slp * -Z soft-float => -C soft-float * -Z gen-crate-map => -C gen-crate-map * -Z prefer-dynamic => -C prefer-dynamic * -Z no-integrated-as => -C no-integrated-as As a bonus, this also promotes the -Z extra-debug-info flag to a first class -g or --debuginfo flag. * -Z debug-info => removed * -Z extra-debug-info => -g or --debuginfo Closes #9770 Closes #12000
2014-02-06Redesign output flags for rustcAlex Crichton-16/+8
This commit removes the -c, --emit-llvm, -s, --rlib, --dylib, --staticlib, --lib, and --bin flags from rustc, adding the following flags: * --emit=[asm,ir,bc,obj,link] * --crate-type=[dylib,rlib,staticlib,bin,lib] The -o option has also been redefined to be used for *all* flavors of outputs. This means that we no longer ignore it for libraries. The --out-dir remains the same as before. The new logic for files that rustc emits is as follows: 1. Output types are dictated by the --emit flag. The default value is --emit=link, and this option can be passed multiple times and have all options stacked on one another. 2. Crate types are dictated by the --crate-type flag and the #[crate_type] attribute. The flags can be passed many times and stack with the crate attribute. 3. If the -o flag is specified, and only one output type is specified, the output will be emitted at this location. If more than one output type is specified, then the filename of -o is ignored, and all output goes in the directory that -o specifies. The -o option always ignores the --out-dir option. 4. If the --out-dir flag is specified, all output goes in this directory. 5. If -o and --out-dir are both not present, all output goes in the current directory of the process. 6. When multiple output types are specified, the filestem of all output is the same as the name of the CrateId (derived from a crate attribute or from the filestem of the crate file). Closes #7791 Closes #11056 Closes #11667
2014-02-02Remove rustpkg.Corey Richardson-1/+1
I'm sorry :'( Closes #11859
2014-01-22remove old rc extension from detection filesDaniel Micay-2/+2