tweeper.1.asciidoc: document how to use the PHP built-in web server

[tweeper.git] / README

diff --git a/README b/README
index 0ebe37c..7703e64 100644 (file)
--- a/README
+++ b/README
@@ -1,10 +1,12 @@
-Tweeper is a web scraper which extracts the most recent public tweets of
-a given user from their home page on Twitter.com and formats them in RSS, so
-the information can be conveniently accessed and collected by a feed reader.
+Tweeper is a web scraper which can be used to conveniently follow the public
+activity of social network users without the need to log in or even be
+subscribed to the social network; tweeper converts the public information to
+RSS so that it can be accessed and collected by a feed reader.

 
 

-Since Jun 11th 2013 Twitter.com retired their API v1.0, so it's not possible
-to access a user timeline via RSS anymore, and it's also become mandatory to
-authenticate via OAuth to access this _public_ information in JSON format:
+Since Jun 11th 2013, when Twitter.com retired their API v1.0, it has not been
+possible anymore to access a user timeline via RSS, and it has also become
+mandatory to authenticate via OAuth to access this _public_ information in the
+JSON format:

 
   https://dev.twitter.com/discussions/16289
   https://dev.twitter.com/discussions/11564
 
   https://dev.twitter.com/discussions/16289
   https://dev.twitter.com/discussions/11564


@@ -24,14 +26,23 @@ whom you are friend to.
 
 [1] http://www.urbandictionary.com/define.php?term=TWEEPER&defid=3743173
 
 
 [1] http://www.urbandictionary.com/define.php?term=TWEEPER&defid=3743173
 

-Tweeper can be used via web or as a command line program, for example as
-a filter in your feed reader, by passing the URL of the user's public timeline
-as the first argument.
-

 Tweeper can easily scrape sites other than Twitter, it is just a matter of
 writing an xsl stylesheet for the transformation; an example for pump.io
 activity stream is provided in rss_converter_pump.io.xsl
 
 Tweeper can easily scrape sites other than Twitter, it is just a matter of
 writing an xsl stylesheet for the transformation; an example for pump.io
 activity stream is provided in rss_converter_pump.io.xsl
 

+The currently supported sites are:
+
+  * Twitter.com
+  * Pump.io based websites, like Identi.ca
+  * Dilbert.com
+  * Howtoons.com
+  * Instagram.com
+  * Facebook.com (public pages)
+
+Tweeper can be used via web or as a command line program, for example as
+a filter in your feed reader, by passing the URL of the user's public timeline
+as the first argument.
+

 Example of use on the command line:
 
   $ php tweeper.php http://twitter.com/NSACareers
 Example of use on the command line:
 
   $ php tweeper.php http://twitter.com/NSACareers