From c034e98273560e1ecb623151fa7bf17bd3b6537a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?St=C3=A9phane=20Fillion?= Date: Sat, 21 Feb 2015 19:43:04 -0500 Subject: [PATCH] manpages: discuss about USK, SSK in fcpgenkey (1) Add a discussion about the sameness of USK and SSK keys into the manpage for fcpgenkey as this is one of the things I found harder to understand as a newbie. --- manpages/fcpgenkey.1 | 23 +++++++++++++++++++++-- 1 file changed, 21 insertions(+), 2 deletions(-) diff --git a/manpages/fcpgenkey.1 b/manpages/fcpgenkey.1 index 6acaaae..924f238 100644 --- a/manpages/fcpgenkey.1 +++ b/manpages/fcpgenkey.1 @@ -11,9 +11,28 @@ fcpgenkey \- generate a single Freenet SSK@/USK@ keypair fcpgenkey is a simple command\-line FCP client program for generating new Freenet SSK@ or USK@ public/private keypairs. -The keypair generated is written to standard output stream, with -the public key, then a newline, then the private key. +The keypair generated is written to standard output stream as SSK@ +keys, with the public key, then a newline, then the private key. +.SH "Equivalence between SSKs and USKs" +.LP +USK@ are really just a user-friendly wrapper around SSK@, which hide +the process of searching for more recent versions of a site. Any +address written using an USK@ key can also be written using an SSK@ +key. +.TP +.B +Syntax of SSK@ key: +SSK@/-/ +.TP +.B +Syntax of USK@ key: +USK@/// +.TP +.B +These two keys are completely equivalent and can be inserted as either one: +USK@z6lnO...ACAAE/freenetdocwiki/17/ +SSK@z6lnO...ACAAE/freenetdocwiki-17/ .SH "OPTIONS" .LP .TP