Support for detailed input locations.

* gint: Upgrade.
* grecs: Upgrade.
* NEWS: Document changes.
* src/cfpeek.c (_print_diag): Fix prototype.
* src/guile.c (grecs-node-ident-locus)
(grecs-node-value-locus): New functions.
(grecs-node-locus): Take optional second argument.  It it is #t,
return full location.
* tests/locus.at: Update.

1 files changed, 31 insertions, 0 deletions

diff --git a/NEWS b/NEWS
index c6d5be9..b052882 100644
--- a/NEWS
+++ b/NEWS
@@ -11,6 +11,37 @@ Version 1.0.90 (Git)
 
 * New format flags: down=N, child=S, sibling=S
 
+* New guile primitives:
+
+- (grecs-node-ident-locus node [full])
+
+Returns the location of the node's ident.  See below for the meaning
+of [full].
+
+- (grecs-node-value-locus node [full])
+
+Returns the location of the node's value.
+
+* Full vs. simplified locations.
+
+There are two flavors of source locations: simplified and full ones.  A
+simplified location consists of a file name and line number.  When returned
+from a Guile primitive, they are packed in a cons.  A simplified location
+shows an approximate location of the object in the configuration file.
+
+A full location provides an exact location of the object.  It consists of
+a pair of triplets, which mark the beginning and end of the object.  Each
+triplet consists of a file name, line number and column number.  When 
+returned from a Guile primitive, each triplet is represented as a list of 
+three elements and both triplets are packed in a cons, the start location 
+being its car, and the end location being its cdr.
+
+The three functions that return node locations, grecs-node-locus,
+grecs-node-ident-locus and grecs-node-value-locus, return simplified
+locations by default.  If the optional second argument is supplied and
+is #t, these functions return full locations.
+
+
 
 Version 1.0, 2011-05-27