--typo

[user/henk/code/shell/rif.git] / README.md

diff --git a/README.md b/README.md
index 0cbcd485951f2d01dae3f53a01f6ace7f1075551..38e9b904eccb18fec7ed19c9d11207a1222d337d 100644 (file)
--- a/README.md
+++ b/README.md
@@ -9,7 +9,7 @@ want to securely communicate with our friends. And chat with them. And
 know when they are online. Let's solve this problem once-and-for-all
 in a decentralised, sustainable and future proof way.
 
-## Here come's the real IPv6 friend
+## Here comes the real IPv6 friend
 
 Instead of using a single system or server, we use IPv6 to connect to
 our friends directly. Because each of our friends is reachable by IPv6
@@ -28,7 +28,9 @@ To become a real IPv6 friend, you need to do the following things:
 - Setup a webserver on your computer
 - Export your key and all real IPv6 friend keys to your webserver as
   "rifkeys.txt
-- For each of your friends, check whether they are online!
+- For each of your friends, check whether they are online
+- Import the friends of your friends and check whether they are
+  online, too!
 
 ### Example: Generating a key with the right comment
 
@@ -122,21 +124,64 @@ gpg -a --export RIF > /var/www/html/rifkeys
 
 ### Example: List your friends
 
+You can use the included rif-listfriends.sh or directly gpg:
+
 ```
 [1:40] line:~% gpg --list-keys --with-colons | grep RIF | awk -F: '{ print $10 }' | sed 's/\\x3a/:/'
 Nico Schottelius (RIF https://nico.ungleich.cloud) <ipv6@nico.ungleich.cloud>
 Nico Schottelius (myself) (RIF https://nico2.ungleich.cloud) <nico@nico.ungleich.cloud>
 ```
 
+
 ### Example: Checking which friends are online
 
 Use the included rif-checkfriends.sh script or iterate yourself over
 above output.
 
+```
+[1:54] line:realipv6friend% sh rif-checkfriends.sh
+Checking Nico Schottelius  on https://nico.ungleich.cloud ...
+Nico Schottelius is online
+Checking Nico Schottelius (myself)  on https://nico2.ungleich.cloud ...
+Nico Schottelius (myself) is offline
+[1:54] line:realipv6friend%
+
+```
+
+### Example: Importing friends of my friend
+
+Importing friends of a friend is as simple as importing all the
+exported keys! We import friends directly from the URL of a friend:
+
+```
+curl -6 -s https://nico.ungleich.cloud/rifkeys | gpg --import
 ```
 
+You can also use the included rif-importfriends.sh.
+
+### Example: Updating your friends
+
+Now that you have imported the friends of your friends, they have
+automatically also become your friends!
+
+Obviously, you will want to check whether you even want to sign some
+of the friends (keys) that you downloaded, but clearly you want to
+show off with the biggest amount of friends (that's what is most
+important anyway, isn't it?).
+
+In any case, to update your friend list, simply repeat the command you
+ran above already in the beginning:
 
 ```
+gpg -a --export RIF > /var/www/html/rifkeys
+```
+
+Or use the included `rif-exportfriends.sh`
+
+### Example: Sending a message to a friend
+
+Simply use your mail program for that.
+And obviously enable signing & encrypting the email.
 
 
 ## To be added