move definition of price to global file; fix dox

git-svn-id: svn+ssh://svn.gnucash.org/repo/gnucash/trunk@9134 57a11ea4-9604-0410-9ed3-97b8803252fd

src/engine/gnc-engine.h

@@ -130,16 +130,28 @@ typedef struct gnc_commodity_s       gnc_commodity;
 /** @brief A gnc_commodity_table is a database of commodity info. */
 typedef struct gnc_commodity_table_s gnc_commodity_table;
 
-typedef struct gnc_quote_source_s    gnc_quote_source;
-
-/**
- * A GNCLot implements the fundamental conceptual idea behind
- * invoices, inventory lots, and stock market investment lots.  
+/** @breif Identifies that something sold at one time was bought at another.
+ *
+ * A GNCLot provides a way of tracking physical items as they are 
+ * bought and sold in different transactions.  By identifying 
+ * the individual, underlying physical objects, it provides the
+ * needed framework for implementing depreciation, capital gains,
+ * inventory control and invoices.
  *
  * See the file src/doc/lots.txt for implmentation overview.
  */
 typedef struct gnc_lot_struct        GNCLot;
 
+/** @breif Price of commodity on a given date.
+ *
+ * A GNCPrice encapsulates price information: the cost of a commodity
+ * expressed as a currency, on a given date.  It also holds info about 
+ * the provenance of the price: where it came from, its general validity.
+ */
+typedef struct gnc_price_s           GNCPrice;
+typedef struct gnc_quote_source_s    gnc_quote_source;
+
+
 /** GList of Account */
 typedef GList                  AccountList;
 /** GList of GNCLots */

src/engine/gnc-pricedb.h

@@ -116,7 +116,6 @@
       are pointer unique.
 
  */
-typedef struct gnc_price_s GNCPrice;
 /** */
 typedef struct gnc_price_lookup_s GNCPriceLookup;