Update documentation

filters.h

@@ -36,6 +36,9 @@ NAMESPACE_BEGIN(CryptoPP)
 class CRYPTOPP_DLL CRYPTOPP_NO_VTABLE Filter : public BufferedTransformation, public NotCopyable
 {
 public:
+#ifndef CRYPTOPP_MAINTAIN_BACKWARDS_COMPATIBILITY_562
+	virtual ~Filter() {}
+#endif
 	
 	//!	\name ATTACHMENT
 	//@{
@@ -75,10 +78,6 @@ public:
 	bool Flush(bool hardFlush, int propagation=-1, bool blocking=true);
 	bool MessageSeriesEnd(int propagation=-1, bool blocking=true);
 	
-#ifndef CRYPTOPP_MAINTAIN_BACKWARDS_COMPATIBILITY_562
-	virtual ~Filter() {}
-#endif
-	
 protected:
 	virtual BufferedTransformation * NewDefaultAttachment() const;
 	void Insert(Filter *nextFilter);	// insert filter after this one
@@ -1013,7 +1012,12 @@ public:
 	ArraySink(byte *buf, size_t size)
 		: m_buf(buf), m_size(size), m_total(0) {}
 
+	//! \brief Provides the size remaining in the Sink
+	//! \returns size remaining in the Sink, in bytes
 	size_t AvailableSize() {return SaturatingSubtract(m_size, m_total);}
+
+	//! \brief Provides the number of bytes written to the Sink
+	//! \returns number of bytes written to the Sink, in bytes
 	lword TotalPutLength() {return m_total;}
 
 	void IsolatedInitialize(const NameValuePairs &parameters);
@@ -1128,6 +1132,10 @@ private:
 class CRYPTOPP_DLL CRYPTOPP_NO_VTABLE Source : public InputRejecting<Filter>
 {
 public:
+#ifndef CRYPTOPP_MAINTAIN_BACKWARDS_COMPATIBILITY_562
+	virtual ~Source() {}
+#endif
+
 	//! \brief Construct a Source
 	//! \param attachment an optional attached transformation
 	Source(BufferedTransformation *attachment = NULL)
@@ -1183,10 +1191,6 @@ public:
 
 	//@}
 
-#ifndef CRYPTOPP_MAINTAIN_BACKWARDS_COMPATIBILITY_562
-	virtual ~Source() {}
-#endif
-
 protected:
 	void SourceInitialize(bool pumpAll, const NameValuePairs &parameters)
 	{