mirror of
https://github.com/rust-lang/rust.git
synced 2024-11-23 15:23:46 +00:00
add -C parameter to rustdoc
This commit is contained in:
parent
3366032ab7
commit
1a0d7a8207
@ -42,7 +42,7 @@ use clean;
|
|||||||
use clean::Clean;
|
use clean::Clean;
|
||||||
use html::render::RenderInfo;
|
use html::render::RenderInfo;
|
||||||
|
|
||||||
pub use rustc::session::config::Input;
|
pub use rustc::session::config::{Input, CodegenOptions};
|
||||||
pub use rustc::session::search_paths::SearchPaths;
|
pub use rustc::session::search_paths::SearchPaths;
|
||||||
|
|
||||||
pub type ExternalPaths = FxHashMap<DefId, (Vec<String>, clean::TypeKind)>;
|
pub type ExternalPaths = FxHashMap<DefId, (Vec<String>, clean::TypeKind)>;
|
||||||
@ -125,7 +125,8 @@ pub fn run_core(search_paths: SearchPaths,
|
|||||||
allow_warnings: bool,
|
allow_warnings: bool,
|
||||||
crate_name: Option<String>,
|
crate_name: Option<String>,
|
||||||
force_unstable_if_unmarked: bool,
|
force_unstable_if_unmarked: bool,
|
||||||
edition: Edition) -> (clean::Crate, RenderInfo)
|
edition: Edition,
|
||||||
|
cg: CodegenOptions) -> (clean::Crate, RenderInfo)
|
||||||
{
|
{
|
||||||
// Parse, resolve, and typecheck the given crate.
|
// Parse, resolve, and typecheck the given crate.
|
||||||
|
|
||||||
@ -143,6 +144,7 @@ pub fn run_core(search_paths: SearchPaths,
|
|||||||
crate_types: vec![config::CrateTypeRlib],
|
crate_types: vec![config::CrateTypeRlib],
|
||||||
lint_opts: if !allow_warnings { vec![(warning_lint, lint::Allow)] } else { vec![] },
|
lint_opts: if !allow_warnings { vec![(warning_lint, lint::Allow)] } else { vec![] },
|
||||||
lint_cap: Some(lint::Allow),
|
lint_cap: Some(lint::Allow),
|
||||||
|
cg,
|
||||||
externs,
|
externs,
|
||||||
target_triple: triple.unwrap_or(host_triple),
|
target_triple: triple.unwrap_or(host_triple),
|
||||||
// Ensure that rustdoc works even if rustc is feature-staged
|
// Ensure that rustdoc works even if rustc is feature-staged
|
||||||
|
@ -63,7 +63,8 @@ use std::sync::mpsc::channel;
|
|||||||
use syntax::edition::Edition;
|
use syntax::edition::Edition;
|
||||||
use externalfiles::ExternalHtml;
|
use externalfiles::ExternalHtml;
|
||||||
use rustc::session::search_paths::SearchPaths;
|
use rustc::session::search_paths::SearchPaths;
|
||||||
use rustc::session::config::{ErrorOutputType, RustcOptGroup, nightly_options, Externs};
|
use rustc::session::config::{ErrorOutputType, RustcOptGroup, Externs, CodegenOptions};
|
||||||
|
use rustc::session::config::{nightly_options, build_codegen_options};
|
||||||
use rustc_back::target::TargetTriple;
|
use rustc_back::target::TargetTriple;
|
||||||
|
|
||||||
#[macro_use]
|
#[macro_use]
|
||||||
@ -157,6 +158,9 @@ pub fn opts() -> Vec<RustcOptGroup> {
|
|||||||
stable("plugin-path", |o| {
|
stable("plugin-path", |o| {
|
||||||
o.optmulti("", "plugin-path", "directory to load plugins from", "DIR")
|
o.optmulti("", "plugin-path", "directory to load plugins from", "DIR")
|
||||||
}),
|
}),
|
||||||
|
stable("C", |o| {
|
||||||
|
o.optmulti("C", "codegen", "pass a codegen option to rustc", "OPT[=VALUE]")
|
||||||
|
}),
|
||||||
stable("passes", |o| {
|
stable("passes", |o| {
|
||||||
o.optmulti("", "passes",
|
o.optmulti("", "passes",
|
||||||
"list of passes to also run, you might want \
|
"list of passes to also run, you might want \
|
||||||
@ -443,14 +447,16 @@ pub fn main_args(args: &[String]) -> isize {
|
|||||||
}
|
}
|
||||||
};
|
};
|
||||||
|
|
||||||
|
let cg = build_codegen_options(&matches, ErrorOutputType::default());
|
||||||
|
|
||||||
match (should_test, markdown_input) {
|
match (should_test, markdown_input) {
|
||||||
(true, true) => {
|
(true, true) => {
|
||||||
return markdown::test(input, cfgs, libs, externs, test_args, maybe_sysroot,
|
return markdown::test(input, cfgs, libs, externs, test_args, maybe_sysroot,
|
||||||
display_warnings, linker, edition)
|
display_warnings, linker, edition, cg)
|
||||||
}
|
}
|
||||||
(true, false) => {
|
(true, false) => {
|
||||||
return test::run(Path::new(input), cfgs, libs, externs, test_args, crate_name,
|
return test::run(Path::new(input), cfgs, libs, externs, test_args, crate_name,
|
||||||
maybe_sysroot, display_warnings, linker, edition)
|
maybe_sysroot, display_warnings, linker, edition, cg)
|
||||||
}
|
}
|
||||||
(false, true) => return markdown::render(Path::new(input),
|
(false, true) => return markdown::render(Path::new(input),
|
||||||
output.unwrap_or(PathBuf::from("doc")),
|
output.unwrap_or(PathBuf::from("doc")),
|
||||||
@ -460,7 +466,7 @@ pub fn main_args(args: &[String]) -> isize {
|
|||||||
}
|
}
|
||||||
|
|
||||||
let output_format = matches.opt_str("w");
|
let output_format = matches.opt_str("w");
|
||||||
let res = acquire_input(PathBuf::from(input), externs, edition, &matches, move |out| {
|
let res = acquire_input(PathBuf::from(input), externs, edition, cg, &matches, move |out| {
|
||||||
let Output { krate, passes, renderinfo } = out;
|
let Output { krate, passes, renderinfo } = out;
|
||||||
info!("going to format");
|
info!("going to format");
|
||||||
match output_format.as_ref().map(|s| &**s) {
|
match output_format.as_ref().map(|s| &**s) {
|
||||||
@ -502,14 +508,15 @@ fn print_error<T>(error_message: T) where T: Display {
|
|||||||
fn acquire_input<R, F>(input: PathBuf,
|
fn acquire_input<R, F>(input: PathBuf,
|
||||||
externs: Externs,
|
externs: Externs,
|
||||||
edition: Edition,
|
edition: Edition,
|
||||||
|
cg: CodegenOptions,
|
||||||
matches: &getopts::Matches,
|
matches: &getopts::Matches,
|
||||||
f: F)
|
f: F)
|
||||||
-> Result<R, String>
|
-> Result<R, String>
|
||||||
where R: 'static + Send, F: 'static + Send + FnOnce(Output) -> R {
|
where R: 'static + Send, F: 'static + Send + FnOnce(Output) -> R {
|
||||||
match matches.opt_str("r").as_ref().map(|s| &**s) {
|
match matches.opt_str("r").as_ref().map(|s| &**s) {
|
||||||
Some("rust") => Ok(rust_input(input, externs, edition, matches, f)),
|
Some("rust") => Ok(rust_input(input, externs, edition, cg, matches, f)),
|
||||||
Some(s) => Err(format!("unknown input format: {}", s)),
|
Some(s) => Err(format!("unknown input format: {}", s)),
|
||||||
None => Ok(rust_input(input, externs, edition, matches, f))
|
None => Ok(rust_input(input, externs, edition, cg, matches, f))
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@ -538,6 +545,7 @@ fn parse_externs(matches: &getopts::Matches) -> Result<Externs, String> {
|
|||||||
fn rust_input<R, F>(cratefile: PathBuf,
|
fn rust_input<R, F>(cratefile: PathBuf,
|
||||||
externs: Externs,
|
externs: Externs,
|
||||||
edition: Edition,
|
edition: Edition,
|
||||||
|
cg: CodegenOptions,
|
||||||
matches: &getopts::Matches,
|
matches: &getopts::Matches,
|
||||||
f: F) -> R
|
f: F) -> R
|
||||||
where R: 'static + Send,
|
where R: 'static + Send,
|
||||||
@ -591,7 +599,7 @@ where R: 'static + Send,
|
|||||||
let (mut krate, renderinfo) =
|
let (mut krate, renderinfo) =
|
||||||
core::run_core(paths, cfgs, externs, Input::File(cratefile), triple, maybe_sysroot,
|
core::run_core(paths, cfgs, externs, Input::File(cratefile), triple, maybe_sysroot,
|
||||||
display_warnings, crate_name.clone(),
|
display_warnings, crate_name.clone(),
|
||||||
force_unstable_if_unmarked, edition);
|
force_unstable_if_unmarked, edition, cg);
|
||||||
|
|
||||||
info!("finished with rustc");
|
info!("finished with rustc");
|
||||||
|
|
||||||
|
@ -16,7 +16,7 @@ use std::path::{PathBuf, Path};
|
|||||||
use getopts;
|
use getopts;
|
||||||
use testing;
|
use testing;
|
||||||
use rustc::session::search_paths::SearchPaths;
|
use rustc::session::search_paths::SearchPaths;
|
||||||
use rustc::session::config::Externs;
|
use rustc::session::config::{Externs, CodegenOptions};
|
||||||
use syntax::codemap::DUMMY_SP;
|
use syntax::codemap::DUMMY_SP;
|
||||||
use syntax::edition::Edition;
|
use syntax::edition::Edition;
|
||||||
|
|
||||||
@ -140,7 +140,8 @@ pub fn render(input: &Path, mut output: PathBuf, matches: &getopts::Matches,
|
|||||||
/// Run any tests/code examples in the markdown file `input`.
|
/// Run any tests/code examples in the markdown file `input`.
|
||||||
pub fn test(input: &str, cfgs: Vec<String>, libs: SearchPaths, externs: Externs,
|
pub fn test(input: &str, cfgs: Vec<String>, libs: SearchPaths, externs: Externs,
|
||||||
mut test_args: Vec<String>, maybe_sysroot: Option<PathBuf>,
|
mut test_args: Vec<String>, maybe_sysroot: Option<PathBuf>,
|
||||||
display_warnings: bool, linker: Option<PathBuf>, edition: Edition) -> isize {
|
display_warnings: bool, linker: Option<PathBuf>, edition: Edition,
|
||||||
|
cg: CodegenOptions) -> isize {
|
||||||
let input_str = match load_string(input) {
|
let input_str = match load_string(input) {
|
||||||
Ok(s) => s,
|
Ok(s) => s,
|
||||||
Err(LoadStringError::ReadFail) => return 1,
|
Err(LoadStringError::ReadFail) => return 1,
|
||||||
@ -150,7 +151,7 @@ pub fn test(input: &str, cfgs: Vec<String>, libs: SearchPaths, externs: Externs,
|
|||||||
let mut opts = TestOptions::default();
|
let mut opts = TestOptions::default();
|
||||||
opts.no_crate_inject = true;
|
opts.no_crate_inject = true;
|
||||||
opts.display_warnings = display_warnings;
|
opts.display_warnings = display_warnings;
|
||||||
let mut collector = Collector::new(input.to_owned(), cfgs, libs, externs,
|
let mut collector = Collector::new(input.to_owned(), cfgs, libs, cg, externs,
|
||||||
true, opts, maybe_sysroot, None,
|
true, opts, maybe_sysroot, None,
|
||||||
Some(PathBuf::from(input)),
|
Some(PathBuf::from(input)),
|
||||||
linker, edition);
|
linker, edition);
|
||||||
|
@ -24,7 +24,7 @@ use rustc_lint;
|
|||||||
use rustc::hir;
|
use rustc::hir;
|
||||||
use rustc::hir::intravisit;
|
use rustc::hir::intravisit;
|
||||||
use rustc::session::{self, CompileIncomplete, config};
|
use rustc::session::{self, CompileIncomplete, config};
|
||||||
use rustc::session::config::{OutputType, OutputTypes, Externs};
|
use rustc::session::config::{OutputType, OutputTypes, Externs, CodegenOptions};
|
||||||
use rustc::session::search_paths::{SearchPaths, PathKind};
|
use rustc::session::search_paths::{SearchPaths, PathKind};
|
||||||
use rustc_metadata::dynamic_lib::DynamicLibrary;
|
use rustc_metadata::dynamic_lib::DynamicLibrary;
|
||||||
use tempdir::TempDir;
|
use tempdir::TempDir;
|
||||||
@ -64,7 +64,8 @@ pub fn run(input_path: &Path,
|
|||||||
maybe_sysroot: Option<PathBuf>,
|
maybe_sysroot: Option<PathBuf>,
|
||||||
display_warnings: bool,
|
display_warnings: bool,
|
||||||
linker: Option<PathBuf>,
|
linker: Option<PathBuf>,
|
||||||
edition: Edition)
|
edition: Edition,
|
||||||
|
cg: CodegenOptions)
|
||||||
-> isize {
|
-> isize {
|
||||||
let input = config::Input::File(input_path.to_owned());
|
let input = config::Input::File(input_path.to_owned());
|
||||||
|
|
||||||
@ -73,6 +74,7 @@ pub fn run(input_path: &Path,
|
|||||||
|| Some(env::current_exe().unwrap().parent().unwrap().parent().unwrap().to_path_buf())),
|
|| Some(env::current_exe().unwrap().parent().unwrap().parent().unwrap().to_path_buf())),
|
||||||
search_paths: libs.clone(),
|
search_paths: libs.clone(),
|
||||||
crate_types: vec![config::CrateTypeDylib],
|
crate_types: vec![config::CrateTypeDylib],
|
||||||
|
cg: cg.clone(),
|
||||||
externs: externs.clone(),
|
externs: externs.clone(),
|
||||||
unstable_features: UnstableFeatures::from_environment(),
|
unstable_features: UnstableFeatures::from_environment(),
|
||||||
lint_cap: Some(::rustc::lint::Level::Allow),
|
lint_cap: Some(::rustc::lint::Level::Allow),
|
||||||
@ -125,6 +127,7 @@ pub fn run(input_path: &Path,
|
|||||||
let mut collector = Collector::new(crate_name,
|
let mut collector = Collector::new(crate_name,
|
||||||
cfgs,
|
cfgs,
|
||||||
libs,
|
libs,
|
||||||
|
cg,
|
||||||
externs,
|
externs,
|
||||||
false,
|
false,
|
||||||
opts,
|
opts,
|
||||||
@ -190,7 +193,7 @@ fn scrape_test_config(krate: &::rustc::hir::Crate) -> TestOptions {
|
|||||||
|
|
||||||
fn run_test(test: &str, cratename: &str, filename: &FileName, line: usize,
|
fn run_test(test: &str, cratename: &str, filename: &FileName, line: usize,
|
||||||
cfgs: Vec<String>, libs: SearchPaths,
|
cfgs: Vec<String>, libs: SearchPaths,
|
||||||
externs: Externs,
|
cg: CodegenOptions, externs: Externs,
|
||||||
should_panic: bool, no_run: bool, as_test_harness: bool,
|
should_panic: bool, no_run: bool, as_test_harness: bool,
|
||||||
compile_fail: bool, mut error_codes: Vec<String>, opts: &TestOptions,
|
compile_fail: bool, mut error_codes: Vec<String>, opts: &TestOptions,
|
||||||
maybe_sysroot: Option<PathBuf>, linker: Option<PathBuf>, edition: Edition) {
|
maybe_sysroot: Option<PathBuf>, linker: Option<PathBuf>, edition: Edition) {
|
||||||
@ -215,7 +218,7 @@ fn run_test(test: &str, cratename: &str, filename: &FileName, line: usize,
|
|||||||
cg: config::CodegenOptions {
|
cg: config::CodegenOptions {
|
||||||
prefer_dynamic: true,
|
prefer_dynamic: true,
|
||||||
linker,
|
linker,
|
||||||
.. config::basic_codegen_options()
|
..cg
|
||||||
},
|
},
|
||||||
test: as_test_harness,
|
test: as_test_harness,
|
||||||
unstable_features: UnstableFeatures::from_environment(),
|
unstable_features: UnstableFeatures::from_environment(),
|
||||||
@ -478,6 +481,7 @@ pub struct Collector {
|
|||||||
|
|
||||||
cfgs: Vec<String>,
|
cfgs: Vec<String>,
|
||||||
libs: SearchPaths,
|
libs: SearchPaths,
|
||||||
|
cg: CodegenOptions,
|
||||||
externs: Externs,
|
externs: Externs,
|
||||||
use_headers: bool,
|
use_headers: bool,
|
||||||
cratename: String,
|
cratename: String,
|
||||||
@ -491,15 +495,16 @@ pub struct Collector {
|
|||||||
}
|
}
|
||||||
|
|
||||||
impl Collector {
|
impl Collector {
|
||||||
pub fn new(cratename: String, cfgs: Vec<String>, libs: SearchPaths, externs: Externs,
|
pub fn new(cratename: String, cfgs: Vec<String>, libs: SearchPaths, cg: CodegenOptions,
|
||||||
use_headers: bool, opts: TestOptions, maybe_sysroot: Option<PathBuf>,
|
externs: Externs, use_headers: bool, opts: TestOptions,
|
||||||
codemap: Option<Lrc<CodeMap>>, filename: Option<PathBuf>,
|
maybe_sysroot: Option<PathBuf>, codemap: Option<Lrc<CodeMap>>,
|
||||||
linker: Option<PathBuf>, edition: Edition) -> Collector {
|
filename: Option<PathBuf>, linker: Option<PathBuf>, edition: Edition) -> Collector {
|
||||||
Collector {
|
Collector {
|
||||||
tests: Vec::new(),
|
tests: Vec::new(),
|
||||||
names: Vec::new(),
|
names: Vec::new(),
|
||||||
cfgs,
|
cfgs,
|
||||||
libs,
|
libs,
|
||||||
|
cg,
|
||||||
externs,
|
externs,
|
||||||
use_headers,
|
use_headers,
|
||||||
cratename,
|
cratename,
|
||||||
@ -524,6 +529,7 @@ impl Collector {
|
|||||||
let name = self.generate_name(line, &filename);
|
let name = self.generate_name(line, &filename);
|
||||||
let cfgs = self.cfgs.clone();
|
let cfgs = self.cfgs.clone();
|
||||||
let libs = self.libs.clone();
|
let libs = self.libs.clone();
|
||||||
|
let cg = self.cg.clone();
|
||||||
let externs = self.externs.clone();
|
let externs = self.externs.clone();
|
||||||
let cratename = self.cratename.to_string();
|
let cratename = self.cratename.to_string();
|
||||||
let opts = self.opts.clone();
|
let opts = self.opts.clone();
|
||||||
@ -552,6 +558,7 @@ impl Collector {
|
|||||||
line,
|
line,
|
||||||
cfgs,
|
cfgs,
|
||||||
libs,
|
libs,
|
||||||
|
cg,
|
||||||
externs,
|
externs,
|
||||||
should_panic,
|
should_panic,
|
||||||
no_run,
|
no_run,
|
||||||
|
21
src/test/rustdoc/force-target-feature.rs
Normal file
21
src/test/rustdoc/force-target-feature.rs
Normal file
@ -0,0 +1,21 @@
|
|||||||
|
// Copyright 2017 The Rust Project Developers. See the COPYRIGHT
|
||||||
|
// file at the top-level directory of this distribution and at
|
||||||
|
// http://rust-lang.org/COPYRIGHT.
|
||||||
|
//
|
||||||
|
// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
|
||||||
|
// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
|
||||||
|
// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
|
||||||
|
// option. This file may not be copied, modified, or distributed
|
||||||
|
// except according to those terms.
|
||||||
|
|
||||||
|
// only-x86_64
|
||||||
|
// compile-flags:--test -C target-feature=+avx
|
||||||
|
// should-fail
|
||||||
|
|
||||||
|
/// (written on a spider's web) Some Struct
|
||||||
|
///
|
||||||
|
/// ```
|
||||||
|
/// panic!("oh no");
|
||||||
|
/// ```
|
||||||
|
#[doc(cfg(target_feature = "avx"))]
|
||||||
|
pub struct SomeStruct;
|
Loading…
Reference in New Issue
Block a user