@@ -685,18 +685,7 @@ impl Step for Rustc {
685685 target,
686686 ) ;
687687
688- // This uses a shared directory so that librustdoc documentation gets
689- // correctly built and merged with the rustc documentation. This is
690- // needed because rustdoc is built in a different directory from
691- // rustc. rustdoc needs to be able to see everything, for example when
692- // merging the search index, or generating local (relative) links.
693688 let out_dir = builder. stage_out ( compiler, Mode :: Rustc ) . join ( target. triple ) . join ( "doc" ) ;
694- t ! ( fs:: create_dir_all( out_dir. parent( ) . unwrap( ) ) ) ;
695- symlink_dir_force ( & builder. config , & out, & out_dir) ;
696- // Cargo puts proc macros in `target/doc` even if you pass `--target`
697- // explicitly (https://github.com/rust-lang/cargo/issues/7677).
698- let proc_macro_out_dir = builder. stage_out ( compiler, Mode :: Rustc ) . join ( "doc" ) ;
699- symlink_dir_force ( & builder. config , & out, & proc_macro_out_dir) ;
700689
701690 // Build cargo command.
702691 let mut cargo = builder. cargo ( compiler, Mode :: Rustc , SourceType :: InTree , target, "doc" ) ;
@@ -736,8 +725,29 @@ impl Step for Rustc {
736725 }
737726 }
738727
728+ // This uses a shared directory so that librustdoc documentation gets
729+ // correctly built and merged with the rustc documentation.
730+ //
731+ // This is needed because rustdoc is built in a different directory from
732+ // rustc. rustdoc needs to be able to see everything, for example when
733+ // merging the search index, or generating local (relative) links.
734+ symlink_dir_force ( & builder. config , & out, & out_dir) ;
735+ // Cargo puts proc macros in `target/doc` even if you pass `--target`
736+ // explicitly (https://github.com/rust-lang/cargo/issues/7677).
737+ let proc_macro_out_dir = builder. stage_out ( compiler, Mode :: Rustc ) . join ( "doc" ) ;
738+ symlink_dir_force ( & builder. config , & out, & proc_macro_out_dir) ;
739+
739740 builder. run ( & mut cargo. into ( ) ) ;
740741
742+ if !builder. config . dry_run ( ) {
743+ // Sanity check on linked compiler crates
744+ for krate in & * self . crates {
745+ let dir_name = krate. replace ( "-" , "_" ) ;
746+ // Making sure the directory exists and is not empty.
747+ assert ! ( out. join( & * dir_name) . read_dir( ) . unwrap( ) . next( ) . is_some( ) ) ;
748+ }
749+ }
750+
741751 if builder. paths . iter ( ) . any ( |path| path. ends_with ( "compiler" ) ) {
742752 // For `x.py doc compiler --open`, open `rustc_middle` by default.
743753 let index = out. join ( "rustc_middle" ) . join ( "index.html" ) ;
@@ -756,10 +766,10 @@ macro_rules! tool_doc {
756766 $should_run: literal,
757767 $path: literal,
758768 $( rustc_tool = $rustc_tool: literal, ) ?
759- $( in_tree = $in_tree: literal, ) ?
760- [ $ ( $extra_arg : literal ) ,+ $ ( , ) ?]
761- $( , ) ?
762- ) => {
769+ $( in_tree = $in_tree: literal , ) ?
770+ $ ( is_library = $is_library : expr , ) ?
771+ $( crates = $crates : expr ) ?
772+ ) => {
763773 #[ derive( Debug , Copy , Clone , Hash , PartialEq , Eq ) ]
764774 pub struct $tool {
765775 target: TargetSelection ,
@@ -818,8 +828,13 @@ macro_rules! tool_doc {
818828 // Cargo uses a different directory for proc macros.
819829 builder. stage_out( compiler, Mode :: ToolRustc ) . join( "doc" ) ,
820830 ] ;
831+
821832 for out_dir in out_dirs {
822- t!( fs:: create_dir_all( & out_dir) ) ;
833+ $( for krate in $crates {
834+ let dir_name = krate. replace( "-" , "_" ) ;
835+ t!( fs:: create_dir_all( & out_dir. join( dir_name) ) ) ;
836+ } ) ?
837+
823838 symlink_dir_force( & builder. config, & out, & out_dir) ;
824839 }
825840
@@ -839,9 +854,13 @@ macro_rules! tool_doc {
839854 // Only include compiler crates, no dependencies of those, such as `libc`.
840855 cargo. arg( "--no-deps" ) ;
841856
842- $(
843- cargo. arg( $extra_arg) ;
844- ) +
857+ if false $( || $is_library) ? {
858+ cargo. arg( "--lib" ) ;
859+ }
860+
861+ $( for krate in $crates {
862+ cargo. arg( "-p" ) . arg( krate) ;
863+ } ) ?
845864
846865 cargo. rustdocflag( "--document-private-items" ) ;
847866 // Since we always pass --document-private-items, there's no need to warn about linking to private items.
@@ -853,60 +872,56 @@ macro_rules! tool_doc {
853872
854873 let _guard = builder. msg_doc( compiler, stringify!( $tool) . to_lowercase( ) , target) ;
855874 builder. run( & mut cargo. into( ) ) ;
875+
876+ if !builder. config. dry_run( ) {
877+ // Sanity check on linked doc directories
878+ $( for krate in $crates {
879+ let dir_name = krate. replace( "-" , "_" ) ;
880+ // Making sure the directory exists and is not empty.
881+ assert!( out. join( & * dir_name) . read_dir( ) . unwrap( ) . next( ) . is_some( ) ) ;
882+ } ) ?
883+ }
856884 }
857885 }
858886 }
859887}
860888
861- tool_doc ! (
862- Rustdoc ,
863- "rustdoc-tool" ,
864- "src/tools/rustdoc" ,
865- [ "-p" , "rustdoc" , "-p" , "rustdoc-json-types" ]
866- ) ;
889+ tool_doc ! ( Rustdoc , "rustdoc-tool" , "src/tools/rustdoc" , crates = [ "rustdoc" , "rustdoc-json-types" ] ) ;
867890tool_doc ! (
868891 Rustfmt ,
869892 "rustfmt-nightly" ,
870893 "src/tools/rustfmt" ,
871- [ "-p" , " rustfmt-nightly", "-p" , " rustfmt-config_proc_macro"] ,
894+ crates = [ " rustfmt-nightly", "rustfmt-config_proc_macro" ]
872895) ;
873- tool_doc ! ( Clippy , "clippy" , "src/tools/clippy" , [ "-p" , "clippy_utils" ] ) ;
874- tool_doc ! ( Miri , "miri" , "src/tools/miri" , [ "-p" , "miri" ] ) ;
896+ tool_doc ! ( Clippy , "clippy" , "src/tools/clippy" , crates = [ "clippy_utils" ] ) ;
897+ tool_doc ! ( Miri , "miri" , "src/tools/miri" , crates = [ "miri" ] ) ;
875898tool_doc ! (
876899 Cargo ,
877900 "cargo" ,
878901 "src/tools/cargo" ,
879902 rustc_tool = false ,
880903 in_tree = false ,
881- [
882- "-p" ,
904+ crates = [
883905 "cargo" ,
884- "-p" ,
885906 "cargo-platform" ,
886- "-p" ,
887907 "cargo-util" ,
888- "-p" ,
889908 "crates-io" ,
890- "-p" ,
891909 "cargo-test-macro" ,
892- "-p" ,
893910 "cargo-test-support" ,
894- "-p" ,
895911 "cargo-credential" ,
896- "-p" ,
897912 "mdman" ,
898913 // FIXME: this trips a license check in tidy.
899- // "-p",
900914 // "resolver-tests",
901915 ]
902916) ;
903- tool_doc ! ( Tidy , "tidy" , "src/tools/tidy" , rustc_tool = false , [ "-p" , "tidy" ] ) ;
917+ tool_doc ! ( Tidy , "tidy" , "src/tools/tidy" , rustc_tool = false , crates = [ "tidy" ] ) ;
904918tool_doc ! (
905919 Bootstrap ,
906920 "bootstrap" ,
907921 "src/bootstrap" ,
908922 rustc_tool = false ,
909- [ "--lib" , "-p" , "bootstrap" ]
923+ is_library = true ,
924+ crates = [ "bootstrap" ]
910925) ;
911926
912927#[ derive( Ord , PartialOrd , Debug , Copy , Clone , Hash , PartialEq , Eq ) ]
0 commit comments