aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAlan Donovan <adonovan@google.com>2017-11-10 12:40:24 -0500
committerAlan Donovan <adonovan@google.com>2017-11-10 12:40:24 -0500
commit70639d2c2e1b4900c2b60889bef4b9e59f340b29 (patch)
treec380b6ca685f5b8ac843a3d3ac9ac59fab9d1aeb
parentaa0bc8ec376caaff75fa2c8663023ac3c1f52ec3 (diff)
downloadstarlark-go-70639d2c2e1b4900c2b60889bef4b9e59f340b29.tar.gz
doc/spec.md: minor corrections
Change-Id: Id97fe5a8b23417ce2d9d2f61e296a8668b3227b1
-rw-r--r--doc/spec.md12
1 files changed, 5 insertions, 7 deletions
diff --git a/doc/spec.md b/doc/spec.md
index 8454baa..b48d5d1 100644
--- a/doc/spec.md
+++ b/doc/spec.md
@@ -112,7 +112,6 @@ concurrency, and other such features of Python.
* [all](#all)
* [bool](#bool)
* [chr](#chr)
- * [cmp](#cmp)
* [dict](#dict)
* [dir](#dir)
* [enumerate](#enumerate)
@@ -476,7 +475,7 @@ such as `Inf/Inf`. A NaN value compares neither less than, nor
greater than, nor equal to any value, including itself.
All floats other than NaN are totally ordered, so they may be compared
-using operators such as `==` and `<` and the `cmp` built-in function.
+using operators such as `==` and `<`.
Any bool, number, or string may be interpreted as a floating-point
number by using the `float` built-in function.
@@ -522,8 +521,7 @@ index `i` up to index `j`. The index expression `s[i]` returns the
Strings are hashable, and thus may be used as keys in a dictionary.
Strings are totally ordered lexicographically, so strings may be
-compared using operators such as `==` and `<` and the `cmp` built-in
-function.
+compared using operators such as `==` and `<`.
Strings are _not_ iterable sequences, so they cannot be used as the operand of
a `for`-loop, list comprehension, or any other operation than requires
@@ -3077,7 +3075,7 @@ Sets are an optional feature of the Go implementation of Skylark.
`sorted(x)` returns a new list containing the elements of the iterable sequence x,
in sorted order. The sort algorithm is stable.
-The optional named parameter `reversed`, if true, causes `sorted` to
+The optional named parameter `reverse`, if true, causes `sorted` to
return results in reverse sorted order.
The optional named parameter `key` specifies a function of one
@@ -3094,7 +3092,7 @@ sorted(["two", "three", "four"], key=len, reverse=True) # ["three", "fou
```
<b>Implementation note:</b>
-The Java implementation does not support the `key`, and `reversed` parameters.
+The Java implementation does not support the `key`, and `reverse` parameters.
### str
@@ -3929,6 +3927,6 @@ eventually to eliminate all such differences on a case-by-case basis.
* A method call `x.f()` may be separated into two steps: `y = x.f; y()`.
* Dot expressions may appear on the left side of an assignment: `x.f = 1`.
* `hash` accepts operands besides strings.
-* `sorted` accepts the additional parameters `cmp`, `key`, and `reversed`.
+* `sorted` accepts the additional parameters `key` and `reverse`.
* The `dict` type has a `clear` method.
* `type(x)` returns `"builtin_function_or_method"` for built-in functions.