Removed a bunch of empty comments

41 files changed, 0 insertions, 538 deletions

diff --git a/src/account.h b/src/account.h
index dc1d6c9a..0ac1aeb6 100644
--- a/src/account.h
+++ b/src/account.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup data
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _ACCOUNT_H
 #define _ACCOUNT_H
@@ -57,11 +53,6 @@ class post_t;
 typedef std::list<post_t *> posts_list;
 typedef std::map<const string, account_t *> accounts_map;
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class account_t : public supports_flags<>, public scope_t
 {
 #define ACCOUNT_NORMAL 0x00	// no flags at all, a basic account
diff --git a/src/accum.h b/src/accum.h
index c29926d5..878c2b7c 100644
--- a/src/accum.h
+++ b/src/accum.h
@@ -38,21 +38,12 @@
  * @author John Wiegley
  *
  * @ingroup util
- *
- * @brief Brief
- *
- * Full.
  */
 #ifndef _ACCUM_H
 #define _ACCUM_H
 
 namespace ledger {
 
-/**
- * @brief Brief
- *
- * Full.
- */
 class straccbuf : public std::streambuf
 {
 protected:
@@ -68,11 +59,6 @@ protected:
   friend class straccstream;
 };
 
-/**
- * @brief Brief
- *
- * Full.
- */
 class straccstream : public std::ostream
 {
 protected:
diff --git a/src/annotate.h b/src/annotate.h
index 0f940849..9ca994c9 100644
--- a/src/annotate.h
+++ b/src/annotate.h
@@ -48,11 +48,6 @@
 
 namespace ledger {
 
-/**
- * @brief Brief
- *
- * Long.
- */
 struct annotation_t : public supports_flags<>,
 		      public equality_comparable<annotation_t>
 {
@@ -174,11 +169,6 @@ inline std::ostream& operator<<(std::ostream&       out,
   return out;
 }
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class annotated_commodity_t
   : public commodity_t,
     public equality_comparable<annotated_commodity_t,
diff --git a/src/archive.h b/src/archive.h
index 779b57f9..60ead5a9 100644
--- a/src/archive.h
+++ b/src/archive.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup report
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _ARCHIVE_H
 #define _ARCHIVE_H
@@ -50,11 +46,6 @@
 
 namespace ledger {
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class archive_t
 {
   path	   file;
diff --git a/src/chain.h b/src/chain.h
index b22bb665..0384027c 100644
--- a/src/chain.h
+++ b/src/chain.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup report
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _CHAIN_H
 #define _CHAIN_H
@@ -53,11 +49,6 @@ namespace ledger {
 class post_t;
 class account_t;
 
-/**
- * @brief Brief
- *
- * Long.
- */
 template <typename T>
 struct item_handler : public noncopyable
 {
diff --git a/src/commodity.h b/src/commodity.h
index e2a17638..0d31b2bd 100644
--- a/src/commodity.h
+++ b/src/commodity.h
@@ -53,11 +53,6 @@ class keep_details_t;
 
 DECLARE_EXCEPTION(commodity_error, std::runtime_error);
 
-/**
- * @brief Brief
- *
- * Long.
- */
 struct price_point_t
 {
   datetime_t when;
@@ -77,11 +72,6 @@ private:
 #endif // HAVE_BOOST_SERIALIZATION
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class commodity_t
   : public delegates_flags<uint_least16_t>,
     public equality_comparable1<commodity_t, noncopyable>
@@ -424,11 +414,6 @@ inline std::ostream& operator<<(std::ostream& out, const commodity_t& comm) {
   return out;
 }
 
-/**
- * @brief Brief
- *
- * Long.
- */
 struct compare_amount_commodities {
   bool operator()(const amount_t * left, const amount_t * right) const;
 };
diff --git a/src/compare.h b/src/compare.h
index c0a72327..740ba275 100644
--- a/src/compare.h
+++ b/src/compare.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup data
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _COMPARE_H
 #define _COMPARE_H
@@ -56,11 +52,6 @@ class account_t;
 void push_sort_value(std::list<sort_value_t>& sort_values,
 		     expr_t::ptr_op_t node, scope_t& scope);
 
-/**
- * @brief Brief
- *
- * Long.
- */
 template <typename T>
 class compare_items
 {
diff --git a/src/derive.h b/src/derive.h
index cf764b10..0fb071a3 100644
--- a/src/derive.h
+++ b/src/derive.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup report
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _DERIVE_H
 #define _DERIVE_H
diff --git a/src/emacs.h b/src/emacs.h
index 1467cdaf..4b2a452a 100644
--- a/src/emacs.h
+++ b/src/emacs.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup report
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _EMACS_H
 #define _EMACS_H
@@ -52,11 +48,6 @@ namespace ledger {
 
 class xact_t;
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class format_emacs_posts : public item_handler<post_t>
 {
   format_emacs_posts();
diff --git a/src/error.h b/src/error.h
index 21f5bd8f..5369faf1 100644
--- a/src/error.h
+++ b/src/error.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup util
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _ERROR_H
 #define _ERROR_H
diff --git a/src/expr.h b/src/expr.h
index fc6a76b1..9350a8b2 100644
--- a/src/expr.h
+++ b/src/expr.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup expr
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _EXPR_H
 #define _EXPR_H
@@ -60,11 +56,6 @@ class call_scope_t;
 
 typedef function<value_t (call_scope_t&)> function_t;
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class expr_t
 {
   struct token_t;
diff --git a/src/filters.h b/src/filters.h
index 42503945..d6fcb805 100644
--- a/src/filters.h
+++ b/src/filters.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup report
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _FILTERS_H
 #define _FILTERS_H
@@ -59,11 +55,6 @@ namespace ledger {
 // Posting filters
 //
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class ignore_posts : public item_handler<post_t>
 {
 public:
@@ -72,11 +63,6 @@ public:
 
 class posts_iterator;
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class pass_down_posts : public item_handler<post_t>
 {
   pass_down_posts();
@@ -89,11 +75,6 @@ public:
   }
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class push_to_posts_list : public item_handler<post_t>
 {
   push_to_posts_list();
@@ -113,11 +94,6 @@ public:
   }
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class truncate_xacts : public item_handler<post_t>
 {
   int head_count;
@@ -145,11 +121,6 @@ public:
   virtual void operator()(post_t& post);
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class sort_posts : public item_handler<post_t>
 {
   typedef std::deque<post_t *> posts_deque;
@@ -190,11 +161,6 @@ public:
   }
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class sort_xacts : public item_handler<post_t>
 {
   sort_posts sorter;
@@ -234,11 +200,6 @@ public:
   }
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class filter_posts : public item_handler<post_t>
 {
   item_predicate pred;
@@ -267,11 +228,6 @@ public:
   }
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class anonymize_posts : public item_handler<post_t>
 {
   temporaries_t temps;
@@ -291,11 +247,6 @@ public:
   virtual void operator()(post_t& post);
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class calc_posts : public item_handler<post_t>
 {
   post_t * last_post;
@@ -319,11 +270,6 @@ public:
   virtual void operator()(post_t& post);
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class collapse_posts : public item_handler<post_t>
 {
   expr_t&	      amount_expr;
@@ -368,11 +314,6 @@ public:
   virtual void operator()(post_t& post);
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class related_posts : public item_handler<post_t>
 {
   posts_list posts;
@@ -399,11 +340,6 @@ public:
   }
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class changed_value_posts : public item_handler<post_t>
 {
   // This filter requires that calc_posts be used at some point
@@ -451,11 +387,6 @@ public:
   virtual void operator()(post_t& post);
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class subtotal_posts : public item_handler<post_t>
 {
   subtotal_posts();
@@ -517,11 +448,6 @@ public:
   virtual void operator()(post_t& post);
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class interval_posts : public subtotal_posts
 {
   date_interval_t interval;
@@ -590,11 +516,6 @@ public:
   }
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class by_payee_posts : public item_handler<post_t>
 {
   typedef std::map<string, shared_ptr<subtotal_posts> >  payee_subtotals_map;
@@ -618,11 +539,6 @@ class by_payee_posts : public item_handler<post_t>
   virtual void operator()(post_t& post);
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class transfer_details : public item_handler<post_t>
 {
   account_t *	master;
@@ -655,11 +571,6 @@ public:
   virtual void operator()(post_t& post);
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class dow_posts : public subtotal_posts
 {
   posts_list days_of_the_week[7];
@@ -681,11 +592,6 @@ public:
   }
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class generate_posts : public item_handler<post_t>
 {
   generate_posts();
@@ -712,11 +618,6 @@ public:
   virtual void add_post(const date_interval_t& period, post_t& post);
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class budget_posts : public generate_posts
 {
 #define BUDGET_NO_BUDGET   0x00
@@ -743,11 +644,6 @@ public:
   virtual void operator()(post_t& post);
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class forecast_posts : public generate_posts
 {
   item_predicate    pred;
@@ -779,11 +675,6 @@ class forecast_posts : public generate_posts
 
 class accounts_iterator;
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class pass_down_accounts : public item_handler<account_t>
 {
   pass_down_accounts();
diff --git a/src/flags.h b/src/flags.h
index 791b3105..69e40e4b 100644
--- a/src/flags.h
+++ b/src/flags.h
@@ -38,20 +38,11 @@
  * @author John Wiegley
  *
  * @ingroup util
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _FLAGS_H
 #define _FLAGS_H
 
 
-/**
- * @brief Brief
- *
- * Long.
- */
 template <typename T = boost::uint_least8_t, typename U = T>
 class supports_flags
 {
@@ -112,11 +103,6 @@ private:
 #endif // HAVE_BOOST_SERIALIZATION
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 template <typename T = boost::uint_least8_t, typename U = T>
 class basic_flags_t : public supports_flags<T, U>
 {
@@ -168,11 +154,6 @@ public:
   }
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 template <typename T = boost::uint_least8_t>
 class delegates_flags : public boost::noncopyable
 {
diff --git a/src/format.h b/src/format.h
index 8b2a7965..8043594b 100644
--- a/src/format.h
+++ b/src/format.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup expr
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _FORMAT_H
 #define _FORMAT_H
@@ -54,11 +50,6 @@ class unistring;
 
 DECLARE_EXCEPTION(format_error, std::runtime_error);
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class format_t : public noncopyable
 {
   struct element_t : public supports_flags<>
diff --git a/src/generate.h b/src/generate.h
index ee8c564d..66513fc8 100644
--- a/src/generate.h
+++ b/src/generate.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup report
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _GENERATE_H
 #define _GENERATE_H
diff --git a/src/hooks.h b/src/hooks.h
index 511749ca..da6fcf84 100644
--- a/src/hooks.h
+++ b/src/hooks.h
@@ -38,20 +38,10 @@
  * @author John Wiegley
  *
  * @ingroup util
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _HOOKS_H
 #define _HOOKS_H
 
-
-/**
- * @brief Brief
- *
- * Long.
- */
 template <typename T, typename Data>
 class hooks_t : public boost::noncopyable
 {
diff --git a/src/interactive.h b/src/interactive.h
index 0396b1c8..199b7b71 100644
--- a/src/interactive.h
+++ b/src/interactive.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup expr
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _INTERACTIVE_H
 #define _INTERACTIVE_H
@@ -50,11 +46,6 @@
 
 namespace ledger {
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class interactive_t : public noncopyable
 {
   call_scope_t& args;
diff --git a/src/item.h b/src/item.h
index ea510a5e..84385eb7 100644
--- a/src/item.h
+++ b/src/item.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup data
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _ITEM_H
 #define _ITEM_H
@@ -97,11 +93,6 @@ private:
 #endif // HAVE_BOOST_SERIALIZATION
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class item_t : public supports_flags<>, public scope_t
 {
 public:
diff --git a/src/iterators.h b/src/iterators.h
index 8aa1b451..1cbe4c25 100644
--- a/src/iterators.h
+++ b/src/iterators.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup data
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _ITERATORS_H
 #define _ITERATORS_H
@@ -55,11 +51,6 @@ namespace ledger {
 
 class journal_t;
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class posts_iterator : public noncopyable
 {
 public:
@@ -67,11 +58,6 @@ public:
   virtual post_t * operator()() = 0;
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class xact_posts_iterator : public posts_iterator
 {
   posts_list::iterator posts_i;
@@ -106,11 +92,6 @@ public:
   }
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class xacts_iterator : public noncopyable
 {
 public:
@@ -135,11 +116,6 @@ public:
   xact_t * operator()();
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class journal_posts_iterator : public posts_iterator
 {
   xacts_iterator     xacts;
@@ -162,11 +138,6 @@ public:
   virtual post_t * operator()();
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class posts_commodities_iterator : public posts_iterator
 {
 protected:
@@ -193,11 +164,6 @@ public:
   virtual post_t * operator()();
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class accounts_iterator : public noncopyable
 {
 public:
@@ -205,11 +171,6 @@ public:
   virtual account_t * operator()() = 0;
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class basic_accounts_iterator : public accounts_iterator
 {
   std::list<accounts_map::const_iterator> accounts_i;
@@ -235,11 +196,6 @@ public:
   virtual account_t * operator()();
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class sorted_accounts_iterator : public accounts_iterator
 {
   expr_t sort_cmp;
diff --git a/src/journal.h b/src/journal.h
index ff2b5f84..78269348 100644
--- a/src/journal.h
+++ b/src/journal.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup data
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _JOURNAL_H
 #define _JOURNAL_H
@@ -64,11 +60,6 @@ typedef std::list<xact_t *>	   xacts_list;
 typedef std::list<auto_xact_t *>   auto_xacts_list;
 typedef std::list<period_xact_t *> period_xacts_list;
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class journal_t : public noncopyable
 {
 public:
diff --git a/src/mask.h b/src/mask.h
index 62df9b63..a7dea7cf 100644
--- a/src/mask.h
+++ b/src/mask.h
@@ -51,11 +51,6 @@
 
 namespace ledger {
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class mask_t
 {
 public:
diff --git a/src/op.h b/src/op.h
index 2c15186b..60c80557 100644
--- a/src/op.h
+++ b/src/op.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup expr
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _OP_H
 #define _OP_H
@@ -50,11 +46,6 @@
 
 namespace ledger {
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class expr_t::op_t : public noncopyable
 {
   friend class expr_t;
diff --git a/src/option.h b/src/option.h
index c9903c03..b81c2ce7 100644
--- a/src/option.h
+++ b/src/option.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup expr
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _OPTION_H
 #define _OPTION_H
diff --git a/src/output.h b/src/output.h
index 5e06db9a..96afc77c 100644
--- a/src/output.h
+++ b/src/output.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup report
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _OUTPUT_H
 #define _OUTPUT_H
@@ -57,11 +53,6 @@ class xact_t;
 class post_t;
 class report_t;
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class format_posts : public item_handler<post_t>
 {
 protected:
@@ -84,11 +75,6 @@ public:
   virtual void operator()(post_t& post);
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class format_accounts : public item_handler<account_t>
 {
 protected:
diff --git a/src/parser.h b/src/parser.h
index 9c80cf38..71e8d973 100644
--- a/src/parser.h
+++ b/src/parser.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup expr
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _PARSER_H
 #define _PARSER_H
@@ -51,11 +47,6 @@
 
 namespace ledger {
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class expr_t::parser_t : public noncopyable
 {
 public:
diff --git a/src/pool.h b/src/pool.h
index 76257676..7328df9d 100644
--- a/src/pool.h
+++ b/src/pool.h
@@ -48,11 +48,6 @@
 
 namespace ledger {
 
-/**
- * @brief Brief
- *
- * Long.
- */
 struct cost_breakdown_t
 {
   amount_t amount;
@@ -60,11 +55,6 @@ struct cost_breakdown_t
   amount_t basis_cost;
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class commodity_pool_t : public noncopyable
 {
   /**
diff --git a/src/post.h b/src/post.h
index 42217d60..8f51ca84 100644
--- a/src/post.h
+++ b/src/post.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup data
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _POST_H
 #define _POST_H
@@ -53,11 +49,6 @@ namespace ledger {
 class xact_t;
 class account_t;
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class post_t : public item_t
 {
 public:
diff --git a/src/precmd.h b/src/precmd.h
index b36d33e1..e0f81cf8 100644
--- a/src/precmd.h
+++ b/src/precmd.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup report
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _PRECMD_H
 #define _PRECMD_H
diff --git a/src/predicate.h b/src/predicate.h
index 739356b6..eea7431c 100644
--- a/src/predicate.h
+++ b/src/predicate.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup expr
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _PREDICATE_H
 #define _PREDICATE_H
@@ -52,11 +48,6 @@
 
 namespace ledger {
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class item_predicate
 {
 public:
diff --git a/src/pstream.h b/src/pstream.h
index 43153e5c..00caf4e0 100644
--- a/src/pstream.h
+++ b/src/pstream.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup util
- *
- * @brief Brief
- *
- * Full
  */
 #ifndef _PSTREAM_H
 #define _PSTREAM_H
diff --git a/src/quotes.h b/src/quotes.h
index 5db69d1f..d00c5bfd 100644
--- a/src/quotes.h
+++ b/src/quotes.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup extra
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _QUOTES_H
 #define _QUOTES_H
diff --git a/src/report.h b/src/report.h
index 08582075..515dbd26 100644
--- a/src/report.h
+++ b/src/report.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup report
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _REPORT_H
 #define _REPORT_H
@@ -104,11 +100,6 @@ class xact_t;
 //    says that the formatter should be "flushed" after the entities are
 //    iterated.  This does not happen for the commodities iteration, however.
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class report_t : public scope_t
 {
   report_t();
diff --git a/src/scope.h b/src/scope.h
index c2c9df20..cd7d93c7 100644
--- a/src/scope.h
+++ b/src/scope.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup expr
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _SCOPE_H
 #define _SCOPE_H
@@ -50,11 +46,6 @@
 
 namespace ledger {
 
-/**
- * @brief Brief
- *
- * Long.
- */
 struct symbol_t
 {
   enum kind_t {
@@ -105,11 +96,6 @@ private:
 #endif // HAVE_BOOST_SERIALIZATION
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class scope_t
 {
 public:
@@ -138,11 +124,6 @@ private:
 #endif // HAVE_BOOST_SERIALIZATION
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class child_scope_t : public noncopyable, public scope_t
 {
 public:
@@ -186,11 +167,6 @@ private:
 #endif // HAVE_BOOST_SERIALIZATION
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class symbol_scope_t : public child_scope_t
 {
   typedef std::map<symbol_t, expr_t::ptr_op_t> symbol_map;
@@ -228,11 +204,6 @@ private:
 #endif // HAVE_BOOST_SERIALIZATION
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class call_scope_t : public child_scope_t
 {
   value_t args;
@@ -301,11 +272,6 @@ private:
 #endif // HAVE_BOOST_SERIALIZATION
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class bind_scope_t : public child_scope_t
 {
   bind_scope_t();
@@ -349,11 +315,6 @@ private:
 #endif // HAVE_BOOST_SERIALIZATION
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 template <typename T>
 T * search_scope(scope_t * ptr)
 {
diff --git a/src/session.h b/src/session.h
index 579f87a8..bde37f46 100644
--- a/src/session.h
+++ b/src/session.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup report
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _SESSION_H
 #define _SESSION_H
@@ -57,11 +53,6 @@ namespace ledger {
 class commodity_pool_t;
 class xact_t;
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class session_t : public symbol_scope_t
 {
   friend void set_session_context(session_t * session);
diff --git a/src/stats.h b/src/stats.h
index db8e9a0d..d2d10de6 100644
--- a/src/stats.h
+++ b/src/stats.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup report
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _STATS_H
 #define _STATS_H
diff --git a/src/temps.h b/src/temps.h
index 34494ba8..4243079c 100644
--- a/src/temps.h
+++ b/src/temps.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup report
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _TEMPS_H
 #define _TEMPS_H
diff --git a/src/timelog.h b/src/timelog.h
index 85ea56c6..7d79af3e 100644
--- a/src/timelog.h
+++ b/src/timelog.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup data
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _TIMELOG_H
 #define _TIMELOG_H
@@ -54,11 +50,6 @@ namespace ledger {
 class account_t;
 class journal_t;
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class time_xact_t
 {
 public:
@@ -85,11 +76,6 @@ public:
   }
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class time_log_t
 {
   std::list<time_xact_t> time_xacts;
diff --git a/src/token.h b/src/token.h
index 50d2bf72..17061e7f 100644
--- a/src/token.h
+++ b/src/token.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup expr
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _TOKEN_H
 #define _TOKEN_H
@@ -50,11 +46,6 @@
 
 namespace ledger {
 
-/**
- * @brief Brief
- *
- * Long.
- */
 struct expr_t::token_t : public noncopyable
 {
   enum kind_t {
diff --git a/src/unistring.h b/src/unistring.h
index bc55b016..7c433d9d 100644
--- a/src/unistring.h
+++ b/src/unistring.h
@@ -38,15 +38,10 @@
  * @author John Wiegley
  *
  * @ingroup utils
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _UNISTRING_H
 #define _UNISTRING_H
 
-
 namespace ledger {
 
 /**
diff --git a/src/utils.h b/src/utils.h
index a8784a66..48435844 100644
--- a/src/utils.h
+++ b/src/utils.h
@@ -165,8 +165,6 @@ void report_memory(std::ostream& out, bool report_all = false);
 #if defined(STRING_VERIFY_ON)
 
 /**
- * @brief Brief
- *
  * This string type is a wrapper around std::string that allows us to
  * trace constructor and destructor calls.
  */
diff --git a/src/xact.h b/src/xact.h
index ecdf12ad..7aee5eb7 100644
--- a/src/xact.h
+++ b/src/xact.h
@@ -38,10 +38,6 @@
  * @author John Wiegley
  *
  * @ingroup data
- *
- * @brief Brief
- *
- * Long.
  */
 #ifndef _XACT_H
 #define _XACT_H
@@ -56,11 +52,6 @@ class journal_t;
 
 typedef std::list<post_t *> posts_list;
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class xact_base_t : public item_t
 {
 public:
@@ -109,11 +100,6 @@ private:
 #endif // HAVE_BOOST_SERIALIZATION
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class xact_t : public xact_base_t
 {
 public:
@@ -154,21 +140,11 @@ private:
 #endif // HAVE_BOOST_SERIALIZATION
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 struct xact_finalizer_t {
   virtual ~xact_finalizer_t() {}
   virtual bool operator()(xact_t& xact, bool post) = 0;
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class auto_xact_t : public xact_base_t
 {
 public:
@@ -207,11 +183,6 @@ private:
 #endif // HAVE_BOOST_SERIALIZATION
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 struct auto_xact_finalizer_t : public xact_finalizer_t
 {
   journal_t * journal;
@@ -245,11 +216,6 @@ private:
 #endif // HAVE_BOOST_SERIALIZATION
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class period_xact_t : public xact_base_t
 {
  public:
@@ -287,11 +253,6 @@ private:
 #endif // HAVE_BOOST_SERIALIZATION
 };
 
-/**
- * @brief Brief
- *
- * Long.
- */
 class func_finalizer_t : public xact_finalizer_t
 {
   func_finalizer_t();