@@ -685,18 +685,7 @@ impl Step for Rustc {
685
685
target,
686
686
) ;
687
687
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.
693
688
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) ;
700
689
701
690
// Build cargo command.
702
691
let mut cargo = builder. cargo ( compiler, Mode :: Rustc , SourceType :: InTree , target, "doc" ) ;
@@ -736,8 +725,29 @@ impl Step for Rustc {
736
725
}
737
726
}
738
727
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
+
739
740
builder. run ( & mut cargo. into ( ) ) ;
740
741
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
+
741
751
if builder. paths . iter ( ) . any ( |path| path. ends_with ( "compiler" ) ) {
742
752
// For `x.py doc compiler --open`, open `rustc_middle` by default.
743
753
let index = out. join ( "rustc_middle" ) . join ( "index.html" ) ;
@@ -756,10 +766,10 @@ macro_rules! tool_doc {
756
766
$should_run: literal,
757
767
$path: literal,
758
768
$( 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
+ ) => {
763
773
#[ derive( Debug , Copy , Clone , Hash , PartialEq , Eq ) ]
764
774
pub struct $tool {
765
775
target: TargetSelection ,
@@ -818,8 +828,13 @@ macro_rules! tool_doc {
818
828
// Cargo uses a different directory for proc macros.
819
829
builder. stage_out( compiler, Mode :: ToolRustc ) . join( "doc" ) ,
820
830
] ;
831
+
832
+ $( for krate in $crates {
833
+ let dir_name = krate. replace( "-" , "_" ) ;
834
+ t!( fs:: create_dir_all( & out. join( dir_name) ) ) ;
835
+ } ) ?
836
+
821
837
for out_dir in out_dirs {
822
- t!( fs:: create_dir_all( & out_dir) ) ;
823
838
symlink_dir_force( & builder. config, & out, & out_dir) ;
824
839
}
825
840
@@ -839,9 +854,13 @@ macro_rules! tool_doc {
839
854
// Only include compiler crates, no dependencies of those, such as `libc`.
840
855
cargo. arg( "--no-deps" ) ;
841
856
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
+ } ) ?
845
864
846
865
cargo. rustdocflag( "--document-private-items" ) ;
847
866
// 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 {
853
872
854
873
let _guard = builder. msg_doc( compiler, stringify!( $tool) . to_lowercase( ) , target) ;
855
874
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
+ }
856
884
}
857
885
}
858
886
}
859
887
}
860
888
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" ] ) ;
867
890
tool_doc ! (
868
891
Rustfmt ,
869
892
"rustfmt-nightly" ,
870
893
"src/tools/rustfmt" ,
871
- [ "-p" , " rustfmt-nightly", "-p" , " rustfmt-config_proc_macro"] ,
894
+ crates = [ " rustfmt-nightly", "rustfmt-config_proc_macro" ]
872
895
) ;
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" ] ) ;
875
898
tool_doc ! (
876
899
Cargo ,
877
900
"cargo" ,
878
901
"src/tools/cargo" ,
879
902
rustc_tool = false ,
880
903
in_tree = false ,
881
- [
882
- "-p" ,
904
+ crates = [
883
905
"cargo" ,
884
- "-p" ,
885
906
"cargo-platform" ,
886
- "-p" ,
887
907
"cargo-util" ,
888
- "-p" ,
889
908
"crates-io" ,
890
- "-p" ,
891
909
"cargo-test-macro" ,
892
- "-p" ,
893
910
"cargo-test-support" ,
894
- "-p" ,
895
911
"cargo-credential" ,
896
- "-p" ,
897
912
"mdman" ,
898
913
// FIXME: this trips a license check in tidy.
899
- // "-p",
900
914
// "resolver-tests",
901
915
]
902
916
) ;
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" ] ) ;
904
918
tool_doc ! (
905
919
Bootstrap ,
906
920
"bootstrap" ,
907
921
"src/bootstrap" ,
908
922
rustc_tool = false ,
909
- [ "--lib" , "-p" , "bootstrap" ]
923
+ is_library = true ,
924
+ crates = [ "bootstrap" ]
910
925
) ;
911
926
912
927
#[ derive( Ord , PartialOrd , Debug , Copy , Clone , Hash , PartialEq , Eq ) ]
0 commit comments