diff --git a/NEWS b/NEWS
index b4d11e64..ae8cf73b 100644
--- a/NEWS
+++ b/NEWS
@@ -6,6 +6,7 @@ What's new in psycopg 2.7
 
 New features:
 
+- Added `~psycopg2.sql` module to generate SQL dynamically (:ticket:`#308`).
 - Added :ref:`replication-support` (:ticket:`#322`). Main authors are
   Oleksandr Shulgin and Craig Ringer, who deserve a huge thank you.
 - Added `~psycopg2.extensions.parse_dsn()` and
diff --git a/lib/sql.py b/lib/sql.py
index b465cbee..fc946b5d 100644
--- a/lib/sql.py
+++ b/lib/sql.py
@@ -72,9 +72,9 @@ class Composed(Composable):
     """
     A `Composable` object obtained concatenating a sequence of `Composable`.
 
-    The object is usually created using `compose()` and the `Composable`
-    operators. However it is possible to create a `!Composed` directly
-    specifying a sequence of `Composable` as arguments.
+    The object is usually created using `Composable` operators. However it is
+    possible to create a `!Composed` directly specifying a sequence of
+    `Composable` as arguments.
 
     Example::
 
@@ -230,7 +230,7 @@ class Identifier(Composable):
 
 class Literal(Composable):
     """
-    Represent an SQL value to be included in a query.
+    A `Composable` representing an SQL value to include in a query.
 
     Usually you will want to include placeholders in the query and pass values
     as `~cursor.execute()` arguments. If however you really really need to