=================================================================================
                        Web News Reader
=================================================================================

* This is a small project which attempts to deal with the author's frustration
  having to check if a million websites have changed, and that too every day.
  Please note that UNLIKE similar services found elsewhere, this program can
  track **any** website, not necessarily only news sites or RSS Feeds. The
  fact that this program uses **only** the HTTP-Header info means that any site
  running HTTP can be tracked for updates (which is basically **any** site you
  can find on the internet). However currently support for HTTPS is lacking;
  thus you will be unable to access secure or private content pages, such as,
  say, your email box. However, you can use it to see if, for example, this
  page has changed since you last saw it!
  
* I *really* need help to improve this project. Please join if you can. Contact
  me via http://sourceforge.net/sendmessage.php?touser=2955941. You will need a
  sourceforge account (membership is free, join if you haven't yet)

* It is currently in a **beta** state.

* **WARNING for SVN Users:** This project's SVN repository was reset recently.
  Please do **NOT** re-use your old checkouts

* The command line version 0.60-rc3 is recommended for all those who want to use
  the program. However people who want to see the future of this project can
  checkout the svn version by typing this out: (Please note that for this
  version you need PyQt as well)
  
  **svn co https://webnewsreader.svn.sourceforge.net/svnroot/webnewsreader/trunk webnewsreader**

* Usage (command-line version):

  * Download the latest version of Python **2.6** for your operating system from
    here_. (Do **NOT** try to run the source on Python 3.x.x or Python 2.5.x)

  * Download the file wnr.py

  * Open a Command Prompt

  * Change Directory to the directory where you have kept wnr.py

  * Run the program like so:
      **wnr.py** on Windows

              or

      **./wnr.py** on UNIX-like OSes
      (Linux,BSD,etc) **Users of UNIX-like OSes: make SURE you have given the
      "execute" file permission by executing chmod +x ./wnr.py BEFORE
      you try to run the program**

  * Follow the instructions. Run **wnr.py -h** or **wnr.py --help** for more info

-------------------------------------------------------------------------------------------------------------------------------------------

* WebNewsReader is |python_powered|

* WebNewsReader was |crafted_with_jedit|

* The change log updated 3 July 2010 is_here_

* This documentation was generated using DocUtils_. The ReST sources are_here_

* This project is hosted on |sflogo|
   ( Project_Page_ )

.. |python_powered| image:: http://www.python.org/community/logos/python-powered-w-140x56.png
   :target: http://python.org
   :alt: Python powered

.. |crafted_with_jedit| image:: http://www.jedit.org/made-with-jedit-9.png
   :target: http://jedit.org
   :alt: crafted with jEdit
   
.. _here : http://python.org
.. _is_here : http://webnewsreader.sourceforge.net/Changelog.html
.. _are_here : http://webnewsreader.sourceforge.net/index.ReST.txt
.. _DocUtils : http://docutils.sourceforge.net

.. |sflogo| image:: http://sflogo.sourceforge.net/sflogo.php?group_id=330700&type=11 
   :target: http://sourceforge.net
   :alt: Sourcefoge logo
   
.. _Project_Page: http://sourceforge.net/projects/webnewsreader