update gemspec/readme

Author: chrahunt

README.md

@@ -1,6 +1,6 @@
 # docx
 
-a ruby library/gem for interacting with `.docx` files
+a ruby library/gem for interacting with `.docx` files. currently capabilities include reading paragraphs/bookmarks, inserting text at bookmarks, and saving the document.
 
 ## usage
 
@@ -10,15 +10,33 @@ requires ruby (only tested with 1.9.3 so far)
 
     gem install docx
 
-### basic
+### reading
 
 ``` ruby
 require 'docx'
 
 d = Docx::Document.open('example.docx')
-d.each_paragraph do |p|
+# Array of paragraphs
+d.paragraphs.each do |p|
   puts d
 end
+
+# Hash of Bookmarks. Bookmark names as keys correspond to bookmark objects.
+d.bookmarks.each_pair do |bookmark_name, bookmark_object|
+  puts bookmark_name
+end
+```
+
+### writing
+
+``` ruby
+require 'docx'
+
+d = Docx::Document.open('example.docx')
+# Insert a single line after a bookmark
+d.bookmarks['example_bookmark'].insert_after("Hello world.")
+# Each value in array is put on a separate line
+d.bookmarks['example_bookmark'].insert_multiple_lines_after(['Hello', 'World', 'foo'])
 ```
 
 ### advanced
@@ -27,15 +45,16 @@ end
 require 'docx'
 
 d = Docx::Document.open('example.docx')
-d.each_paragraph do |p|
-  p.each_text_run do |run|
-    run.italicized?
-    run.bolded?
-    run.underlined?
-    run.formatting
-    run.text
-  end
+
+# The Nokogiri node on which an element is based can be accessed using #node
+d.paragraphs.each do |p|
+  puts p.node.inspect
 end
+
+# The #xpath and #at_xpath are delegated to the node from the element, saving a step
+p_element = d.paragraphs.first
+p_children = p_element.xpath("//child::*") # selects all children
+p_child = p_element.at_xpath("//child::*") # selects first child
 ```
 
 ## Development

docx.gemspec

@@ -6,9 +6,9 @@ Gem::Specification.new do |s|
   s.version     = Docx::VERSION
   s.summary     = 'a ruby library/gem for interacting with .docx files'
   s.description = s.summary
-  s.author      = 'Marcus Ortiz'
-  s.email       = 'mportiz08@gmail.com'
-  s.homepage    = 'https://github.com/mportiz08/docx'
+  s.authors     = ['Christopher Hunt', 'Marcus Ortiz']
+  s.email       = ['chrahunt@gmail.com']
+  s.homepage    = 'https://github.com/chrahunt/docx'
   s.files       = Dir["README.md", "LICENSE.md", "lib/**/*.rb"]
 
   s.add_dependency 'nokogiri', '~> 1.5'