tweeper.1.asciidoc: document how to use the PHP built-in web server
authorAntonio Ospite <ao2@ao2.it>
Sun, 13 Sep 2015 09:57:07 +0000 (11:57 +0200)
committerAntonio Ospite <ao2@ao2.it>
Sun, 13 Sep 2015 11:01:29 +0000 (13:01 +0200)
tweeper.1.asciidoc

index 56beabd..c9af25f 100644 (file)
@@ -37,7 +37,7 @@ tweeper can be used as:
 
 1. a command line tool;
 2. a filter for feed readers;
 
 1. a command line tool;
 2. a filter for feed readers;
-3. a web based tool when PHP support is available in the web server.
+3. a web based tool when used with a PHP-enabled web server.
 
 
 OPTIONS
 
 
 OPTIONS
@@ -61,10 +61,22 @@ Using tweeper as a filter for the Liferea feed reader:
 
  liferea-add-feed  "|tweeper http://twitter.com/NSAcareers"
 
 
  liferea-add-feed  "|tweeper http://twitter.com/NSAcareers"
 
-Using tweeper via web (the symlink must be created only the very first time):
+To use tweeper via web there are two options (the examples assume the
+installation directory to be `/usr/share/php/tweeper/`):
+
+1. Using the PHP built-in web server:
+
+  php -S localhost:8000 -t /usr/share/php/tweeper/
++
+and then visit 'http://localhost:8000/tweeper.php' in the web browser.
+
+2. Using a generic web server with the document root in '/var/www':
 
   sudo ln -s /usr/share/php/tweeper/tweeper.php /var/www
   xdg-open http://localhost/tweeper.php?src_url=http://twitter.com/NSAcareers
 
   sudo ln -s /usr/share/php/tweeper/tweeper.php /var/www
   xdg-open http://localhost/tweeper.php?src_url=http://twitter.com/NSAcareers
++
+It is enough to create the symlink only the very first time tweeper is used
+this way.
 
 
 NOTES
 
 
 NOTES