Add a man page

[tweeper.git] / tweeper.1.asciidoc

diff --git a/tweeper.1.asciidoc b/tweeper.1.asciidoc
new file mode 100644 (file)
index 0000000..0ffb3b6
--- /dev/null
+++ b/tweeper.1.asciidoc
@@ -0,0 +1,87 @@
+TWEEPER(1)
+===========
+:doctype: manpage
+
+
+NAME
+----
+tweeper - web scraper to convert a Twitter timeline to an RSS feed
+
+
+SYNOPSIS
+--------
+*tweeper* ['OPTIONS'] 'URL'
+
+
+DESCRIPTION
+-----------
+
+tweeper(1) 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 started as the TWitter FEEd scraPER but support for other web sites
+has been added.
+
+The sites that tweeper is able to scrape and convert to RSS are:
+  
+* Twitter.com
+* Pump.io based websites, like Identi.ca
+* Dilbert.com
+
+tweeper can be used as:
+
+1. a command line tool;
+2. as a filter for feed readers
+3. as a web based tool when PHP support is available in the web server.
+
+
+OPTIONS
+-------
+
+*-e*::
+    show links to supported media files in the RSS <enclosure/> element
+
+*-h, --help*::
+    show the help message
+
+
+EXAMPLE OF USE
+--------------
+
+Getting the RSS feed of some Twitter user:
+
+ tweeper http://twitter.com/NSACareers
+
+Using tweeper as a filter for the Liferea feed reader:
+
+ liferea-add-feed  "|tweeper http://twitter.com/NSAcareers"
+
+
+EXIT STATUS
+-----------
+*0*::
+    Success
+
+*!0*::
+    Failure
+
+
+AUTHORS
+-------
+Antonio Ospite
+
+
+RESOURCES
+---------
+Main web site: <http://git.ao2.it/tweeper.git>
+
+
+COPYING
+-------
+Copyright \(C) 2013  Antonio Ospite <ospite@studenti.unina.it>
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.