*** empty log message ***

NEWS

@@ -6,25 +6,24 @@ New features:
 
 - Ledger now compiles under gcc 2.95.
 
-- Fixed several core engine bugs.
+- Fixed several core engine bugs, and problems with Ledger's XML data
-
+  format.
-- The configure setup has been changed to always use a combination of
-  both compile and link testing for every feature, in order to
-  identify environment problems right away.
-
-- The "D <COMM>" command, released in 2.1, now requires a regular,
-  commoditized amount, such as "D $1,000.00".  This sets not only the
-  default commodity, but also several default flags to be used with
-  all commodities (such as whether all numbering should be American or
-  European).  It may also be used be many times; which was most
-  recently seen will be the default for the entries that follow.
-
-- Fixed several bugs with Ledger's XML data format.
 
 - Erros in XML or Gnucash data now report the correct line number for
   the error, instead of always showing line 1.
 
-- The binary cache now remembers which price history database was
+- 'configure' has been changed to always use a combination of both
+  compile and link tests for every feature, in order to identify
+  environment problems right away.
+
+- The "D <COMM>" command, released in 2.1, now requires a commoditized
+  amount, such as "D $1,000.00".  This sets not only the default
+  commodity, but several flags to be used with all such commodities
+  (such as whether numbering should be American or European by
+  default).  This entry may be used be many times; the most recent
+  seen specifies the default for entries that follow.
+
+- The binary cache now remembers the price history database that was
   used, so that if LEDGER_PRICE_DB is silently changed, the cache will
   be thrown away and rebuilt.
 
@@ -32,57 +31,59 @@ New features:
   (http://libofx.sourceforge.net).  configure will check if the
   library is available.  You may need to add CPPFLAGS or LDFLAGS to
   the command-line for the appropriate headers and library to be
-  found.
+  found.  This support is preliminary, and as such is not documented
+  yet.
 
 - All journal entries now remember where they were read from.  New
-  format codes to access this information are: %S for the source path,
+  format codes to access this information are: %S for source path, %B
-  %B for the beginning character position, and %E for the ending
+  for beginning character position, and %E for ending character
-  character position.
+  position.
 
-- Added "pricesdb" command, which is identical to "prices", except
+- Added "pricesdb" command, which is identical to "prices" except that
-  that it uses the same format as Ledger's usual price history
+  it uses the same format as Ledger's usual price history database.
-  database.
 
-- Added "output FILE" command, which reproduces the input journal FILE
+- Added "output FILE" command, which attempts to reproduce the input
-  exactly, though all of the entry composing it are regenerated.
+  journal FILE exactly.  Meant for future GUI usage.  This command
-  Meant for future GUI usage.  This command relies on
+  relies on --write-hdr-format and --write-xact-format, instead of
-  --write-hdr-format and --write-xact-format, instead of
   --print-format.
 
-- Added "--reconcile BALANCE" option, which attempts to reconcile the
+- Added "--reconcile BALANCE" option, which attempts to reconcile all
-  transactions that would have been displayed to the given BALANCE,
+  matching transactions to the given BALANCE, outputting those that
-  outputting those that would need to be "cleared" to match it.  Using
+  would need to be "cleared" to match it.  Using by the
-  by the auto-reconciling feature of ledger.el (see below).
+  auto-reconciling feature of ledger.el (see below).
 
-  "--reconcile-date DATE" will ignore any uncleared transactions after
+  "--reconcile-date DATE" ignores any uncleared transactions after
-  DATE in the reconciling algorithm.  Since it is O(n^2) (where 'n' is
+  DATE in the reconciling algorithm.  Since the algorithm is O(n^2)
-  the number of uncleared transactions to consider), this could have a
+  (where 'n' is the number of uncleared transactions to consider),
-  substantial impact.
+  this could have a substantial impact.
 
-- In ledger.el's *Reconcile* mode (C-c C-r from a ledger-mode file):
+- In ledger.el's *Reconcile* mode ('C-c C-r' from a ledger-mode file):
-  . 'a' will add a missing transaction
+  . 'a' adds a missing transaction
-  . 'd' will delete the current transaction
+  . 'd' deletes the current transaction
-  . 'r' will attempt to auto-reconcile (same as C-u C-c C-r)
+  . 'r' attempts to auto-reconcile (same as 'C-u C-c C-r')
-  . 's' or C-x C-s will save the ledger data file and show the
+  . 's' or 'C-x C-s' will save the ledger data file and show the
     currently cleared balance
-  This feature now works on all version of Emacs.
+  . 'C-c C-c' commits the pending transactions, marking them cleared.
+  This feature now works with Emacs 21.3.
   Also, the reconciler no longer needs to ask "how far back" to go.
 
-- There are a new set of value expression regexp commands:
+- To support the reconciler, textual entries may now have a "!" flag
+  (pending) after the date, instead of a "*" flag (cleared).
 
+- There are a new set of value expression regexp commands:
     c//  entry code
     p//  payee
     w//  short account name
     W//  full account name
     e//  transaction note
 
-  These make it possible to display transactions whose comment field
+  This makes it possible to display transactions whose comment field
-  matching a particular text string:
+  matches a particular text string.  For example:
 
     ledger -l e/{tax}/ reg
 
-  Will print out all transactions with the comment "{tax}", which the
+  prints out all the transactions with the comment "{tax}", which
-  user might use to identify those relating to his tax report.
+  might be used to identify items related to a tax report.
 
 * 2.1