README.rdoc in public_suffix_service-0.7.0 vs README.rdoc in public_suffix_service-0.8.0

@@ -48,11 +48,11 @@
   $ gem install public_suffix_service
 
 You might need administrator privileges on your system to install the Gem.
 
 
-== Usage
+== Basic Usage
 
 Example domain without subdomains.
 
   domain = PublicSuffixService.parse("google.com")
   # => #<PublicSuffixService::Domain>
@@ -90,9 +90,25 @@
   PublicSuffixService.valid?("www.google.com")
   # => true
 
   PublicSuffixService.valid?("x.yz")
   # => false
+
+== Fully Qualified Domain Names
+
+This library automatically recognizes Fully Qualified Domain Names. A FQDN is a domain name that end with a trailing dot.
+
+  # Parse a standard domain name
+  domain = PublicSuffixService.parse("www.google.com")
+  # => #<PublicSuffixService::Domain>
+  domain.tld
+  # => "com"
+
+  # Parse a fully qualified domain name
+  domain = PublicSuffixService.parse("www.google.com.")
+  # => #<PublicSuffixService::Domain>
+  domain.tld
+  # => "com"
 
 
 == Credits
 
 Author:: {Simone Carletti}[http://www.simonecarletti.com/] <[e-mail]>