Create "The Unstable Book"

part of #39588

src/bootstrap/step.rs

@@ -577,6 +577,15 @@ pub fn build_rules<'a>(build: &'a Build) -> Rules {
          })
          .default(build.config.docs)
          .run(move |s| doc::rustbook(build, s.target, "reference"));
+    rules.doc("doc-unstable-book", "src/doc/unstable-book")
+         .dep(move |s| {
+             s.name("tool-rustbook")
+              .host(&build.config.build)
+              .target(&build.config.build)
+              .stage(0)
+         })
+         .default(build.config.docs)
+         .run(move |s| doc::rustbook(build, s.target, "unstable-book"));
     rules.doc("doc-standalone", "src/doc")
          .dep(move |s| {
              s.name("rustc")

src/doc/unstable-book/.gitignore

@@ -0,0 +1 @@
+book

src/doc/unstable-book/src/SUMMARY.md

@@ -0,0 +1,91 @@
+[The Unstable Book](the-unstable-book.md)
+
+- [asm](asm.md)
+- [concat_idents](concat-idents.md)
+- [link_args](link-args.md)
+- [log_syntax](log-syntax.md)
+- [non_ascii_idents](non_ascii-idents.md)
+- [plugin_registrar](plugin-registrar.md)
+- [thread_local](thread-local.md)
+- [trace_macros](trace-macros.md)
+- [intrinsics](intrinsics.md)
+- [lang_items](lang-items.md)
+- [link_llvm_intrinsics](link-llvm-intrinsics.md)
+- [linkage](linkage.md)
+- [quote](quote.md)
+- [simd](simd.md)
+- [rustc_diagnostic_macros](rustc-diagnostic-macros.md)
+- [advanced_slice_patterns](advanced-slice-patterns.md)
+- [box_syntax](box-syntax.md)
+- [placement_in_syntax](placement-in-syntax.md)
+- [unboxed_closures](unboxed-closures.md)
+- [allocator](allocator.md)
+- [fundamental](fundamental.md)
+- [main](main.md)
+- [needs_allocator](needs-allocator.md)
+- [on_unimplemented](on-unimplemented.md)
+- [plugin](plugin.md)
+- [simd_ffi](simd-ffi.md)
+- [start](start.md)
+- [structural_match](structural-match.md)
+- [panic_runtime](panic-runtime.md)
+- [needs_panic_runtime](needs-panic-runtime.md)
+- [optin_builtin_traits](optin-builtin-traits.md)
+- [macro_reexport](macro-reexport.md)
+- [staged_api](staged-api.md)
+- [no_core](no-core.md)
+- [box_patterns](box-patterns.md)
+- [dropck_parametricity](dropck-parametricity.md)
+- [dropck_eyepatch](dropck-eyepatch.md)
+- [custom_attribute](custom-attribute.md)
+- [custom_derive](custom-derive.md)
+- [rustc_attrs](rustc-attrs.md)
+- [allow_internal_unstable](allow-internal-unstable.md)
+- [slice_patterns](slice-patterns.md)
+- [associated_consts](associated-consts.md)
+- [const_fn](const-fn.md)
+- [const_indexing](const-indexing.md)
+- [prelude_import](prelude-import.md)
+- [static_recursion](static-recursion.md)
+- [default_type_parameter_fallback](default-type-parameter-fallback.md)
+- [associated_type_defaults](associated-type-defaults.md)
+- [repr_simd](repr-simd.md)
+- [cfg_target_feature](cfg-target-feature.md)
+- [platform_intrinsics](platform-intrinsics.md)
+- [unwind_attributes](unwind-attributes.md)
+- [naked_functions](naked-functions.md)
+- [no_debug](no-debug.md)
+- [omit_gdb_pretty_printer_section](omit-gdb-pretty-printer-section.md)
+- [cfg_target_vendor](cfg-target-vendor.md)
+- [stmt_expr_attributes](stmt-expr-attributes.md)
+- [type_ascription](type-ascription.md)
+- [cfg_target_thread_local](cfg-target-thread-local.md)
+- [abi_vectorcall](abi-vectorcall.md)
+- [inclusive_range_syntax](inclusive-range-syntax.md)
+- [exclusive_range_pattern](exclusive-range-pattern.md)
+- [specialization](specialization.md)
+- [pub_restricted](pub-restricted.md)
+- [drop_types_in_const](drop-types-in-const.md)
+- [cfg_target_has_atomic](cfg-target-has-atomic.md)
+- [conservative_impl_trait](conservative-impl-trait.md)
+- [relaxed_adts](relaxed-adts.md)
+- [never_type](never-type.md)
+- [attr_literals](attr-literals.md)
+- [abi_sysv64](abi-sysv64.md)
+- [untagged_unions](untagged-unions.md)
+- [compiler_builtins](compiler-builtins.md)
+- [generic_param_attrs](generic-param-attrs.md)
+- [field_init_shorthand](field-init-shorthand.md)
+- [windows_subsystem](windows-subsystem.md)
+- [link_cfg](link-cfg.md)
+- [use_extern_macros](use-extern-macros.md)
+- [loop_break_value](loop-break-value.md)
+- [target_feature](target-feature.md)
+- [abi_ptx](abi-ptx.md)
+- [i128_type](i128-type.md)
+- [abi_unadjusted](abi-unadjusted.md)
+- [proc_macro](proc-macro.md)
+- [struct_field_attributes](struct-field-attributes.md)
+- [static_nobundle](static-nobundle.md)
+- [abi_msp430_interrupt](abi-msp430-interrupt.md)
+- [sanitizer_runtime](sanitizer-runtime.md)

src/doc/unstable-book/src/abi-msp430-interrupt.md

@@ -0,0 +1 @@
+# abi_msp430_interrupt

src/doc/unstable-book/src/abi-ptx.md

@@ -0,0 +1 @@
+# abi_ptx

src/doc/unstable-book/src/abi-sysv64.md

@@ -0,0 +1 @@
+# abi_sysv64

src/doc/unstable-book/src/abi-unadjusted.md

@@ -0,0 +1 @@
+# abi_unadjusted

src/doc/unstable-book/src/abi-vectorcall.md

@@ -0,0 +1 @@
+# abi_vectorcall

src/doc/unstable-book/src/advanced-slice-patterns.md

@@ -0,0 +1 @@
+# advanced_slice_patterns

src/doc/unstable-book/src/allocator.md

@@ -0,0 +1 @@
+# allocator

src/doc/unstable-book/src/allow-internal-unstable.md

@@ -0,0 +1 @@
+# allow_internal_unstable

src/doc/unstable-book/src/asm.md

@@ -0,0 +1 @@
+# asm

src/doc/unstable-book/src/associated-consts.md

@@ -0,0 +1 @@
+# associated_consts

src/doc/unstable-book/src/associated-type-defaults.md

@@ -0,0 +1 @@
+# associated_type_defaults

src/doc/unstable-book/src/attr-literals.md

@@ -0,0 +1 @@
+# attr_literals

src/doc/unstable-book/src/box-patterns.md

@@ -0,0 +1 @@
+# box_patterns

src/doc/unstable-book/src/box-syntax.md

@@ -0,0 +1 @@
+# box_syntax

src/doc/unstable-book/src/cfg-target-feature.md

@@ -0,0 +1 @@
+# cfg_target_feature

src/doc/unstable-book/src/cfg-target-has-atomic.md

@@ -0,0 +1 @@
+# cfg_target_has_atomic

src/doc/unstable-book/src/cfg-target-thread-local.md

@@ -0,0 +1 @@
+# cfg_target_thread_local

src/doc/unstable-book/src/cfg-target-vendor.md

@@ -0,0 +1 @@
+# cfg_target_vendor

src/doc/unstable-book/src/compiler-builtins.md

@@ -0,0 +1 @@
+# compiler_builtins

src/doc/unstable-book/src/concat-idents.md

@@ -0,0 +1 @@
+# concat_idents

src/doc/unstable-book/src/conservative-impl-trait.md

@@ -0,0 +1 @@
+# conservative_impl_trait

src/doc/unstable-book/src/const-fn.md

@@ -0,0 +1 @@
+# const_fn

src/doc/unstable-book/src/const-indexing.md

@@ -0,0 +1 @@
+# const_indexing

src/doc/unstable-book/src/custom-attribute.md

@@ -0,0 +1 @@
+# custom_attribute

src/doc/unstable-book/src/custom-derive.md

@@ -0,0 +1 @@
+# custom_derive

src/doc/unstable-book/src/default-type-parameter-fallback.md

@@ -0,0 +1 @@
+# default_type_parameter_fallback

src/doc/unstable-book/src/drop-types-in-const.md

@@ -0,0 +1 @@
+# drop_types_in_const

src/doc/unstable-book/src/dropck-eyepatch.md

@@ -0,0 +1 @@
+# dropck_eyepatch

src/doc/unstable-book/src/dropck-parametricity.md

@@ -0,0 +1 @@
+# dropck_parametricity

src/doc/unstable-book/src/exclusive-range-pattern.md

@@ -0,0 +1 @@
+# exclusive_range_pattern

src/doc/unstable-book/src/field-init-shorthand.md

@@ -0,0 +1 @@
+# field_init_shorthand

src/doc/unstable-book/src/fundamental.md

@@ -0,0 +1 @@
+# fundamental

src/doc/unstable-book/src/generic-param-attrs.md

@@ -0,0 +1 @@
+# generic_param_attrs

src/doc/unstable-book/src/i128-type.md

@@ -0,0 +1 @@
+# i128_type

src/doc/unstable-book/src/inclusive-range-syntax.md

@@ -0,0 +1 @@
+# inclusive_range_syntax

src/doc/unstable-book/src/intrinsics.md

@@ -0,0 +1 @@
+# intrinsics

src/doc/unstable-book/src/lang-items.md

@@ -0,0 +1 @@
+# lang_items

src/doc/unstable-book/src/link-args.md

@@ -0,0 +1 @@
+# link_args

src/doc/unstable-book/src/link-cfg.md

@@ -0,0 +1 @@
+# link_cfg

src/doc/unstable-book/src/link-llvm-intrinsics.md

@@ -0,0 +1 @@
+# link_llvm_intrinsics

src/doc/unstable-book/src/linkage.md

@@ -0,0 +1 @@
+# linkage

src/doc/unstable-book/src/log-syntax.md

@@ -0,0 +1 @@
+# log_syntax

src/doc/unstable-book/src/loop-break-value.md

@@ -0,0 +1 @@
+# loop_break_value

src/doc/unstable-book/src/macro-reexport.md

@@ -0,0 +1 @@
+# macro_reexport

src/doc/unstable-book/src/main.md

@@ -0,0 +1 @@
+# main

src/doc/unstable-book/src/naked-functions.md

@@ -0,0 +1 @@
+# naked_functions

src/doc/unstable-book/src/needs-allocator.md

@@ -0,0 +1 @@
+# needs_allocator

src/doc/unstable-book/src/needs-panic-runtime.md

@@ -0,0 +1 @@
+# needs_panic_runtime

src/doc/unstable-book/src/never-type.md

@@ -0,0 +1 @@
+# never_type

src/doc/unstable-book/src/no-core.md

@@ -0,0 +1 @@
+# no_core

src/doc/unstable-book/src/no-debug.md

@@ -0,0 +1 @@
+# no_debug

src/doc/unstable-book/src/non_ascii-idents.md

@@ -0,0 +1 @@
+# non_ascii_idents

src/doc/unstable-book/src/omit-gdb-pretty-printer-section.md

@@ -0,0 +1 @@
+# omit_gdb_pretty_printer_section

src/doc/unstable-book/src/on-unimplemented.md

@@ -0,0 +1 @@
+# on_unimplemented

src/doc/unstable-book/src/optin-builtin-traits.md

@@ -0,0 +1 @@
+# optin_builtin_traits

src/doc/unstable-book/src/panic-runtime.md

@@ -0,0 +1 @@
+# panic_runtime

src/doc/unstable-book/src/placement-in-syntax.md

@@ -0,0 +1 @@
+# placement_in_syntax

src/doc/unstable-book/src/platform-intrinsics.md

@@ -0,0 +1 @@
+# platform_intrinsics

src/doc/unstable-book/src/plugin-registrar.md

@@ -0,0 +1 @@
+# plugin_registrar

src/doc/unstable-book/src/plugin.md

@@ -0,0 +1 @@
+# plugin

src/doc/unstable-book/src/prelude-import.md

@@ -0,0 +1 @@
+# prelude_import

src/doc/unstable-book/src/proc-macro.md

@@ -0,0 +1 @@
+# proc_macro

src/doc/unstable-book/src/pub-restricted.md

@@ -0,0 +1 @@
+# pub_restricted

src/doc/unstable-book/src/quote.md

@@ -0,0 +1 @@
+# quote

src/doc/unstable-book/src/relaxed-adts.md

@@ -0,0 +1 @@
+# relaxed_adts

src/doc/unstable-book/src/repr-simd.md

@@ -0,0 +1 @@
+# repr_simd

src/doc/unstable-book/src/rustc-attrs.md

@@ -0,0 +1 @@
+# rustc_attrs

src/doc/unstable-book/src/rustc-diagnostic-macros.md

@@ -0,0 +1 @@
+# rustc_diagnostic_macros

src/doc/unstable-book/src/sanitizer-runtime.md

@@ -0,0 +1 @@
+# sanitizer_runtime

src/doc/unstable-book/src/simd-ffi.md

@@ -0,0 +1 @@
+# simd_ffi

src/doc/unstable-book/src/simd.md

@@ -0,0 +1 @@
+# simd

src/doc/unstable-book/src/slice-patterns.md

@@ -0,0 +1 @@
+# slice_patterns

src/doc/unstable-book/src/specialization.md

@@ -0,0 +1 @@
+# specialization

src/doc/unstable-book/src/staged-api.md

@@ -0,0 +1 @@
+# staged_api

src/doc/unstable-book/src/start.md

@@ -0,0 +1 @@
+# start

src/doc/unstable-book/src/static-nobundle.md

@@ -0,0 +1 @@
+# static_nobundle

src/doc/unstable-book/src/static-recursion.md

@@ -0,0 +1 @@
+# static_recursion

src/doc/unstable-book/src/stmt-expr-attributes.md

@@ -0,0 +1 @@
+# stmt_expr_attributes

src/doc/unstable-book/src/struct-field-attributes.md

@@ -0,0 +1 @@
+# struct_field_attributes

src/doc/unstable-book/src/structural-match.md

@@ -0,0 +1 @@
+# structural_match

src/doc/unstable-book/src/target-feature.md

@@ -0,0 +1 @@
+# target_feature

src/doc/unstable-book/src/the-unstable-book.md

@@ -0,0 +1 @@
+# The Unstable Book

src/doc/unstable-book/src/thread-local.md

@@ -0,0 +1 @@
+# thread_local

src/doc/unstable-book/src/trace-macros.md

@@ -0,0 +1 @@
+# trace_macros

src/doc/unstable-book/src/type-ascription.md

@@ -0,0 +1 @@
+# type_ascription

src/doc/unstable-book/src/unboxed-closures.md

@@ -0,0 +1 @@
+# unboxed_closures

src/doc/unstable-book/src/untagged-unions.md

@@ -0,0 +1 @@
+# untagged_unions

src/doc/unstable-book/src/unwind-attributes.md

@@ -0,0 +1 @@
+# unwind_attributes

src/doc/unstable-book/src/use-extern-macros.md

@@ -0,0 +1 @@
+# use_extern_macros

src/doc/unstable-book/src/windows-subsystem.md

@@ -0,0 +1 @@
+# windows_subsystem

src/libsyntax/feature_gate.rs

@@ -91,11 +91,14 @@ macro_rules! declare_features {
     }
 }
 
-// If you change this list without updating src/doc/reference.md, @cmr will be sad
+// If you change this, please modify src/doc/unstable-book as well.
+//
 // Don't ever remove anything from this list; set them to 'Removed'.
+//
 // The version numbers here correspond to the version in which the current status
 // was set. This is most important for knowing when a particular feature became
 // stable (active).
+//
 // NB: The featureck.py script parses this information directly out of the source
 // so take care when modifying it.
 
@@ -385,7 +388,9 @@ declare_features! (
     // Allows field shorthands (`x` meaning `x: x`) in struct literal expressions.
     (accepted, field_init_shorthand, "1.17.0", Some(37340)),
 );
-// (changing above list without updating src/doc/reference.md makes @cmr sad)
+// If you change this, please modify src/doc/unstable-book as well. You must
+// move that documentation into the relevant place in the other docs, and
+// remove the chapter on the flag.
 
 #[derive(PartialEq, Copy, Clone, Debug)]
 pub enum AttributeType {