From 57071bafa76ba1a72abc34d146a77a4819bf0aaf Mon Sep 17 00:00:00 2001 From: Martin Odersky Date: Sat, 29 Jan 2022 10:52:52 +0100 Subject: [PATCH 1/3] Update experimental overview page --- docs/docs/reference/experimental/overview.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/docs/reference/experimental/overview.md b/docs/docs/reference/experimental/overview.md index fdd44832fd8f..d7686b8ecc02 100644 --- a/docs/docs/reference/experimental/overview.md +++ b/docs/docs/reference/experimental/overview.md @@ -13,6 +13,13 @@ They are enabled by importing the feature or using the `-language` compiler flag * `fewerBraces`: Enable support for using indentation for arguments. * [`genericNumberLiterals`](./numeric-literals.md): Enable support for generic number literals. * [`namedTypeArguments`](./named-typeargs.md): Enable support for named type arguments +* [`saferExceptions`](./canthrow.md): Enable support for checked exceptions. + +### Experimental language features supported by special compiler options + +Some experimental language features that are still in research and development can be enabled with special compiler options. These include + +* `-Yexplicit-nulls` Enable support for tracking null references in the type system. ### Experimental language imports From 9fc3f08937b0b633fd5048b4572ed689f1f0bb67 Mon Sep 17 00:00:00 2001 From: Martin Odersky Date: Sat, 29 Jan 2022 15:04:19 +0100 Subject: [PATCH 2/3] Reorganize side bar and overview page --- docs/docs/reference/experimental/overview.md | 11 ++++++----- docs/sidebar.yml | 2 -- 2 files changed, 6 insertions(+), 7 deletions(-) diff --git a/docs/docs/reference/experimental/overview.md b/docs/docs/reference/experimental/overview.md index d7686b8ecc02..785816412e24 100644 --- a/docs/docs/reference/experimental/overview.md +++ b/docs/docs/reference/experimental/overview.md @@ -1,6 +1,6 @@ --- layout: doc-page -title: "Experimental language features" +title: "Overview" movedTo: https://docs.scala-lang.org/scala3/reference/experimental/overview.html --- @@ -15,13 +15,14 @@ They are enabled by importing the feature or using the `-language` compiler flag * [`namedTypeArguments`](./named-typeargs.md): Enable support for named type arguments * [`saferExceptions`](./canthrow.md): Enable support for checked exceptions. +### Experimental language imports + +In general, experimental language features can be imported in an experimental scope (see [experimental definitions](../other-new-features/experimental-defs.md). +They can be imported at the top-level if all top-level definitions are @experimental. + ### Experimental language features supported by special compiler options Some experimental language features that are still in research and development can be enabled with special compiler options. These include * `-Yexplicit-nulls` Enable support for tracking null references in the type system. -### Experimental language imports - -In general, experimental language features can be imported in an experimental scope (see [experimental definitions](../other-new-features/experimental-defs.md). -They can be imported at the top-level if all top-level definitions are @experimental. diff --git a/docs/sidebar.yml b/docs/sidebar.yml index 6f8af7cd53eb..31fa0d11a1a3 100644 --- a/docs/sidebar.yml +++ b/docs/sidebar.yml @@ -114,9 +114,7 @@ sidebar: - page: docs/reference/experimental/overview.md - page: docs/reference/experimental/canthrow.md - page: docs/reference/experimental/erased-defs.md - - page: docs/reference/experimental/erased-defs-spec.md - page: docs/reference/experimental/named-typeargs.md - - page: docs/reference/experimental/named-typeargs-spec.md - page: docs/reference/experimental/numeric-literals.md - page: docs/reference/syntax.md - title: Language Versions From a9015e495c38ea2d0614ff91551a9db2557934c0 Mon Sep 17 00:00:00 2001 From: Martin Odersky Date: Sat, 29 Jan 2022 15:12:58 +0100 Subject: [PATCH 3/3] Move explicit-nulls page to experimental section --- .../{other-new-features => experimental}/explicit-nulls.md | 0 docs/docs/reference/experimental/overview.md | 2 +- docs/sidebar.yml | 2 +- 3 files changed, 2 insertions(+), 2 deletions(-) rename docs/docs/reference/{other-new-features => experimental}/explicit-nulls.md (100%) diff --git a/docs/docs/reference/other-new-features/explicit-nulls.md b/docs/docs/reference/experimental/explicit-nulls.md similarity index 100% rename from docs/docs/reference/other-new-features/explicit-nulls.md rename to docs/docs/reference/experimental/explicit-nulls.md diff --git a/docs/docs/reference/experimental/overview.md b/docs/docs/reference/experimental/overview.md index 785816412e24..2644de0d864e 100644 --- a/docs/docs/reference/experimental/overview.md +++ b/docs/docs/reference/experimental/overview.md @@ -24,5 +24,5 @@ They can be imported at the top-level if all top-level definitions are @experime Some experimental language features that are still in research and development can be enabled with special compiler options. These include -* `-Yexplicit-nulls` Enable support for tracking null references in the type system. +* [`-Yexplicit-nulls`](./explicit-nulls.md). Enable support for tracking null references in the type system. diff --git a/docs/sidebar.yml b/docs/sidebar.yml index 31fa0d11a1a3..0a0e8acae652 100644 --- a/docs/sidebar.yml +++ b/docs/sidebar.yml @@ -64,7 +64,6 @@ sidebar: - page: docs/reference/other-new-features/targetName.md - page: docs/reference/other-new-features/control-syntax.md - page: docs/reference/other-new-features/indentation.md - - page: docs/reference/other-new-features/explicit-nulls.md - page: docs/reference/other-new-features/safe-initialization.md - page: docs/reference/other-new-features/type-test.md - page: docs/reference/other-new-features/experimental-defs.md @@ -116,6 +115,7 @@ sidebar: - page: docs/reference/experimental/erased-defs.md - page: docs/reference/experimental/named-typeargs.md - page: docs/reference/experimental/numeric-literals.md + - page: docs/reference/experimental/explicit-nulls.md - page: docs/reference/syntax.md - title: Language Versions index: docs/reference/language-versions/language-versions.md