Updated documentation

1 files changed, 31 insertions, 3 deletions

diff --git a/base32.h b/base32.h
index 6790e59d..27e222c5 100644
--- a/base32.h
+++ b/base32.h
@@ -1,4 +1,4 @@
-// base32.h - written and placed in the public domain by Wei Dai

+// base32.h - written and placed in the public domain by Frank Palazzolo, based on hex.cpp by Wei Dai

 

 //! \file

 //! \brief Classes for Base32Encoder and Base32Decoder

@@ -14,7 +14,6 @@ NAMESPACE_BEGIN(CryptoPP)
 //! \class Base32Encoder

 //! \brief Base32 encodes data

 //! \details Converts data to base32. The default code is based on draft-ietf-idn-dude-02.txt.

-//! \details To specify alternative alpahabet or code, call Initialize() with EncodingLookupArray parameter.

 class Base32Encoder : public SimpleProxyFilter

 {

 public:

@@ -44,24 +43,53 @@ public:
 	//!     AlgorithmParameters params = MakeParameters(Pad(), false)(InsertLineBreaks(), false);

 	//!     encoder.IsolatedInitialize(params);

 	//!   </pre>

+	//! \details The default encoding alpahbet is DUDE. You can change the encoding to RFC 4648 alphabet by

+	//!   performing the following:

+	//!   <pre>

+	//!     Base32Encoder encoder;

+	//!     const byte ALPHABET[] = "ABCDEFGHIJKLMNOPQRSTUVWXYZ234567";

+	//!     AlgorithmParameters params = MakeParameters(Name::EncodingLookupArray(),(const byte *)ALPHABET);

+	//!     encoder.IsolatedInitialize(params);

+	//!   </pre>

+	//! \details If you change the encoding alphabet, then you will need to change the decoding alphabet \a and

+	//!   the decoder's lookup table.

+	//! \sa IsolatedInitialize() for an example of modifying a Base32Encoder after construction.

 	void IsolatedInitialize(const NameValuePairs &parameters);

 };

 

 //! \class Base32Decoder

 //! \brief Base32 decodes data

 //! \details Decode base32 data. The default code is based on draft-ietf-idn-dude-02.txt

-//! \details To specify alternative alpahabet or code, call Initialize() with EncodingLookupArray parameter.

 class Base32Decoder : public BaseN_Decoder

 {

 public:

 	//! \brief Construct a Base32Decoder

 	//! \param attachment a BufferedTrasformation to attach to this object

+	//! \sa IsolatedInitialize() for an example of modifying a Base32Decoder after construction.

 	Base32Decoder(BufferedTransformation *attachment = NULL)

 		: BaseN_Decoder(GetDefaultDecodingLookupArray(), 5, attachment) {}

 

+	//! \brief Initialize or reinitialize this object, without signal propagation

+	//! \param parameters a set of NameValuePairs used to initialize this object

+	//! \details IsolatedInitialize() is used to initialize or reinitialize an object using a variable

+	//!   number of arbitrarily typed arguments. IsolatedInitialize() does not call Initialize() on attached

+	//!   transformations. If initialization should be propagated, then use the Initialize() function.

+	//! \details The default decoding alpahbet is DUDE. You can change the to RFC 4868 alphabet by

+	//!   performing the following:

+	//!   <pre>

+	//!     int lookup[256];

+	//!     const byte ALPHABET[] = "ABCDEFGHIJKLMNOPQRSTUVWXYZ234567";

+	//!     Base32Decoder::InitializeDecodingLookupArray(lookup, ALPHABET, 32, true /*insensitive*/);

+	//!

+	//!     Base32Decoder decoder;

+	//!     AlgorithmParameters params = MakeParameters(Name::DecodingLookupArray(),(const int *)lookup);

+	//!     decoder.IsolatedInitialize(params);

+	//!   </pre>

 	void IsolatedInitialize(const NameValuePairs &parameters);

 

 private:

+	//! \brief Provides the default decoding lookup table

+	//! \return default decoding lookup table

 	static const int * CRYPTOPP_API GetDefaultDecodingLookupArray();

 };