make gen

documentation/en/api-v0-methods-miner.md

@@ -528,7 +528,16 @@ Inputs:
 ]
 ```
 
-Response: `null`
+Response:
+```json
+[
+  {
+    "Key": "baga6ea4seaqecmtz7iak33dsfshi627abz4i4665dfuzr3qfs4bmad6dx3iigdq",
+    "State": "ShardStateAvailable",
+    "Error": "\u003cerror\u003e"
+  }
+]
+```
 
 ### DagstorePieceIndexSize
 DagstorePieceIndexSize returns the size of the piece index.

documentation/en/cli-lotus.md

@@ -561,37 +561,36 @@ CATEGORY:
 
 DESCRIPTION:
    Retrieve data from the Filecoin network.
-
+   
-The retrieve command will attempt to find a provider make a retrieval deal with
+   The retrieve command will attempt to find a provider make a retrieval deal with
-them. In case a provider can't be found, it can be specified with the --provider
+   them. In case a provider can't be found, it can be specified with the --provider
-flag.
+   flag.
-
+   
-By default the data will be interpreted as DAG-PB UnixFSv1 File. Alternatively
+   By default the data will be interpreted as DAG-PB UnixFSv1 File. Alternatively
-a CAR file containing the raw IPLD graph can be exported by setting the --car
+   a CAR file containing the raw IPLD graph can be exported by setting the --car
-flag.
+   flag.
-
+   
-Partial Retrieval:
+   Partial Retrieval:
-
+   
-The --data-selector flag can be used to specify a sub-graph to fetch. The
+   The --data-selector flag can be used to specify a sub-graph to fetch. The
-selector can be specified as either IPLD datamodel text-path selector, or IPLD
+   selector can be specified as either IPLD datamodel text-path selector, or IPLD
-json selector.
+   json selector.
-
+   
-In case of unixfs retrieval, the selector must point at a single root node, and
+   In case of unixfs retrieval, the selector must point at a single root node, and
-match the entire graph under that node.
+   match the entire graph under that node.
-
+   
-In case of CAR retrieval, the selector must have one common "sub-root" node.
+   In case of CAR retrieval, the selector must have one common "sub-root" node.
-
+   
-Examples:
+   Examples:
-
+   
-- Retrieve a file by CID
+   - Retrieve a file by CID
-  $ lotus client retrieve Qm... my-file.txt
+     $ lotus client retrieve Qm... my-file.txt
-
+   
-- Retrieve a file by CID from f0123
+   - Retrieve a file by CID from f0123
-  $ lotus client retrieve --provider f0123 Qm... my-file.txt
+     $ lotus client retrieve --provider f0123 Qm... my-file.txt
-
+   
-- Retrieve a first file from a specified directory
+   - Retrieve a first file from a specified directory
-  $ lotus client retrieve --data-selector /Links/0/Hash Qm... my-file.txt
+     $ lotus client retrieve --data-selector /Links/0/Hash Qm... my-file.txt
-
 
 OPTIONS:
    --car                                                   Export to a car file instead of a regular file (default: false)