docs: document API methods that take a timeout option

Author: Alan Shaw

SPEC/OBJECT.md

@@ -87,7 +87,8 @@ A great source of [examples][] can be found in the tests for this API.
 
 `options` is a optional argument of type object, that can contain the following properties:
 
-- `enc`, the encoding of multihash (base58, base64, etc), if any.
+- `enc` (`string`) - the encoding of multihash (base58, base64, etc), if any.
+- `timeout` (`number`|`string`) - Throw an error if the request does not complete within the specified milliseconds timeout. If `timeout` is a string, the value is parsed as a [human readable duration](https://www.npmjs.com/package/parse-duration). There is no timeout by default.
 
 **Returns**
 

SPEC/PIN.md

@@ -14,7 +14,8 @@ Where:
 
 - `hash` is an IPFS multihash.
 - `options` is an object that can contain the following keys
-  - `recursive` - Recursively pin the object linked. Type: bool. Default: `true`
+  - `recursive` (`boolean`) - Recursively pin the object linked. Type: bool. Default: `true`
+  - `timeout` (`number`|`string`) - Throw an error if the request does not complete within the specified milliseconds timeout. If `timeout` is a string, the value is parsed as a [human readable duration](https://www.npmjs.com/package/parse-duration). There is no timeout by default.
 
 **Returns**
 

SPEC/REFS.md

@@ -26,6 +26,7 @@
   - `format ("<dst>")`: output edges with given format. Available tokens: `<src>`, `<dst>`, `<linkname>`
   - `edges (false)`: output references in edge format: `"<src> -> <dst>"`
   - `maxDepth (1)`: only for recursive refs, limits fetch and listing to the given depth
+  - `timeout (number|string)`: Throw an error if the request does not complete within the specified milliseconds timeout. If `timeout` is a string, the value is parsed as a [human readable duration](https://www.npmjs.com/package/parse-duration). There is no timeout by default.
 
 **Returns**