Add API reference for files.get.

API/files/README.md

@@ -93,9 +93,9 @@ ipfs.files.createAddStream(function (err, stream) {
 
 
 
-#### `cat` 
+#### `cat`
 
-> Streams the file at the given IPFS multihash..
+> Streams the file at the given IPFS multihash.
 
 ##### `Go` **WIP**
 
@@ -116,3 +116,43 @@ ipfs.files.cat(multihash, function (err, file) {
 })
 ```
 
+
+#### `get`
+> Get [UnixFS][] files from IPFS.
+
+##### `Go` **WIP**
+
+##### `JavaScript` - ipfs.files.get(hash, [callback])
+
+Where `hash` is an IPFS multiaddress or multihash.
+
+`callback` must follow `function (err, stream) {}` signature, where `err` is an
+error if the operation was not successful. `stream` will be a Readable stream in
+[*object mode*](https://nodejs.org/api/stream.html#stream_object_mode),
+outputting objects of the form
+
+```js
+{
+  path: '/tmp/myfile.txt',
+  content: <Readable stream>
+}
+```
+
+Here, each `path` corresponds to the name of a file, and `content` is a regular
+Readable stream with the raw contents of that file.
+
+If no `callback` is passed, a promise is returned with the Readable stream.
+
+Example:
+
+```js
+var multiaddr = '/ipfs/QmQ2r6iMNpky5f1m4cnm3Yqw8VSvjuKpTcK1X7dBR1LkJF'
+ipfs.files.get(multiaddr, function (err, stream) {
+  stream.on('data', (file) => {
+    // write the file's path and contents to standard out
+    console.log(file.path)
+    file.content.pipe(process.stdout)
+  })
+})
+```
+