@@ -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,9 +828,15 @@ 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
+
821
832
for out_dir in out_dirs {
822
833
t!( fs:: create_dir_all( & out_dir) ) ;
823
834
symlink_dir_force( & builder. config, & out, & out_dir) ;
835
+
836
+ $( for krate in $crates {
837
+ let dir_name = krate. replace( "-" , "_" ) ;
838
+ t!( fs:: create_dir_all( & out_dir. join( & * dir_name) ) ) ;
839
+ } ) ?
824
840
}
825
841
826
842
// Build cargo command.
@@ -839,9 +855,13 @@ macro_rules! tool_doc {
839
855
// Only include compiler crates, no dependencies of those, such as `libc`.
840
856
cargo. arg( "--no-deps" ) ;
841
857
842
- $(
843
- cargo. arg( $extra_arg) ;
844
- ) +
858
+ if false $( || $is_library) ? {
859
+ cargo. arg( "--lib" ) ;
860
+ }
861
+
862
+ $( for krate in $crates {
863
+ cargo. arg( "-p" ) . arg( krate) ;
864
+ } ) ?
845
865
846
866
cargo. rustdocflag( "--document-private-items" ) ;
847
867
// Since we always pass --document-private-items, there's no need to warn about linking to private items.
@@ -853,60 +873,56 @@ macro_rules! tool_doc {
853
873
854
874
let _guard = builder. msg_doc( compiler, stringify!( $tool) . to_lowercase( ) , target) ;
855
875
builder. run( & mut cargo. into( ) ) ;
876
+
877
+ if !builder. config. dry_run( ) {
878
+ // Sanity check on linked doc directories
879
+ $( for krate in $crates {
880
+ let dir_name = krate. replace( "-" , "_" ) ;
881
+ // Making sure the directory exists and is not empty.
882
+ assert!( out. join( & * dir_name) . read_dir( ) . unwrap( ) . next( ) . is_some( ) ) ;
883
+ } ) ?
884
+ }
856
885
}
857
886
}
858
887
}
859
888
}
860
889
861
- tool_doc ! (
862
- Rustdoc ,
863
- "rustdoc-tool" ,
864
- "src/tools/rustdoc" ,
865
- [ "-p" , "rustdoc" , "-p" , "rustdoc-json-types" ]
866
- ) ;
890
+ tool_doc ! ( Rustdoc , "rustdoc-tool" , "src/tools/rustdoc" , crates = [ "rustdoc" , "rustdoc-json-types" ] ) ;
867
891
tool_doc ! (
868
892
Rustfmt ,
869
893
"rustfmt-nightly" ,
870
894
"src/tools/rustfmt" ,
871
- [ "-p" , " rustfmt-nightly", "-p" , " rustfmt-config_proc_macro"] ,
895
+ crates = [ " rustfmt-nightly", "rustfmt-config_proc_macro" ]
872
896
) ;
873
- tool_doc ! ( Clippy , "clippy" , "src/tools/clippy" , [ "-p" , "clippy_utils" ] ) ;
874
- tool_doc ! ( Miri , "miri" , "src/tools/miri" , [ "-p" , "miri" ] ) ;
897
+ tool_doc ! ( Clippy , "clippy" , "src/tools/clippy" , crates = [ "clippy_utils" ] ) ;
898
+ tool_doc ! ( Miri , "miri" , "src/tools/miri" , crates = [ "miri" ] ) ;
875
899
tool_doc ! (
876
900
Cargo ,
877
901
"cargo" ,
878
902
"src/tools/cargo" ,
879
903
rustc_tool = false ,
880
904
in_tree = false ,
881
- [
882
- "-p" ,
905
+ crates = [
883
906
"cargo" ,
884
- "-p" ,
885
907
"cargo-platform" ,
886
- "-p" ,
887
908
"cargo-util" ,
888
- "-p" ,
889
909
"crates-io" ,
890
- "-p" ,
891
910
"cargo-test-macro" ,
892
- "-p" ,
893
911
"cargo-test-support" ,
894
- "-p" ,
895
912
"cargo-credential" ,
896
- "-p" ,
897
913
"mdman" ,
898
914
// FIXME: this trips a license check in tidy.
899
- // "-p",
900
915
// "resolver-tests",
901
916
]
902
917
) ;
903
- tool_doc ! ( Tidy , "tidy" , "src/tools/tidy" , rustc_tool = false , [ "-p" , "tidy" ] ) ;
918
+ tool_doc ! ( Tidy , "tidy" , "src/tools/tidy" , rustc_tool = false , crates = [ "tidy" ] ) ;
904
919
tool_doc ! (
905
920
Bootstrap ,
906
921
"bootstrap" ,
907
922
"src/bootstrap" ,
908
923
rustc_tool = false ,
909
- [ "--lib" , "-p" , "bootstrap" ]
924
+ is_library = true ,
925
+ crates = [ "bootstrap" ]
910
926
) ;
911
927
912
928
#[ derive( Ord , PartialOrd , Debug , Copy , Clone , Hash , PartialEq , Eq ) ]
0 commit comments