diff --git a/include/bgfx/bgfx.h b/include/bgfx/bgfx.h
index c74649bfa..46d7a3df1 100644
--- a/include/bgfx/bgfx.h
+++ b/include/bgfx/bgfx.h
@@ -851,7 +851,7 @@ namespace bgfx
 		TextureHandle handle; //!< Texture handle.
 		uint16_t mip;         //!< Mip level.
 		uint16_t layer;       //!< Cubemap side or depth layer/slice.
-		uint8_t  resolve;     //!<
+		uint8_t  resolve;     //!< Resolve flags. See: `BGFX_RESOLVE_*`
 	};
 
 	/// Transform data.
@@ -2901,7 +2901,7 @@ namespace bgfx
 	/// mip level.
 	///
 	/// @param[in] _num Number of texture attachments.
-	/// @param[in] _attachment Attachment texture info. See: `Attachment`.
+	/// @param[in] _attachment Attachment texture info. See: `bgfx::Attachment`.
 	/// @param[in] _destroyTextures If true, textures will be destroyed when
 	///   frame buffer is destroyed.
 	///
diff --git a/include/bgfx/defines.h b/include/bgfx/defines.h
index b7229843f..3b5802e81 100644
--- a/include/bgfx/defines.h
+++ b/include/bgfx/defines.h
@@ -507,8 +507,8 @@
 #define BGFX_SUBMIT_RESERVED_MASK  UINT8_C(0x80) //!< Internal bits mask.
 
 ///
-#define BGFX_RESOLVE_NONE          UINT8_C(0x00) //!<
-#define BGFX_RESOLVE_AUTO_GEN_MIPS UINT8_C(0x01) //!<
+#define BGFX_RESOLVE_NONE          UINT8_C(0x00) //!< No resolve flags.
+#define BGFX_RESOLVE_AUTO_GEN_MIPS UINT8_C(0x01) //!< Auto-generate mip maps on resolve.
 
 ///
 #define BGFX_PCI_ID_NONE                UINT16_C(0x0000) //!< Autoselect adapter.