** Don't fear the files-changed list, almost all changes are in the **

** file-level documentation at the top of the sources.              **

This is the "make bugzilla stop bugging me" bugfix commit.

* Remove BackedNodeBuilder<> and collapse NodeBuilder<> hierarchy.
  Updated documentation in the file.  Resolves bug #99.

* Convenience NodeBuilders (PlusNodeBuilder, OrNodeBuilder, etc.)
  moved into a separate file.  Partially resolves bug #100.

* Moved isAssociative(Kind) into kind.h (and into the CVC4::kind
  namespace) instead of metakind.h (where it was in CVC4::metakind).
  This clears up a warning (private #inclusion) from the SMT and SMT2
  parsers, and maybe makes more sense anyways, since this is based on
  the kind (and not the metakind) of an operator.

* Documentation improvement; doxygen top-level \file gestures, \brief
  gestures for files, etc.  Changed contrib/update-copyright.pl for
  this change, and post-processed to add \brief.  Resolves bug #98.

* Removed ExprManager::mkExpr(Kind) and NodeManager::mkNode(Kind).
  They no longer made sense.  Resolves bug #91.

8 files changed, 43 insertions, 19 deletions

diff --git a/src/context/cdlist.h b/src/context/cdlist.h
index a2abc08d8..e3bf4d56b 100644
--- a/src/context/cdlist.h
+++ b/src/context/cdlist.h
@@ -1,5 +1,6 @@
 /*********************                                                        */
-/** cdlist.h
+/*! \file cdlist.h
+ ** \verbatim
  ** Original author: mdeters
  ** Major contributors: none
  ** Minor contributors (to current version): barrett, taking
@@ -8,7 +9,9 @@
  ** Courant Institute of Mathematical Sciences
  ** New York University
  ** See the file COPYING in the top-level source directory for licensing
- ** information.
+ ** information.\endverbatim
+ **
+ ** \brief Context-dependent list class.
  **
  ** Context-dependent list class.
  **/
diff --git a/src/context/cdmap.h b/src/context/cdmap.h
index b0ffc91a4..28be629c4 100644
--- a/src/context/cdmap.h
+++ b/src/context/cdmap.h
@@ -1,14 +1,17 @@
 /*********************                                                        */
-/** cdmap.h
+/*! \file cdmap.h
+ ** \verbatim
  ** Original author: mdeters
  ** Major contributors: none
- ** Minor contributors (to current version): none
+ ** Minor contributors (to current version): dejan
  ** This file is part of the CVC4 prototype.
  ** Copyright (c) 2009, 2010  The Analysis of Computer Systems Group (ACSys)
  ** Courant Institute of Mathematical Sciences
  ** New York University
  ** See the file COPYING in the top-level source directory for licensing
- ** information.
+ ** information.\endverbatim
+ **
+ ** \brief Context-dependent map class.
  **
  ** Context-dependent map class.  Generic templated class for a map
  ** which must be saved and restored as contexts are pushed and
diff --git a/src/context/cdo.h b/src/context/cdo.h
index ead43b2e8..20c512fbc 100644
--- a/src/context/cdo.h
+++ b/src/context/cdo.h
@@ -1,5 +1,6 @@
 /*********************                                                        */
-/** cdo.h
+/*! \file cdo.h
+ ** \verbatim
  ** Original author: mdeters
  ** Major contributors: none
  ** Minor contributors (to current version): barrett
@@ -8,7 +9,9 @@
  ** Courant Institute of Mathematical Sciences
  ** New York University
  ** See the file COPYING in the top-level source directory for licensing
- ** information.
+ ** information.\endverbatim
+ **
+ ** \brief A context-dependent object.
  **
  ** A context-dependent object.
  **/
diff --git a/src/context/cdset.h b/src/context/cdset.h
index f51e689d5..40d504cad 100644
--- a/src/context/cdset.h
+++ b/src/context/cdset.h
@@ -1,5 +1,6 @@
 /*********************                                                        */
-/** cdset.h
+/*! \file cdset.h
+ ** \verbatim
  ** Original author: mdeters
  ** Major contributors: none
  ** Minor contributors (to current version): none
@@ -8,7 +9,9 @@
  ** Courant Institute of Mathematical Sciences
  ** New York University
  ** See the file COPYING in the top-level source directory for licensing
- ** information.
+ ** information.\endverbatim
+ **
+ ** \brief Context-dependent set class.
  **
  ** Context-dependent set class.
  **/
diff --git a/src/context/context.cpp b/src/context/context.cpp
index b003571c1..994f644a7 100644
--- a/src/context/context.cpp
+++ b/src/context/context.cpp
@@ -1,14 +1,17 @@
 /*********************                                                        */
-/** context.cpp
+/*! \file context.cpp
+ ** \verbatim
  ** Original author: mdeters
  ** Major contributors: barrett
- ** Minor contributors (to current version): dejan
+ ** Minor contributors (to current version): cconway
  ** This file is part of the CVC4 prototype.
  ** Copyright (c) 2009, 2010  The Analysis of Computer Systems Group (ACSys)
  ** Courant Institute of Mathematical Sciences
  ** New York University
  ** See the file COPYING in the top-level source directory for licensing
- ** information.
+ ** information.\endverbatim
+ **
+ ** \brief Implementation of base context operations.
  **
  ** Implementation of base context operations.
  **/
diff --git a/src/context/context.h b/src/context/context.h
index caa5fa57b..12d7c4673 100644
--- a/src/context/context.h
+++ b/src/context/context.h
@@ -1,5 +1,6 @@
 /*********************                                                        */
-/** context.h
+/*! \file context.h
+ ** \verbatim
  ** Original author: mdeters
  ** Major contributors: barrett
  ** Minor contributors (to current version): taking, dejan
@@ -8,7 +9,9 @@
  ** Courant Institute of Mathematical Sciences
  ** New York University
  ** See the file COPYING in the top-level source directory for licensing
- ** information.
+ ** information.\endverbatim
+ **
+ ** \brief Context class and context manager.
  **
  ** Context class and context manager.
  **/
diff --git a/src/context/context_mm.cpp b/src/context/context_mm.cpp
index a202edf19..6a277245e 100644
--- a/src/context/context_mm.cpp
+++ b/src/context/context_mm.cpp
@@ -1,5 +1,6 @@
 /*********************                                                        */
-/** context_mm.cpp
+/*! \file context_mm.cpp
+ ** \verbatim
  ** Original author: barrett
  ** Major contributors: mdeters
  ** Minor contributors (to current version): none
@@ -8,9 +9,11 @@
  ** Courant Institute of Mathematical Sciences
  ** New York University
  ** See the file COPYING in the top-level source directory for licensing
- ** information.
+ ** information.\endverbatim
  **
- ** Implementation of Context Memory Manaer
+ ** \brief Implementation of Context Memory Manager.
+ **
+ ** Implementation of Context Memory Manager
  **/
 
 
diff --git a/src/context/context_mm.h b/src/context/context_mm.h
index 5920859e1..1eb452113 100644
--- a/src/context/context_mm.h
+++ b/src/context/context_mm.h
@@ -1,5 +1,6 @@
 /*********************                                                        */
-/** context_mm.h
+/*! \file context_mm.h
+ ** \verbatim
  ** Original author: barrett
  ** Major contributors: mdeters
  ** Minor contributors (to current version): none
@@ -8,7 +9,9 @@
  ** Courant Institute of Mathematical Sciences
  ** New York University
  ** See the file COPYING in the top-level source directory for licensing
- ** information.
+ ** information.\endverbatim
+ **
+ ** \brief Region-based memory manager with stack-based push and pop.
  **
  ** Region-based memory manager with stack-based push and pop.  Designed
  ** for use by ContextManager.