aboutsummaryrefslogtreecommitdiffhomepage
path: root/site/versions/master/docs/skylark/language.md
diff options
context:
space:
mode:
Diffstat (limited to 'site/versions/master/docs/skylark/language.md')
-rw-r--r--site/versions/master/docs/skylark/language.md8
1 files changed, 7 insertions, 1 deletions
diff --git a/site/versions/master/docs/skylark/language.md b/site/versions/master/docs/skylark/language.md
index 1ca36e137d..583e4f7c0a 100644
--- a/site/versions/master/docs/skylark/language.md
+++ b/site/versions/master/docs/skylark/language.md
@@ -7,7 +7,7 @@ title: Extensions - Overview
## Syntax
-The extension language (Skylark) is a superset of the
+The extension language, Skylark, is a superset of the
[Core Build Language](/docs/build-ref.html#core_build_language)
and its syntax is a subset of Python.
It is designed to be simple, thread-safe and integrated with the
@@ -38,6 +38,12 @@ The following basic types are supported: [None](lib/globals.html#None),
types are specific to Bazel: [depset](lib/depset.html) and
[struct](lib/struct.html).
+Skylark is syntactically a subset of both Python 2 and Python 3, and will remain
+so through at least the 1.x release lifecycle. This ensures that Python-based
+tooling can at least parse Skylark code. Although Skylark is not *semantically*
+a subset of Python, behavioral differences are rare (excluding cases where
+Skylark raises an error).
+
## Mutability