README.txt in youtube-g-0.4.0 vs README.txt in youtube-g-0.4.1

@@ -1,36 +1,50 @@
 youtube-g
     by Shane Vitarana and Walter Korman
     http://rubyforge.org/projects/youtube-g/
 
 == DESCRIPTION:
-  
-youtube-g is a pure Ruby client for the YouTube GData API.
 
+youtube-g is a pure Ruby client for the YouTube GData API. It provides an easy
+way to access the latest YouTube video search results from your own programs.
+In comparison with the earlier Youtube search interfaces, this new API and
+library offers much-improved flexibility around executing complex search
+queries to obtain well-targeted video search results.
+
+More detail on the underlying source Google-provided API is available at:
+
+http://code.google.com/apis/youtube/overview.html
+
 == FEATURES/PROBLEMS:
   
-* Aims to be in parity with Google's YouTube GData API (it is currently not complete)
+* Aims to be in parity with Google's YouTube GData API.  Core functionality
+  is currently present -- work is in progress to fill in the rest.
 
 == SYNOPSIS:
 
-	Basic queries:
+Create a client:
+  
+  require 'rubygems'
+  require 'youtube_g'
+  client = YouTubeG::Client.new
+  
+Basic queries:
+
+  client.videos_by(:query => "penguin")
+  client.videos_by(:tags => ['tiger', 'leopard'])
+  client.videos_by(:categories => [:news, :sports])
+  client.videos_by(:categories => [:news, :sports], :tags => ['soccer', 'football'])
+  client.videos_by(:user => 'liz')
 	
-	@client = YouTubeG::Client.new
-	@client.videos_by(:query => "penguin")
-	@client.videos_by(:tags => ['tiger', 'leopard'])
-	@client.videos_by(:categories => [:news, :sports])
-	@client.videos_by(:categories => [:news, :sports], :tags => ['soccer', 'football'])
-	@client.videos_by(:user => 'liz')
+Standard feeds:
 	
-	Standard feeds:
+  client.videos_by(:most_viewed)
+  client.videos_by(:top_rated, :time => :today)
 	
-	@client.videos_by(:most_viewed)
-	@client.videos_by(:top_rated, :time => :today)
+Advanced queries (with boolean operators OR (either), AND (include), NOT (exclude)):
 	
-	Advanced queries (with boolean operators OR (either), AND (include), NOT (exclude)):
-	
-	@client.videos_by(:categories => { :either => [:news, :sports], :exclude => [:comedy] }, :tags => { :include => ['football'], :exclude => ['soccer'] })
+  client.videos_by(:categories => { :either => [:news, :sports], :exclude => [:comedy] }, :tags => { :include => ['football'], :exclude => ['soccer'] })
 
 
 == REQUIREMENTS:
 
 * None
@@ -41,11 +55,10 @@
 
 == LICENSE:
 
 MIT License
 
-Copyright (c) 2007 Shane Vitarana
-Copyright (c) 2007 Walter Korman
+Copyright (c) 2007 Shane Vitarana and Walter Korman
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the
 'Software'), to deal in the Software without restriction, including
 without limitation the rights to use, copy, modify, merge, publish,