diff --git a/README b/README
index cb92a07..35f81e1 100644
--- a/README
+++ b/README
@@ -1,6 +1,18 @@
-pyelftools
-----------
+Introduction: what is pyelftools?
+---------------------------------
 
-Nice project, heh?
+**pyelftools** is a pure-Python library for parsing and analyzing ELF files
+and DWARF debugging information.
+
+Pre-requisites
+--------------
+
+**pyelftools** needs only Python to run. It works with Python versions 2.6 and
+2.7 (Python 3 support is planned but not yet implemented). For hacking on 
+**pyelftools** the requirements are a bit more strict, please see the
+user's guide (ZZZ: link?)
+
+
+
 
 
diff --git a/elftools/dwarf/die.py b/elftools/dwarf/die.py
index 82d65e9..fe4537b 100644
--- a/elftools/dwarf/die.py
+++ b/elftools/dwarf/die.py
@@ -159,10 +159,6 @@
                 self.abbrev_code)
         self.tag = abbrev_decl['tag']
         self.has_children = abbrev_decl.has_children()
-        
-        # The offset of the .debug_info section in the stream. Used to compute
-        # relative offset of attribute values to the beginning of the section.
-        section_offset = self.dwarfinfo.debug_info_sec.global_offset
 
         # Guided by the attributes listed in the abbreviation declaration, parse
         # values from the stream.
diff --git a/elftools/dwarf/dwarfinfo.py b/elftools/dwarf/dwarfinfo.py
index bc80224..ff99f17 100644
--- a/elftools/dwarf/dwarfinfo.py
+++ b/elftools/dwarf/dwarfinfo.py
@@ -25,6 +25,9 @@
 # global_offset: the global offset of the section in its container file
 # size: the size of the section's data, in bytes
 #
+# 'name' and 'global_offset' are for descriptional purposes only and
+# aren't strictly required for the DWARF parsing to work.
+#
 DebugSectionDescriptor = namedtuple('DebugSectionDescriptor', 
     'stream name global_offset size')