# HG changeset patch # User Paul Boddie # Date 1389546603 -3600 # Node ID c70344d07480aa86e7bc7699e16c6473997d4a59 # Parent d9c2cb62387da6ff74b099a7bafdf809788cfe8c Added a description of the structure of MoinMessages. diff -r d9c2cb62387d -r c70344d07480 README.txt --- a/README.txt Sun Jan 12 18:09:20 2014 +0100 +++ b/README.txt Sun Jan 12 18:10:03 2014 +0100 @@ -3,12 +3,21 @@ MoinMessage provides a library for creating, signing, encrypting, decrypting, and verifying PGP/GPG content in Python along with mechanisms for updating -MoinMoin wiki instances with such content such that contributors can be -identified from their PGP signatures and such details used to authenticate +MoinMoin wiki instances with such content in such a way that contributors can +be identified from their PGP signatures and such details used to authenticate their contributions. It also permits PGP/GPG content to be stored in dedicated message stores when received, enabling further processing of received content and other means of perusal of such content. +A MoinMessage as understood by this software consists of content that is first +signed and then optionally encrypted, where this latter encryption step is +used to limit the audience of a message to its recipient and thus to restrict +knowledge of the message's author to the recipient. An extra signing step may +be employed to authenticate the sender of the message for the recipient, thus +providing a way of propagating encrypted messages between parties who trust +each other without any decryption of the content or access to details about +the author of the content. + Configuring GPG for a Wiki --------------------------