Readme update

README.rst

@@ -2,10 +2,9 @@ pyGTKtalog
 ==========
 
 Pygtktalog is Linux/FreeBSD program for indexing CD, DVD, BR or directories on
-filesystem. It is similar to `gtktalog <http://www.nongnu.org/gtktalog/>`_ or
+filesystem. It is similar to `gtktalog`_ or `gwhere`_. There is no coincidence
-`gwhere <http://www.gwhere.org/home.php3>`_. There is no coincidence in name of
+in name of application, because it's meant to be replacement (in some way) for
-application, because it's meant to be replacement (in some way) for gtktalog,
+gtktalog, which seems to be dead project for years.
-which seems to be dead project for years.
 
 Current version is 2.0.
 
@@ -18,28 +17,44 @@ FEATURES
 * Get/generate thumbnails from EXIF and other images
 * Store selected EXIF tags
 * Add/edit description and notes
-* Fetch comments for images made in `gThumb <http://gthumb.sourceforge.net>`_
+* Fetch comments for images made in `gThumb`_
 * Add/remove unlimited images to any file or directory
-* `tagging files <http://en.wikipedia.org/wiki/Tag_%28metadata%29>`_
+* `Tagging files`_
 * And more :)
 
-REQUIREMENTS
+Frontends
+---------
+
+New version of pyGTKtalog was meant to use multiple interfaces.
+
+#. First for the new incarnation of pyGTKtalog is… command line tool for
+   accessing catalog dbs. With ``cmdcatalog.py`` it's possible to:
+
+   * create new catalog
+   * update it
+   * list
+   * find files
+
+#. ``gtktalog.py``. This is written from scratch frontend in pygtk. Still work
+   in progress.
+
+Requirements
 ------------
 
 pyGTKtalog requires python and following libraries:
 
-* `python 2.7 <http://www.python.org/>`_
+* `python 2.7`_
-* `pygtk 2.24 <http://www.pygtk.org>`_
+* `sqlalchemy 1.0`_
-* `sqlalchemy 0.6 <http://www.sqlalchemy.org>`_
+* `pygtk 2.24`_ (only for ``gtktalog.py``)
 
 It may work on other (lower) version of libraries, and it should work with
-higher versions of libraries, although it will not work on Python 3 yet.
+higher versions of libraries, although it will not work on Python 3 yet, nor
+GTK3.
 
 Optional modules
 ^^^^^^^^^^^^^^^^
 
-* `PIL <http://www.pythonware.com/products/pil/index.htm>`_ for image
+* `PIL`_ for image manipulation
-  manipulation
 
 Additional pyGTKtalog uses `EXIF`_ module by Gene Cash (slightly updated to EXIF
 2.2 by me) which is included in sources.
@@ -55,11 +70,12 @@ Programs that are used:
 
 For development process following programs are used:
 
-* `gettext <http://www.gnu.org/software/gettext/gettext.html>`_
+* `gettext`_
-* `intltool <http://www.gnome.org/>`_
+* `intltool`_
-* `nose <http://code.google.com/p/python-nose/>`_
+* `nose`_
-* `coverage <http://nedbatchelder.com/code/coverage/>`_
+* `coverage`_
-* `paver <http://code.google.com/p/paver/>`__
+* `paver`_
+* `tox`_
 
 INSTALATION
 -----------
@@ -78,7 +94,7 @@ you have to do is:
 #. copy pyGTKtalog shell script to /usr/bin, /usr/local/bin or in
    other place, where PATH variable is pointing or you feel like.
 
-#. then modify pyGTKtalog line 6 to match right pygtktalog.py directory
+#. then modify pyGTKtalog line 6 to match right ``pygtktalog.py`` directory
 
 Then, just run pyGTKtalog script.
 
@@ -89,7 +105,7 @@ Catalog file is plain sqlite database (optionally compressed with bzip2). All
 images are stored in location pointed by db entry in ``config`` table - it is
 assumed, that images directory will be placed within the root directory, where
 the main db lies.
-generated sha512 hash from image file itself. There is small possibility for two
+Generated sha512 hash from image file itself. There is small possibility for two
 identical hash for different image files. However, no images are overwritten.
 Thumbnail filename for each image is simply concatenation of image filename in
 images directory and '_t' string.
@@ -113,13 +129,31 @@ Several tools has been used to develop pyGTKtalog.
 Paver
 ^^^^^
 
-I've choose `Paver <http://www.blueskyonmars.com/projects/paver/>`_ as make
+I've choose `Paver`_ as make equivalent. Inside main project directory there is
-equivalent. Inside main project directory there is pavement.py script, which
+``pavement.py`` script, which provides several tasks, that can be helpful in a work
-provides several tasks, that can be helpful in a work with sources. Paver is
+with sources. Paver is also used to generate standard ``setup.py``.
-also used to generate standard setup.py.
 
 LICENSE
 =======
 
 This work is licensed under the terms of the GNU GPL, version 3. See the LICENCE
 file in top-level directory.
+
+
+.. _coverage: http://nedbatchelder.com/code/coverage/
+.. _exif: https://github.com/ianare/exif-py
+.. _gettext: http://www.gnu.org/software/gettext/gettext.html
+.. _gthumb: http://gthumb.sourceforge.net
+.. _gtktalog: http://www.nongnu.org/gtktalog/
+.. _gwhere: http://www.gwhere.org/home.php3
+.. _imagemagick: http://imagemagick.org/script/index.php
+.. _intltool: http://www.gnome.org/
+.. _mplayer: http://mplayerhq.hu
+.. _nose: http://code.google.com/p/python-nose/
+.. _paver: https://pythonhosted.org/paver/
+.. _pil: http://www.pythonware.com/products/pil/index.htm
+.. _pygtk 2.24: http://www.pygtk.org
+.. _python 2.7: http://www.python.org/
+.. _sqlalchemy 1.0: http://www.sqlalchemy.org
+.. _tagging files: http://en.wikipedia.org/wiki/tag_%28metadata%29
+.. _tox: https://testrun.org/tox