[DOC] Various small corrections

Signed-off-by: Sergey Matveev <stargrave@stargrave.org>

diff --git a/doc/handshake.texi b/doc/handshake.texi
index c509c094432aa70533e35b1c581cdb0c4a234691..c469021c5fe5a1c44cb503f0bc1fd6296dd14a6a 100644 (file)
--- a/doc/handshake.texi
+++ b/doc/handshake.texi
@@ -8,15 +8,15 @@ encrypted first 64 bits of each message with client's @ref{Identity} as
 a key. It is used to transmit identity and to mark packet as handshake
 message.
 
-If @ref{Noise} is enabled, then junk data is inserted before
-@code{IDtag} to fill up packet to MTU's size.
+If @ref{Noise, noise} is enabled, then data is padded to fill up packet
+to MTU's size.
 
 @strong{Preparation stage}:
 
 @enumerate
 @item
 Client knows only his identity and passphrase written somewhere in the
-human. Server knows his identity and
+human readable form. Server knows his identity and
 @ref{Verifier structure, verifier}: @code{DSAPub}.
 @item
 Client computes verifier which produces @code{DSAPriv} and

diff --git a/doc/transport.texi b/doc/transport.texi
index f5ca87e1f0576df4af79d0df51595a16caf4c64f..4b8413b23e470b0cb58543ecaa4c92c89d572731 100644 (file)
--- a/doc/transport.texi
+++ b/doc/transport.texi
@@ -25,15 +25,16 @@ TAG || ENCRYPTED || NONCE --> PACKET
 @end verbatim
 
 @code{SERIAL} is message's serial number. Odds are reserved for
-client(->server) messages, evens for server(->client) messages.
+client (to server) messages, evens for server (to client) messages.
 
 @code{PRP} is XTEA block cipher algorithm used here as PRP (pseudo
 random permutation function) to obfuscate @code{SERIAL}. Plaintext
 @code{SERIAL} state is kept in peers internal state, but encrypted
 before transmission.
 
-XTEA's encryption key is the first 128-bit of Salsa20's output with
-established common key and zero nonce (message nonces start from 1).
+XTEA's encryption key @code{PRP_KEY} is the first 128-bit of Salsa20's
+output with established common key and zero nonce (message nonces start
+from 1).
 
 @verbatim
 PRP_KEY = 128bit(ENCRYPT(KEY, 0))
@@ -45,8 +46,7 @@ Salsa20's output is ignored and only remaining is XORed with ther data,
 encrypting it.
 
 @code{DATA} is padded with @code{PAD} (0x80 byte). Optional @code{ZEROS}
-may follow, to fillup packet with the junk to conceal pyload packet
-length.
+may follow, to fill up packet to conceal payload packet length.
 
 @code{AUTH} is Poly1305 authentication function. First 256 bits of
 Salsa20's output are used as a one-time key for @code{AUTH}.