doc: update docs for Tor listening

- add new data directory files for 0.12 to doc/files.md
- mention torcontrol in doc/tor.md

doc/files.md

@@ -10,3 +10,5 @@
 * fee_estimates.dat: stores statistics used to estimate minimum transaction fees and priorities required for confirmation
 * peers.dat: peer IP address database (custom format)
 * wallet.dat: personal wallet (BDB) with keys and transactions
+* .cookie: session RPC authentication cookie (written at start when cookie authentication is used, deleted on shutdown): since 0.12.0
+* onion_private_key: cached Tor hidden service private key for `-listenonion`: since 0.12.0

doc/tor.md

@@ -86,7 +86,25 @@ for normal IPv4/IPv6 communication, use:
 	./zcashd -onion=127.0.0.1:9050 -externalip=zctestseie6wxgio.onion -discover
 
 
-3. Connect to a Zcash hidden server
+3. Automatically listen on Tor
+--------------------------------
+
+Starting with Tor version 0.2.7.1 it is possible, through Tor's control socket
+API, to create and destroy 'ephemeral' hidden services programmatically.
+Zcash has been updated to make use of this.
+
+This means that if Tor is running (and proper authorization is available),
+Zcash automatically creates a hidden service to listen on, without
+manual configuration. This will positively affect the number of available
+.onion nodes.
+
+This new feature is enabled by default if Zcash is listening, and
+a connection to Tor can be made. It can be configured with the `-listenonion`,
+`-torcontrol` and `-torpassword` settings. To show verbose debugging
+information, pass `-debug=tor`.
+
+
+4. Connect to a Zcash hidden server
 -----------------------------------
 
 To test your set-up, you might want to try connecting via Tor on a different computer to just a