(svn r21845) -Codechange: move documentation towards the code to make it more likely to be updates [d-m].

src/town_cmd.cpp

@@ -157,6 +157,10 @@ void Town::InitializeLayout(TownLayout layout)
 	return Town::Get(index);
 }
 
+/**
+ * Get the cost for removing this house
+ * @return the cost (inflation corrected etc)
+ */
 Money HouseSpec::GetRemovalCost() const
 {
 	return (_price[PR_CLEAR_HOUSE] * this->removal_cost) >> 8;