aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorpukkamustard <pukkamustard@posteo.net>2020-12-06 21:09:28 +0100
committerpukkamustard <pukkamustard@posteo.net>2020-12-07 08:43:19 +0100
commitf5813d3a9b3b33ea5edd01167c486b7f4d43f034 (patch)
treea6449e5a7138e8373e270ae28466a368b4b2dd7d /doc
parent6dbc527f6bc4971bc843162a5b8d1ebf4b60f848 (diff)
tree-wide: bits and pieces everywhere
Diffstat (limited to 'doc')
-rw-r--r--doc/eris.adoc17
-rw-r--r--doc/eris.texi20
2 files changed, 17 insertions, 20 deletions
diff --git a/doc/eris.adoc b/doc/eris.adoc
index 367cd7b..2c70395 100644
--- a/doc/eris.adoc
+++ b/doc/eris.adoc
@@ -106,7 +106,10 @@ ERIS uses two block sizes: 1KiB (1024 bytes) and 32KiB (32768 bytes). The block
Both block sizes can be used to encode content of arbitrary size. The block size of 1KiB is an optimization towards smaller content.
-Content smaller than TODO SHOULD be encoded with block size 1KiB, content larger than TODO SHOULD be encoded with block size 32KiB.
+[TODO]
+====
+TODO: Content smaller than TODO SHOULD be encoded with block size 1KiB, content larger than TODO SHOULD be encoded with block size 32KiB.
+====
The block size is encoded in the read capability and the decoding process is capable of handling both cases.
@@ -117,6 +120,7 @@ When using block size 32KiB to encode content smaller than 1KiB, the content wil
On the other hand, using small block sizes increases the number of internal nodes that must be used to encode the content (see <<_collect_reference_key_pairs_in_nodes>>). When encoding larger content it is more efficient to use a block size of 32KiB.
====
+
=== Convergence Secret
Using the hash of the content as key is called _convergent encryption_.
@@ -485,19 +489,22 @@ Further implementations are being developed in https://github.com/cjslep/eris/[G
== Acknowledgments
+Thanks to Cory Slep, Arne Babenhauserheide, Serge Wroclawski, Christopher Lemmer Webber, Christian Grothoff, Natacha, Hellekin, Nemael, TG, Devan, Emery, Arie, Allen and many others for the discussions, suggestions and support.
+
+Development of ERIS has been supported by the https://nlnet.nl[NLNet Foundation] trough the https://nlnet.nl/discovery/[NGI0 Discovery Fund].
:sectnums!:
== Changelog
[discrete]
-=== link:eris-v0.1.html[v0.1.0 (11. June 2020)]
+=== http://purl.org/eris[v0.2.0-draft (UNRELEASED)]
-Initial version.
+Major update of encoding that removes the _verification capability_ - ability to verify integrity of content without reading content.
[discrete]
-=== http://purl.org/eris[v0.2.0-draft (UNRELEASED)]
+=== link:eris-v0.1.html[v0.1.0 (11. June 2020)]
-Major update of encoding that removes the _verification capability_ - ability to verify integrity of content without reading content.
+Initial version.
== Copyright
diff --git a/doc/eris.texi b/doc/eris.texi
index 1c10efd..3447881 100644
--- a/doc/eris.texi
+++ b/doc/eris.texi
@@ -44,12 +44,14 @@ Edition @value{EDITION} @*
@node Top
@top Guile-ERIS
-This document describes Guile-ERIS version @value{VERSION}.
+This document will describes Guile-ERIS version @value{VERSION}.
+
+@quotation Warning
+This manual is incomplete.
+@end quotation
@menu
* Introduction:: About ERIS.
-* Encoding and Decoding:: Encoding and decoding content with ERIS.
-* Streaming Interface:: Encoding as transducing.
@end menu
@c *********************************************************************
@@ -58,18 +60,6 @@ This document describes Guile-ERIS version @value{VERSION}.
The Encoding for Robust Immutable Storage (ERIS) is an encoding of arbitrary content into a set of uniformly sized, encrypted and content-addressed blocks as well as a read capability. The content can be reassembled from the encrypted blocks only with this read capability. The read capability can be encoded as an URN allowing encoded content to be referenced from existing applications.
-This manual documents the Guile implementation of ERIS.
-
For more information on ERIS see the @url{http://purl.org/eris, specification}.
-@node Encoding and Decoding
-@chapter Encoding and Decoding
-
-
-@node Block Storage
-@section Block Storage
-
-@node Streaming Interface
-@chapter Streaming Interface
-
@bye