Merge pull request #157 from badeend/remove-fd-numbering-docs

Remove documentation on the numeric resource id value.

Author: pchickey

imports.md

@@ -1170,11 +1170,6 @@ WASI.</p>
 </ul>
 <h4><a name="method_descriptor_open_at"></a><code>[method]descriptor.open-at: func</code></h4>
 <p>Open a file or directory.</p>
-<p>The returned descriptor is not guaranteed to be the lowest-numbered
-descriptor not currently open/ it is randomized to prevent applications
-from depending on making assumptions about indexes, since this is
-error-prone in multi-threaded contexts. The returned descriptor is
-guaranteed to be less than 2**31.</p>
 <p>If <code>flags</code> contains <a href="#descriptor_flags.mutate_directory"><code>descriptor-flags::mutate-directory</code></a>, and the base
 descriptor doesn't have <a href="#descriptor_flags.mutate_directory"><code>descriptor-flags::mutate-directory</code></a> set,
 <code>open-at</code> fails with <a href="#error_code.read_only"><code>error-code::read-only</code></a>.</p>

wit/types.wit

@@ -523,12 +523,6 @@ interface types {
 
         /// Open a file or directory.
         ///
-        /// The returned descriptor is not guaranteed to be the lowest-numbered
-        /// descriptor not currently open/ it is randomized to prevent applications
-        /// from depending on making assumptions about indexes, since this is
-        /// error-prone in multi-threaded contexts. The returned descriptor is
-        /// guaranteed to be less than 2**31.
-        ///
         /// If `flags` contains `descriptor-flags::mutate-directory`, and the base
         /// descriptor doesn't have `descriptor-flags::mutate-directory` set,
         /// `open-at` fails with `error-code::read-only`.