Merge pull request #1054 from lukaszstolarczuk/fix-stage-docs

update docs

Author: lukaszstolarczuk

include/libpmemobj++/container/concurrent_hash_map.hpp

@@ -1965,12 +1965,12 @@ class concurrent_hash_map
 	{
 		if (layout_features.incompat != header_features().incompat)
 			throw pmem::layout_error(
-				"Incompat flags mismatch, for more details go to: https://pmem.io/pmdk/cpp_obj/ \n");
+				"Incompat flags mismatch, for more details go to: https://pmem.io/libpmemobj-cpp\n");
 
 		if ((layout_features.compat & FEATURE_CONSISTENT_SIZE) &&
 		    this->value_size != sizeof(value_type))
 			throw pmem::layout_error(
-				"Size of value_type is different than the one stored in the pool \n");
+				"Size of value_type is different than the one stored in the pool\n");
 	}
 
 public:

include/libpmemobj++/pool.hpp

@@ -448,10 +448,14 @@ class pool_base {
 	PMEMobjpool *pop;
 
 #ifndef _WIN32
-	/* Default create mode */
+	/**
+	 * Default create mode
+	 */
 	static const int DEFAULT_MODE = S_IWUSR | S_IRUSR;
 #else
-	/* Default create mode */
+	/**
+	 * Default create mode
+	 */
 	static const int DEFAULT_MODE = S_IWRITE | S_IREAD;
 #endif
 };

include/libpmemobj++/transaction.hpp

@@ -443,16 +443,22 @@ class transaction_base {
 		}
 	}
 
-	/**
-	 * Possible stages of a transaction, for every stage one or more
-	 * callbacks can be registered.
+	/*! \enum stage
+		\brief Possible stages of a transaction.
+
+		For every stage one or more callbacks can be registered
+		(see transaction::register_callback()).
+
+		To read more about PMDK's transactions and their stages, see
+		manpage pmemobj_tx_begin(3):
+		https://pmem.io/pmdk/manpages/linux/master/libpmemobj/pmemobj_tx_begin.3
 	 */
 	enum class stage {
-		work = TX_STAGE_WORK,	      /* transaction in progress */
-		oncommit = TX_STAGE_ONCOMMIT, /* successfully committed */
-		onabort = TX_STAGE_ONABORT,   /* tx_begin failed or transaction
-						 aborted */
-		finally = TX_STAGE_FINALLY,   /* ready for cleanup */
+		work = TX_STAGE_WORK,	      /**< transaction in progress */
+		oncommit = TX_STAGE_ONCOMMIT, /**< successfully committed */
+		onabort = TX_STAGE_ONABORT, /**< tx_begin failed or transaction
+					       aborted */
+		finally = TX_STAGE_FINALLY, /**< ready for cleanup */
 	};
 
 	/**