[Pkg-anonymity-tools] [onionshare] 01/01: improve manpage, explain quickly how Tor HS and its encryption works, using Micah's words.

[Ulrike Uhlig]

This is an automated email from the git hooks/post-receive script.

u-guest pushed a commit to branch debian
in repository onionshare.

commit ef6dbaf11d079bfd39e9cad683965014418178b6
Author: Ulrike Uhlig <u at 451f.org>
Date:   Tue Sep 2 22:03:43 2014 +0200

    improve manpage, explain quickly how Tor HS and its encryption works, using Micah's words.
---
 debian/onionshare-gui.1 | 15 +++++----------
 debian/onionshare.1     |  8 +++++---
 2 files changed, 10 insertions(+), 13 deletions(-)

diff --git a/debian/onionshare-gui.1 b/debian/onionshare-gui.1
index 74523a2..4a01aa3 100644
--- a/debian/onionshare-gui.1
+++ b/debian/onionshare-gui.1
@@ -11,13 +11,15 @@ onionshare \- a tool for anonymously sharing files over a temporarily set up Tor
 
 .SH DESCRIPTION
 .PP
-\fBOnionShare\fP lets you anonymously share files. You host the file on your own computer and use a Tor hidden service to make it temporarily accessible over the Internet. Onionshare sets up this hidden service up for you. It then generates an unguessable URL to access and download the file.
+\fBOnionShare\fP lets you anonymously share files. You host the file on your own computer and use a Tor hidden service to make it temporarily accessible over the Internet. OnionShare sets up this hidden service up for you. It then generates an unguessable URL to access and download the file.
 .br
-Before you can share a file, you need to open Tor Browser in the background. This will provide the Tor service that OnionShare uses to start the hidden service.
+Before you can share a file, you need to open Tor Browser in the background. This will provide the Tor service that OnionShare uses to start the hidden service. All Tor hidden services (any website that's accessed through a .onion domain) are automatically end-to-end encrypted.
+.br
+In the case of OnionShare, the crypto key lives in /tmp/onionshare_XXX/private_key. The .onion URL address itself is a fingerprint of the key, which lets the Tor network look up the public key and start an encrypted session. So as long as you transmit the OnionShare URL successfully, the recipient who loads it in Tor Browser gets an end-to-end encrypted session with the server.
 .br
 When you open OnionShare you will be prompted to select a file to share. The unguessable URL is then generated and automatically copied to the clipboard.
 .br
-The person you want to share the file with just needs to use the Tor Browser to download the file from you, using the URL you sent to them over another, possibly encrypted, channel like encrypted e-mail or chat.
+The person you want to share the file with just needs to use the Tor Browser to download the file from you, using the URL you sent to them over another, possibly encrypted, channel like encrypted e-mail or a chat using OTR.
 .br
 It takes around 30 seconds until the hidden service is available over the Tor network.
 .br
@@ -27,13 +29,6 @@ OnionShare's default behaviour is to shut down the hidden service and to close t
 .B
 .IP -h
 display a short help message and exit
-.B
-.IP --local-only
-don't run a public hidden service, just run on localhost
-.IP --stay-open
-don't exit after file has been successfully downloaded
-.IP --debug
-enable more verbose output
 
 .SH AUTHOR
 Manual page by Ulrike Uhlig <u at 451f dot org>
diff --git a/debian/onionshare.1 b/debian/onionshare.1
index feba392..15f7a89 100644
--- a/debian/onionshare.1
+++ b/debian/onionshare.1
@@ -13,11 +13,13 @@ onionshare \- a tool for anonymously sharing files over a temporarily set up Tor
 
 .SH DESCRIPTION
 .PP
-\fBOnionShare\fP lets you anonymously share files. You host the file on your own computer and use a Tor hidden service to make it temporarily accessible over the Internet. Onionshare sets up this hidden service up for you. It then generates an unguessable URL to access and download the file.
+\fBOnionShare\fP lets you anonymously share files. You host the file on your own computer and use a Tor hidden service to make it temporarily accessible over the Internet. OnionShare sets up this hidden service up for you. It then generates an unguessable URL to access and download the file.
 .br
-Before you can share a file, you need to open Tor Browser in the background. This will provide the Tor service that OnionShare uses to start the hidden service.
+Before you can share a file, you need to open Tor Browser in the background. This will provide the Tor service that OnionShare uses to start the hidden service. All Tor hidden services (any website that's accessed through a .onion domain) are automatically end-to-end encrypted.
 .br
-The person you want to share the file with just needs to use the Tor Browser to download the file from you, using the URL you sent to them over another, possibly encrypted, channel like encrypted e-mail or chat.
+In the case of OnionShare, the crypto key lives in /tmp/onionshare_XXX/private_key. The .onion URL address itself is a fingerprint of the key, which lets the Tor network look up the public key and start an encrypted session. So as long as you transmit the OnionShare URL successfully, the recipient who loads it in Tor Browser gets an end-to-end encrypted session with the server.
+.br
+The person you want to share the file with just needs to use the Tor Browser to download the file from you, using the URL you sent to them over another, possibly encrypted, channel like encrypted e-mail or a chat using OTR.
 .br
 It takes around 30 seconds until the hidden service is available over the Tor network.
 .br

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/collab-maint/onionshare.git