diff --git a/src/stratagus/missile.cpp b/src/stratagus/missile.cpp
index 583af1376..3693674e4 100644
--- a/src/stratagus/missile.cpp
+++ b/src/stratagus/missile.cpp
@@ -503,13 +503,14 @@ local void FreeMissile(Missile* missile)
 **				    2
 **	damage is multiplied by random 1 or 2.
 **
-**	NOTE: different targets (big are hit by some missiles better)
-**	NOTE: hidden targets are hit worser.
-**	NOTE: targets higher are hit worser.
+**	@todo NOTE: different targets (big are hit by some missiles better)
+**	@todo NOTE: hidden targets are hit worser.
+**	@todo NOTE: targets higher are hit worser.
 **
 **	@param attacker_stats	Attacker attributes.
 **	@param goal_stats	Goal attributes.
 **	@param bloodlust	If attacker has bloodlust
+**	@param xp		Experience of attack.
 **
 **	@return			damage produces on goal.
 */
@@ -548,6 +549,8 @@ local int CalculateDamageStats(const UnitStats* attacker_stats,
 **	@param attacker_stats	Attacker attributes.
 **	@param goal		Goal unit.
 **	@param bloodlust	If attacker has bloodlust
+**	@param xp		Experience of attack.
+**
 **	@return			damage produces on goal.
 */
 local int CalculateDamage(const UnitStats* attacker_stats,
diff --git a/src/ui/menu_proc.cpp b/src/ui/menu_proc.cpp
index 9cb3160f0..76cec692d 100644
--- a/src/ui/menu_proc.cpp
+++ b/src/ui/menu_proc.cpp
@@ -602,7 +602,7 @@ local void DrawInput(Menuitem *mi, int mx, int my)
 /**
 **	Draw a menu.
 **
-**	@param menu_id	The menu number to display
+**	@param menu	The menu number to display (NULL allowed)
 */
 global void DrawMenu(Menu *menu)
 {