* boot-9.scm (ipow-by-squaring): Removed.

[bpt/guile.git] / NEWS

diff --git a/NEWS b/NEWS
index 0d1bd79..bac814d 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -63,23 +63,32 @@ debugging evaluator gives better error messages.
 
 ** Checking for duplicate bindings in module system
 
 
 ** Checking for duplicate bindings in module system
 

-The module system now checks for duplicate imported bindings.
+The module system now can check for name conflicts among imported
+bindings.

 
 The behavior can be controlled by specifying one or more duplicates
 
 The behavior can be controlled by specifying one or more duplicates

-handlers.  For example, to get back the old behavior (which was to use
-the last imported binding of a certain name), write:
+handlers.  For example, to make Guile return an error for every name
+collision, write:

 
 (define-module (foo)
   :use-module (bar)
   :use-module (baz)
 
 (define-module (foo)
   :use-module (bar)
   :use-module (baz)

-  :duplicates last)
+  :duplicates check)

 
 

-If you want the old behavior without changing your module headers, put
-the line:
+The new default behavior of the module system when a name collision
+has been detected is to

 
 

-  (default-module-duplicates-handler 'last)
+ 1. Give priority to bindings marked as a replacement.
+ 2. Issue a warning.
+ 3. Give priority to the last encountered binding (this corresponds to
+     the old behavior).

 
 

-in your .guile init file.
+If you want the old behavior back without replacements or warnings you
+can add the line:
+
+  (default-duplicate-binding-handler 'last)
+
+to your .guile init file.

 
 The syntax for the :duplicates option is:
 
 
 The syntax for the :duplicates option is:
 


@@ -95,14 +104,24 @@ Currently available duplicates handlers are:
   warn              issue a warning for bindings with a common name
   replace           replace bindings which have an imported replacement
   warn-override-core issue a warning for imports which override core bindings
   warn              issue a warning for bindings with a common name
   replace           replace bindings which have an imported replacement
   warn-override-core issue a warning for imports which override core bindings

+                    and accept the override

   first                     select the first encountered binding (override)
   last              select the last encountered binding (override)
   first                     select the first encountered binding (override)
   last              select the last encountered binding (override)

+
+These two are provided by the (oop goops) module:
+  

   merge-generics     merge generic functions with a common name
                     into an <extended-generic>
   merge-generics     merge generic functions with a common name
                     into an <extended-generic>

+  merge-accessors    merge accessors with a common name

 
 The default duplicates handler is:
 
 
 The default duplicates handler is:
 

-  (replace warn-override-core check)
+  (replace warn last)
+
+A recommended handler (which is likely to correspond to future Guile
+behavior) can be installed with:
+
+  (default-duplicate-binding-handler '(replace warn-override-core check))

 
 ** New define-module option: :replace
 
 
 ** New define-module option: :replace
 


@@ -112,6 +131,17 @@ replacement.
 A typical example is `format' in (ice-9 format) which is a replacement
 for the core binding `format'.
 
 A typical example is `format' in (ice-9 format) which is a replacement
 for the core binding `format'.
 

+** Adding prefixes to imported bindings in the module system
+
+There is now a new :use-module option :prefix.  It can be used to add
+a prefix to all imported bindings.
+
+  (define-module (foo)
+    :use-module ((bar) :prefix bar:))
+
+will import all bindings exported from bar, but rename them by adding
+the prefix `bar:'.
+

 ** Merging generic functions
 
 It is sometimes tempting to use GOOPS accessors with short names.
 ** Merging generic functions
 
 It is sometimes tempting to use GOOPS accessors with short names.