From aa25216fe5bb23bb5e7a118114c67a1478acde4c Mon Sep 17 00:00:00 2001
From: Martin Schanzenbach <mschanzenbach@posteo.de>
Date: Fri, 28 May 2021 10:54:08 +0200
Subject: IDENTITY: Add EdDSA switch to handbook and manpage

---
 doc/handbook/chapters/user.texi | 17 +++++++++++------
 doc/man/gnunet-identity.1       |  3 +++
 2 files changed, 14 insertions(+), 6 deletions(-)

(limited to 'doc')

diff --git a/doc/handbook/chapters/user.texi b/doc/handbook/chapters/user.texi
index 409a89e47..aa912f96f 100644
--- a/doc/handbook/chapters/user.texi
+++ b/doc/handbook/chapters/user.texi
@@ -97,7 +97,7 @@ the peer identity.  The IDENTITY service essentially stores the
 private keys under human-readable names, and keeps a mapping of which
 private key should be used for particular important system functions.
 The existing identities can be listed using the command
-@command{gnunet-identity -d}
+@command{gnunet-identity --display}
 
 @example
 gnu - JTDVJC69NHU6GQS4B5721MV8VM7J6G2DVRGJV0ONIT6QH7OI6D50
@@ -1098,7 +1098,7 @@ selection is simply random.
 @subsection Namespace Management
 
 The @code{gnunet-identity} tool can be used to create egos.
-By default, @code{gnunet-identity -D} simply
+By default, @code{gnunet-identity --display} simply
 lists all locally available egos.
 
 
@@ -1110,7 +1110,7 @@ lists all locally available egos.
 @node Creating Egos
 @subsubsection Creating Egos
 
-With the @command{-C NICK} option it can also be used to create a new
+With the @command{--create=NICK} option it can also be used to create a new
 ego. An ego is the virtual identity of the entity in control of a
 namespace or GNS zone. Anyone can create any number of egos.  The
 provided NICK name automatically corresponds to a GNU Name System
@@ -1118,6 +1118,11 @@ domain name.  Thus, henceforth name resolution for any name ending in
 ``.NICK'' will use the NICK's zone.  You should avoid using NICKs that
 collide with well-known DNS names.
 
+Currently, the IDENTITY subsystem supports two types of identity keys:
+ECDSA and EdDSA. By default, ECDSA identities are creates with ECDSA keys.
+In order to create an identity with EdDSA keys, you can use the
+@command{--eddsa} flag.
+
 @node Deleting Egos
 @subsubsection Deleting Egos
 
@@ -1409,7 +1414,7 @@ You can create any number of zones using the gnunet-identity tool
 using:
 
 @example
-$ gnunet-identity -C "myzone"
+$ gnunet-identity --create="myzone"
 @end example
 
 Henceforth, on your system you control the TLD ``myzone''.
@@ -1418,7 +1423,7 @@ All of your zones can be listed (displayed) using the
 @command{gnunet-identity} command line tool as well:
 
 @example
-$ gnunet-identity -d
+$ gnunet-identity --display
 @end example
 
 @node Maintaining your own Zones
@@ -1929,7 +1934,7 @@ integrate reclaimID as an Identity Provider with little effort.
 Before adding attributes to an identity, you must first create an ego:
 
 @example
-$ gnunet-identity -C "user"
+$ gnunet-identity --create="user"
 @end example
 
 Henceforth, you can manage a new user profile of the user ``user''.
diff --git a/doc/man/gnunet-identity.1 b/doc/man/gnunet-identity.1
index 1adfdf4d0..599d3b269 100644
--- a/doc/man/gnunet-identity.1
+++ b/doc/man/gnunet-identity.1
@@ -39,6 +39,7 @@
 .Op Fl q | -quiet
 .Op Fl s Ar SUBSYSTEM | Fl -set= Ns Ar SUBSYSTEM
 .Op Fl V | -verbose
+.Op Fl X | -eddsa
 .Sh DESCRIPTION
 .Nm
 is a tool for managing egos.
@@ -94,6 +95,8 @@ This will fail if
 does not yet exist.
 .It Fl V | -verbose
 Be verbose, in particular outputs the public key of freshly created egos.
+.It Fl X | -eddsa
+Use EdDSA instead of ECDSA.
 .El
 .Sh FILES
 .Pa ~/.local/share/gnunet/identity/egos
-- 
cgit v1.2.3