README

NOTICE
======

This package is now deprecated. It is kept here for documentation purposes, but
no changes will be made.

THE AUTHOR PROVIDES THIS SOFTWARE ''AS IS'' AND ANY EXPRESSED OR
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

COPYRIGHT NOTICE
================
All rights reserved (c) 2011-2012 Ivan Perez Dominguez (Keera Studios)
Read the file LICENCE for more information.

'diamondcard.us' is a product offered of Dreamtime.net. Keera Studios Ltd makes
no claims of ownership, relation, partnership, support, engagement, suitability
and/or sponsorship from/by/of Dreamtime.net.


SUMMARY
=======

Welcome to Keera's DiamondCard sms sending app

This application creates a status icon in your traybar and, when you
click on it, it shows a window in which you can fill in the SMS data to
send an SMS using the DiamondCard voip provider.

Read this file and take a look at the github wiki:
https://github.com/ivanperez-keera/keera-diamondcard-sms-trayicon/wiki

*** Two VERY IMPORTANT things ***

 - There's no syntax checking, for now. What you type is what you
send. Diamondcard doesn't handle accents very well (it increases the
amount of SMSs to send by several orders of magnitude). The format for
phone numbers is: INTERNATIONAL PREFIX followed by NUMBER. For
instance, to send an SMS to UK, you'd write 447425000000 if 7425000000
is your phone number in UK. Don't write +, 00 or any other strange
prefix or it won't work.

 - You need to fill in your diamondcard data in the preferences
dialog. This will be saved, IN PLAIN TEXT, in your home directory.
Right click on the icon and select preferences. Log into your
diamondcard account on your browser if you don't know what those
are. Again, set your phone number in <INTERNATIONAL CODE><PHONE
NUMBER> format. No hypens, no plus signs, no 00 prefix.

You have been warned. Do not complain if it doesn't work as expected
or if it sets your house on fire. This is work in progress.

*** COMPILATION ***

Dependencies:
* gtk-helpers (http://github.com/keera-studios/gtk-helpers)
* hails-reactivevalues (http://github.com/keera-studios/hails-reactivevalues)
* hails-reactive-gtk (http://github.com/keera-studios/hails-reactive-gtk)
* hails-mvc-model-protectedmodels (http://github.com/keera-studios/hails-mvc-model-protectedmodels)
* hails-mvc-view (http://github.com/keera-studios/hails-mvc-view)
* hails-mvc-view-gtk (http://github.com/keera-studios/hails-mvc-view-gtk)
* hails-mvc-solutions-config (http://github.com/keera-studios/hails-mvc-solutions-config)
* hails-mvc-environment-gtk (http://github.com/keera-studios/hails-mvc-environment-gtk)
* keera-network-sms-diamondcard (http://github.com/ivanperez-keera/keera-network-sms-diamondcard)

Do not despair. If you have access to a bash shell, just copy this readme file
to a temporary directory. The following code *SHOULD* install all the dependencies.

Note: use with care. If something doesn't work, please let me know so that I can fix it ASAP.

for i in $(grep -oe 'http://github.com/[^)]\+' README); do \
  wget $i/tarball/master -O $(basename $i).tar.gz ; \
  tar -zxvpf $(basename $i).tar.gz ; \
  cd $(basename $(dirname $i))-$(basename $i)-* ; \
  cabal install ; \
  cd .. ; \
done

Other dependencies will be installed automatically by cabal.

To install this program, just download the code, extract,
cd into the directory where the files have been extracted
and run: cabal install

You'll have to do the same for each of the dependencies first.

Once installed the executable will be named keera-diamondcard-sms-trayicon, and
it will create config files in ~/.diamondcard-sms