diff --git a/src/engine/gnc-budget.h b/src/engine/gnc-budget.h
index e17d9122a5..b439cfcba2 100644
--- a/src/engine/gnc-budget.h
+++ b/src/engine/gnc-budget.h
@@ -22,7 +22,13 @@
  *                                                                  *
 \********************************************************************/
 
-/*  Design decisions:
+/** @addtogroup budget 
+ @{
+*/
+/** @file gnc-budget.h
+ * @brief GnuCash Budgets
+ *
+ *   Design decisions:
  *
  *  - The budget values that the user enters (and that are stored) for
  *  each account are inclusive of any sub-accounts.
diff --git a/src/gnome-utils/gnc-tree-model-budget.h b/src/gnome-utils/gnc-tree-model-budget.h
index 20c48f3442..841e03a8dc 100644
--- a/src/gnome-utils/gnc-tree-model-budget.h
+++ b/src/gnome-utils/gnc-tree-model-budget.h
@@ -20,10 +20,13 @@
  */
 
 /** @addtogroup budget
- *     @{ */
+   @{ */
 
-/* This file provides some utilities for working with the list of
- * budgets in a book.  TODO: This file is poorly named, since it
+/** @file gnc-tree-model-budget.h
+ * @brief provides some utilities for working with the list of
+ * budgets in a book.*/
+
+/** @todo This file is poorly named, since it
  * covers both model and view.*/
 
 #ifndef __GNC_TREE_MODEL_BUDGET_H__
@@ -49,5 +52,5 @@ GncBudget *gnc_tree_model_budget_get_budget(GtkTreeModel *tm,
 void gnc_tree_model_budget_get_iter_for_budget(GtkTreeModel *tm,
                                                GtkTreeIter *iter,
                                                GncBudget *bgt);
-
+/** @} */
 #endif // __GNC_TREE_MODEL_BUDGET_H__