From: Marius Gavrilescu <marius@ieval.ro>
Date: Sat, 9 Jun 2018 17:53:19 +0000 (+0300)
Subject: Write some POD
X-Git-Tag: 0.001~1
X-Git-Url: http://git.ieval.ro/?a=commitdiff_plain;h=fc1859441e3fca19e09db24f6cd81584054167e4;p=digest-highwayhash.git

Write some POD
---

diff --git a/README b/README
index 3870218..69a8bf7 100644
--- a/README
+++ b/README
@@ -1,6 +1,9 @@
 Digest-HighwayHash version 0.000_001
 ====================================
 
+HighwayHash is a fast and strong keyed hash function, documented at
+https://github.com/google/highwayhash
+
 INSTALLATION
 
 To install this module type the following:
diff --git a/lib/Digest/HighwayHash.pm b/lib/Digest/HighwayHash.pm
index 108021b..90fbf09 100644
--- a/lib/Digest/HighwayHash.pm
+++ b/lib/Digest/HighwayHash.pm
@@ -22,7 +22,7 @@ __END__
 
 =head1 NAME
 
-Digest::HighwayHash - fast strong hash function
+Digest::HighwayHash - XS fast strong keyed hash function
 
 =head1 SYNOPSIS
 
@@ -36,9 +36,34 @@ Digest::HighwayHash - fast strong hash function
 
 =head1 DESCRIPTION
 
-HighwayHash is a fast and strong hash function, documented at
+HighwayHash is a fast and strong keyed hash function, documented at
 L<https://github.com/google/highwayhash>.
 
+Three functions are exported by this module, all by default:
+
+=over
+
+=item B<highway_hash64> I<\@key>, I<$input>
+
+Compute the 64-bit HighwayHash of I<$input>, using I<\@key> as a key.
+The key must be a 4-element arrayref, with each element either a
+number or (on Perls without 64-bit numbers) a L<Math::Int64> object. The result is a single number or (on Perls without 64-bit numbers) a L<Math::Int64> object.
+
+=item B<highway_hash128> I<\@key>, I<$input>
+
+Compute the 128-bit HighwayHash of I<$input>, using I<\@key> as a key.
+The key must be a 4-element arrayref, with each element either a
+number or (on Perls without 64-bit numbers) a L<Math::Int64> object. The result is an array of exactly two numbers or (on Perls without 64-bit numbers) L<Math::Int64> objects.
+
+=item B<highway_hash256> I<\@key>, I<$input>
+
+Compute the 256-bit HighwayHash of I<$input>, using I<\@key> as a key.
+The key must be a 4-element arrayref, with each element either a
+number or (on Perls without 64-bit numbers) a L<Math::Int64> object. The result is an array of exactly four numbers or (on Perls without 64-bit numbers) L<Math::Int64> objects.
+
+
+=back
+
 =head1 SEE ALSO
 
 L<https://github.com/google/highwayhash>