---

yaml
---
r: 40935
b: refs/heads/dist-snap
c: 66aadec
h: refs/heads/master
i:
  40933: d5a2228
  40931: ab1f265
  40927: e59c756
v: v3

Author: graydon

[refs]

@@ -7,7 +7,7 @@ refs/tags/release-0.1: 1f5c5126e96c79d22cb7862f75304136e204f105
 refs/heads/ndm: f3868061cd7988080c30d6d5bf352a5a5fe2460b
 refs/heads/try2: a810c03263670238bccd64cabb12a23a46e3a278
 refs/heads/incoming: e90142e536c150df0d9b4b2f11352152177509b5
-refs/heads/dist-snap: 76a2891febd8b54fb8bea07cdb60184d24c324d9
+refs/heads/dist-snap: 66aadecfee10784bc5702b2fe88d4414058171b1
 refs/tags/release-0.2: c870d2dffb391e14efb05aa27898f1f6333a9596
 refs/tags/release-0.3: b5f0d0f648d9a6153664837026ba1be43d3e2503
 refs/heads/try3: 9387340aab40a73e8424c48fd42f0c521a4875c0

branches/dist-snap/doc/rust.md

@@ -2845,6 +2845,16 @@ The kinds are:
     sendable kind are copyable, as are managed boxes, managed closures,
     trait types, and structural types built out of these.
     Types with destructors (types that implement `Drop`) can not implement `Copy`.
+`Drop`
+  : This is not strictly a kind, but its presence interacts with kinds: the `Drop`
+    trait provides a single method `finalize` that takes no parameters, and is run
+    when values of the type are dropped. Such a method is called a "destructor",
+    and are always executed in "top-down" order: a value is completely destroyed
+    before any of the values it owns run their destructors. Only `Owned` types
+    that do not implement `Copy` can implement `Drop`.
+
+> **Note:** The `finalize` method may be renamed in future versions of Rust.
+
 _Default_
   : Types with destructors, closure environments,
     and various other _non-first-class_ types,