[NOBIN] Added comments for Doxygen

include/pe_sieve_api.h

@@ -1,3 +1,8 @@
+/**
+* @file
+* @brief   The API: definitions of the exported elements that are accessible from PE-sieve DLL.
+*/
+
 #pragma once
 
 #include <windows.h>

include/pe_sieve_return_codes.h

@@ -1,8 +1,13 @@
+/**
+* @file
+* @brief   The codes returned by the PE-sieve EXE
+*/
+
 #pragma once
 
 // return codes for PE-sieve.exe:
 typedef enum {
-	PESIEVE_ERROR = (-1),   ///< PE-sieve returned error
+	PESIEVE_ERROR = (-1),   ///< the scan has failed, PE-sieve returned an error
 	PESIEVE_INFO = 0,   ///< PE-sieve was deployed in the info mode (i.e. displaying help)
 	PESIEVE_NOT_DETECTED = 1, ///< the process was scanned successfuly, and NO suspicious indicators are detected
 	PESIEVE_DETECTED = 2   ///< the process was scanned successfuly, and some suspicious indicators are detected

include/pe_sieve_types.h

@@ -1,7 +1,11 @@
+/**
+* @file
+* @brief   The types used by PE-sieve API.
+*/
+
 #pragma once
 
 #include <windows.h>
-
 #include <pshpack4.h> // ensure 4 byte packing of the structures
 
 #define MAX_MODULE_BUF_LEN 1024

scanners/hook_targets_resolver.h

@@ -5,10 +5,11 @@
 
 namespace pesieve {
 
+	//!  Process the list of collected patches, and for those of them that were detected as hooks, it resolves information to which modules do they lead to.
 	class HookTargetResolver
 	{
 	public:
-		HookTargetResolver(ProcessScanReport& process_report)
+		HookTargetResolver(IN ProcessScanReport& process_report)
 			: processReport(process_report)
 		{
 		}

scanners/iat_scanner.h

@@ -7,6 +7,7 @@
 
 namespace pesieve {
 
+	//!  A report from an IAT scan, generated by IATScanner
 	class IATScanReport : public ModuleScanReport
 	{
 	public: