PHP_SCRIPT_DIR ?= $(prefix)/share/php
BIN_DIR := $(prefix)/bin
+MAN_DIR := $(prefix)/share/man
TWEEPER_DIR := $(PHP_SCRIPT_DIR)/tweeper
all:
+
clean:
+ rm -f tweeper.1
+
+docs:
+ a2x -f manpage tweeper.1.asciidoc
+
+installdocs: docs
+ install -d $(DESTDIR)$(MAN_DIR)/man1
+ install -m644 tweeper.1 $(DESTDIR)$(MAN_DIR)/man1
-install:
+install: installdocs
install -d $(DESTDIR)$(TWEEPER_DIR)
install -m644 *.xsl $(DESTDIR)$(TWEEPER_DIR)
install -m644 *.php $(DESTDIR)$(TWEEPER_DIR)
--- /dev/null
+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.