Added example configuration file.
authorRafał Długołęcki <kontakt@dlugolecki.net.pl>
Sun, 6 Jan 2013 00:36:25 +0000 (01:36 +0100)
committerRafał Długołęcki <kontakt@dlugolecki.net.pl>
Sun, 6 Jan 2013 00:36:25 +0000 (01:36 +0100)
Added Readme file with script description and installation.

README [new file with mode: 0644]
smsrc [new file with mode: 0644]

diff --git a/README b/README
new file mode 100644 (file)
index 0000000..f0b1ad1
--- /dev/null
+++ b/README
@@ -0,0 +1,52 @@
+Synopsis
+--------
+sms.pl MOBILE_NO "TEXT_MESSAGE"
+
+Description
+-----------
+sms.pl allows sending smses using your Orange.pl account.
+Orange.pl gives every registered user 30 free smses a month. Why don't simplify 
+and automate it a little?
+
+Dependencies
+------------
+Make sure you have perl installed on your system. As I know, every Linux distribution
+have it installed, by default. Invoke following command in terminal. If you don't
+have or can't install cpan on your system, you will have to install these dependencies
+manually.
+
+    cpan -i WWW::Mechanize Mojo::DOM Config::General Data::Dumper
+
+Installation
+------------
+Give permissions to execute file as a program:
+    chmod u+x sms.pl
+
+You can also copy file to e.g: ~/bin directory, so you can call it without
+entering full path to the script. Personally, I'm using symlink for that like this:
+
+    ln -s /path/to/script ~/bin/sms
+
+so I invoke it without .pl extension.
+
+Configuration
+-------------
+Create file with your Orange.pl credentials in HOME directory:
+
+    touch .smsrc
+
+Fill it like this:
+
+    login    = LOGIN
+    password = PASSWORD
+
+Author
+------
+Rafał Długołęcki <kontakt@dlugolecki.net.pl>
+
+Copyright and License
+---------------------
+Copyright 2012, 2013 Rafał Długołęcki
+
+This program is free software; you may redistribute it and/or modify it under the same terms as Perl itself.
+
diff --git a/smsrc b/smsrc
new file mode 100644 (file)
index 0000000..4208178
--- /dev/null
+++ b/smsrc
@@ -0,0 +1,2 @@
+login    = LOGIN
+password = PASSWORD