Merge pull request #75 from ipfs/feature/update-since-2542

Updated some descriptions given go-ipfs#2542

Author: RichardLitt

apiary.apib

@@ -7,11 +7,7 @@ The API for interacting with IPFS nodes.
 The HTTP API is currently accepting all methods, so GET will work just as well as POST for any group. Because of this, the methods shown below are the specifications that should be adhered to, although any will work. For more, see this discussion: https://github.com/ipfs/go-ipfs/issues/2165.
 
 # Group add [POST /add{?arg}{&r,p,t,n,w,H,s}]
-
-Add a file to IPFS.
-
-Note that directories are added recursively, to form the ipfs
-MerkleDAG.
+Add a file or directory to IPFS.
 
 #### curl
 
@@ -9630,6 +9626,8 @@ Removes the pinned object from local storage.
 # Group ping
 Send echo request packets to IPFS hosts.
 
+Send pings to a peer to verify connectivity and determine latency.
+
 ## ping [GET /ping{?arg}{&count}]
 A tool to test sending data to other nodes. It finds nodes
 via the routing system, sends pings, waits for pongs, and prints out round-
@@ -9858,7 +9856,8 @@ trip latency information.
 
 # Group refs
 
-Displays the link hashes an IPFS or IPNS object(s) contains, with the following format:
+Lists the hashes of all the links an IPFS or IPNS object(s) contains,
+with the following format:
 
     <link base58 hash>