README

This is the first part of the coursework for INFO6005 module, University of Southampton.

It is a simple PHP rss reader. User can execute the applications both:
    -via command line.
    -as a web app via a web browser.

INSTALL:

In order to install the application you can use the Software Center applications which is provided by all linux deistributions
or you can do it via command line

Examples (instalation via command line)

    -dkpg -i cw1-6005-pp6g11_1.0-1_all.deb (dependencies will not be installed)
    -sudo dpkg -i --force-depends cw1-6005-pp6g11_1.0-1_all.deb (dependencies will be installed)

EXECUTION:
As mentioned earlier, you can execute the application either via command line or via a web browser.

Examples

    -via command line:
        Type pp6g11 in command line. The script will show the rss feed from the bbc web site. You have the choice to add
        your own URLs. In essence, the following options are available:
        --feeds feed1, feed2, feed3
            list of URLs
        --items n
            number of items to read
    -via browser:
        The application has got a launcher, which you can find under the "Internet Apps" section in any linux distribution.
        You will see an icon named "cw1-6005-pp6g11". The launcer will open a browser and run the application. You don't have
        to make any configurations in order to run the applicatations. The package comes with a postinst script which makes
        the configurations is needed by the apache http server in order to run a web app.

MANUAL:
You can view the manual that comes with the package by typing:
    man pp6g11

DEPENDENCIES:
    -apache2
    -php5
    -libapache2-mod-php5
    -firefox
    -debconf

Further documentation is available within the package.

All the files are located in the /usr/share/cw1-6005-pp6g11/ directory.

Licence

    Copyright (C) 2012 Pavlos Polianidis

    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.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.