Change Doxygen comment style from //! to ///

Also see https://groups.google.com/forum/#!topic/cryptopp-users/A7-Xt5Knlzw

1 files changed, 59 insertions, 59 deletions

diff --git a/files.h b/files.h
index a2bf54b9..eff2b521 100644
--- a/files.h
+++ b/files.h
@@ -1,8 +1,8 @@
 // files.h - originally written and placed in the public domain by Wei Dai

 

-//! \file files.h

-//! \brief Classes providing file-based library services

-//! \since Crypto++ 1.0

+/// \file files.h

+/// \brief Classes providing file-based library services

+/// \since Crypto++ 1.0

 

 #ifndef CRYPTOPP_FILES_H

 #define CRYPTOPP_FILES_H

@@ -17,50 +17,50 @@
 

 NAMESPACE_BEGIN(CryptoPP)

 

-//! \class FileStore

-//! \brief Implementation of Store interface

-//! \details file-based implementation of Store interface

+/// \class FileStore

+/// \brief Implementation of Store interface

+/// \details file-based implementation of Store interface

 class CRYPTOPP_DLL FileStore : public Store, private FilterPutSpaceHelper, public NotCopyable

 {

 public:

-	//! \brief Exception thrown when file-based error is encountered

+	/// \brief Exception thrown when file-based error is encountered

 	class Err : public Exception

 	{

 	public:

 		Err(const std::string &s) : Exception(IO_ERROR, s) {}

 	};

-	//! \brief Exception thrown when file-based open error is encountered

+	/// \brief Exception thrown when file-based open error is encountered

 	class OpenErr : public Err {public: OpenErr(const std::string &filename) : Err("FileStore: error opening file for reading: " + filename) {}};

-	//! \brief Exception thrown when file-based read error is encountered

+	/// \brief Exception thrown when file-based read error is encountered

 	class ReadErr : public Err {public: ReadErr() : Err("FileStore: error reading file") {}};

 

-	//! \brief Construct a FileStore

+	/// \brief Construct a FileStore

 	FileStore() : m_stream(NULLPTR), m_space(NULLPTR), m_len(0), m_waiting(0) {}

 

-	//! \brief Construct a FileStore

-	//! \param in an existing stream

+	/// \brief Construct a FileStore

+	/// \param in an existing stream

 	FileStore(std::istream &in) : m_stream(NULLPTR), m_space(NULLPTR), m_len(0), m_waiting(0)

 		{StoreInitialize(MakeParameters(Name::InputStreamPointer(), &in));}

 

-	//! \brief Construct a FileStore

-	//! \param filename the narrow name of the file to open

+	/// \brief Construct a FileStore

+	/// \param filename the narrow name of the file to open

 	FileStore(const char *filename) : m_stream(NULLPTR), m_space(NULLPTR), m_len(0), m_waiting(0)

 		{StoreInitialize(MakeParameters(Name::InputFileName(), filename ? filename : ""));}

 

 #if defined(CRYPTOPP_UNIX_AVAILABLE) || defined(CRYPTOPP_DOXYGEN_PROCESSING) || _MSC_VER >= 1400

-	//! \brief Construct a FileStore

-	//! \param filename the Unicode name of the file to open

-	//! \details On non-Windows OS, this function assumes that setlocale() has been called.

+	/// \brief Construct a FileStore

+	/// \param filename the Unicode name of the file to open

+	/// \details On non-Windows OS, this function assumes that setlocale() has been called.

 	FileStore(const wchar_t *filename)

 		{StoreInitialize(MakeParameters(Name::InputFileNameWide(), filename));}

 #endif

 

-	//! \brief Retrieves the internal stream

-	//! \returns the internal stream pointer

+	/// \brief Retrieves the internal stream

+	/// \returns the internal stream pointer

 	std::istream* GetStream() {return m_stream;}

 

-	//! \brief Retrieves the internal stream

-	//! \returns the internal stream pointer

+	/// \brief Retrieves the internal stream

+	/// \returns the internal stream pointer

 	const std::istream* GetStream() const {return m_stream;}

 

 	lword MaxRetrievable() const;

@@ -78,9 +78,9 @@ private:
 	bool m_waiting;

 };

 

-//! \class FileSource

-//! \brief Implementation of Store interface

-//! \details file-based implementation of Store interface

+/// \class FileSource

+/// \brief Implementation of Store interface

+/// \details file-based implementation of Store interface

 class CRYPTOPP_DLL FileSource : public SourceTemplate<FileStore>

 {

 public:

@@ -88,82 +88,82 @@ public:
 	typedef FileStore::OpenErr OpenErr;

 	typedef FileStore::ReadErr ReadErr;

 

-	//! \brief Construct a FileSource

+	/// \brief Construct a FileSource

 	FileSource(BufferedTransformation *attachment = NULLPTR)

 		: SourceTemplate<FileStore>(attachment) {}

 

-	//! \brief Construct a FileSource

-	//! \param in an existing stream

-	//! \param pumpAll flag indicating if source data should be pumped to its attached transformation

-	//! \param attachment an optional attached transformation

+	/// \brief Construct a FileSource

+	/// \param in an existing stream

+	/// \param pumpAll flag indicating if source data should be pumped to its attached transformation

+	/// \param attachment an optional attached transformation

 	FileSource(std::istream &in, bool pumpAll, BufferedTransformation *attachment = NULLPTR)

 		: SourceTemplate<FileStore>(attachment) {SourceInitialize(pumpAll, MakeParameters(Name::InputStreamPointer(), &in));}

 

-	//! \brief Construct a FileSource

-	//! \param filename the narrow name of the file to open

-	//! \param pumpAll flag indicating if source data should be pumped to its attached transformation

-	//! \param attachment an optional attached transformation

-	//! \param binary flag indicating if the file is binary

+	/// \brief Construct a FileSource

+	/// \param filename the narrow name of the file to open

+	/// \param pumpAll flag indicating if source data should be pumped to its attached transformation

+	/// \param attachment an optional attached transformation

+	/// \param binary flag indicating if the file is binary

 	FileSource(const char *filename, bool pumpAll, BufferedTransformation *attachment = NULLPTR, bool binary=true)

 		: SourceTemplate<FileStore>(attachment) {SourceInitialize(pumpAll, MakeParameters(Name::InputFileName(), filename)(Name::InputBinaryMode(), binary));}

 

 #if defined(CRYPTOPP_UNIX_AVAILABLE) || defined(CRYPTOPP_DOXYGEN_PROCESSING) || _MSC_VER >= 1400

-	//! \brief Construct a FileSource

-	//! \param filename the Unicode name of the file to open

-	//! \param pumpAll flag indicating if source data should be pumped to its attached transformation

-	//! \param attachment an optional attached transformation

-	//! \param binary flag indicating if the file is binary

-	//! \details On non-Windows OS, this function assumes that setlocale() has been called.

+	/// \brief Construct a FileSource

+	/// \param filename the Unicode name of the file to open

+	/// \param pumpAll flag indicating if source data should be pumped to its attached transformation

+	/// \param attachment an optional attached transformation

+	/// \param binary flag indicating if the file is binary

+	/// \details On non-Windows OS, this function assumes that setlocale() has been called.

 	FileSource(const wchar_t *filename, bool pumpAll, BufferedTransformation *attachment = NULLPTR, bool binary=true)

 		: SourceTemplate<FileStore>(attachment) {SourceInitialize(pumpAll, MakeParameters(Name::InputFileNameWide(), filename)(Name::InputBinaryMode(), binary));}

 #endif

 

-	//! \brief Retrieves the internal stream

-	//! \returns the internal stream pointer

+	/// \brief Retrieves the internal stream

+	/// \returns the internal stream pointer

 	std::istream* GetStream() {return m_store.GetStream();}

 };

 

-//! \class FileSink

-//! \brief Implementation of Store interface

-//! \details file-based implementation of Sink interface

+/// \class FileSink

+/// \brief Implementation of Store interface

+/// \details file-based implementation of Sink interface

 class CRYPTOPP_DLL FileSink : public Sink, public NotCopyable

 {

 public:

-	//! \brief Exception thrown when file-based error is encountered

+	/// \brief Exception thrown when file-based error is encountered

 	class Err : public Exception

 	{

 	public:

 		Err(const std::string &s) : Exception(IO_ERROR, s) {}

 	};

-	//! \brief Exception thrown when file-based open error is encountered

+	/// \brief Exception thrown when file-based open error is encountered

 	class OpenErr : public Err {public: OpenErr(const std::string &filename) : Err("FileSink: error opening file for writing: " + filename) {}};

-	//! \brief Exception thrown when file-based write error is encountered

+	/// \brief Exception thrown when file-based write error is encountered

 	class WriteErr : public Err {public: WriteErr() : Err("FileSink: error writing file") {}};

 

-	//! \brief Construct a FileSink

+	/// \brief Construct a FileSink

 	FileSink() : m_stream(NULLPTR) {}

 

-	//! \brief Construct a FileSink

-	//! \param out an existing stream

+	/// \brief Construct a FileSink

+	/// \param out an existing stream

 	FileSink(std::ostream &out)

 		{IsolatedInitialize(MakeParameters(Name::OutputStreamPointer(), &out));}

 

-	//! \brief Construct a FileSink

-	//! \param filename the narrow name of the file to open

-	//! \param binary flag indicating if the file is binary

+	/// \brief Construct a FileSink

+	/// \param filename the narrow name of the file to open

+	/// \param binary flag indicating if the file is binary

 	FileSink(const char *filename, bool binary=true)

 		{IsolatedInitialize(MakeParameters(Name::OutputFileName(), filename)(Name::OutputBinaryMode(), binary));}

 

 #if defined(CRYPTOPP_UNIX_AVAILABLE) || _MSC_VER >= 1400

-	//! \brief Construct a FileSink

-	//! \param filename the Unicode name of the file to open

-	//! \details On non-Windows OS, this function assumes that setlocale() has been called.

+	/// \brief Construct a FileSink

+	/// \param filename the Unicode name of the file to open

+	/// \details On non-Windows OS, this function assumes that setlocale() has been called.

 	FileSink(const wchar_t *filename, bool binary=true)

 		{IsolatedInitialize(MakeParameters(Name::OutputFileNameWide(), filename)(Name::OutputBinaryMode(), binary));}

 #endif

 

-	//! \brief Retrieves the internal stream

-	//! \returns the internal stream pointer

+	/// \brief Retrieves the internal stream

+	/// \returns the internal stream pointer

 	std::ostream* GetStream() {return m_stream;}

 

 	void IsolatedInitialize(const NameValuePairs &parameters);