Update README.md

Author: Papakai

README.md

@@ -1,29 +1,36 @@
+# perl-sdk / WebService::Hexonet::Connector
+
+This module is a connector library for the insanely fast HEXONET Backend API. For further informations visit our [homepage](http://hexonet.net) and do not hesitate to [contact us](https://www.hexonet.net/contact).
+
 ## Resources
 
-* [Usage Guide](https://github.com/hexonet/php-sdk/blob/master/README.md#how-to-use-this-module-in-your-project)
-* [SDK Documenation](https://rawgit.com/hexonet/php-sdk/master/build/api/index.html)
+* [Usage Guide](https://github.com/hexonet/perl-sdk/blob/master/README.md#how-to-use-this-module-in-your-project)
+* [SDK Documenation](https://rawgit.com/hexonet/perl-sdk/master/docs/hexonet.html)
 * [HEXONET Backend API Documentation](https://github.com/hexonet/hexonet-api-documentation/tree/master/API)
-* [Release Notes](https://github.com/hexonet/php-sdk/releases)
-* [Development Guide](https://github.com/hexonet/php-sdk/wiki/Development-Guide)
+* [Release Notes](https://github.com/hexonet/perl-sdk/releases)
+* [Development Guide](https://github.com/hexonet/perl-sdk/wiki/Development-Guide)
 
 ## How to use this module in your project
 
-We have also a demo app available showing how to integrate and use our SDK. See [here](https://github.com/hexonet/php-sdk-demo).
+We have also a demo app available showing how to integrate and use our SDK. See [here](https://github.com/hexonet/perl-sdk-demo).
 
 ### Requirements
 
-* Installed php and php-curl
-* Installed [composer](https://getcomposer.org/download/).
+* Installed most current version of perl 5
+* Installed cpanm (App::cpanminus) as suggested alternative for cpan command
 
-### Download from packagist
+### Install from CPAN
 
-This module is available on the [PHP Package Registry](https://packagist.org/packages/hexonet/php-sdk).
+```bash
+# by Module ID (suggested!)
+cpanm WebService::Hexonet::Connector
 
-Run `composer require "hexonet/php-sdk:*"` to get the latest version downloaded and added to composer.json.
-In your script simply use `require 'vendor/autoload.php';` or `require 'vendor/hexonet/php-sdk';`
+# or by filename
+cpanm HEXONET/WebSservice-Hexonet-Connector-1.03.tar.gz
+```
 
-NOTE: The above will also set `"hexont/php-sdk": "*"` as dependency entry in your composer.json. When running `composer install` this would always install the latest release version. This is dangerous for production systems as major version upgrades may come with breaking changes and are then incompatible with your app. For production systems we suggest to use a version dependent syntax, e.g. `composer require "hexonet/php-sdk:v3.0.3"`.
-You can find the versions listed at packagist or at github in the release / tag overview.
+NOTE: I got this only working by sudo'ing these commands.
+In case you install by filename, please check the [release overview](https://github.com/hexonet/perl-sdk/releases) for the most current release and use that version instead.
 
 ### Usage Examples
 
@@ -35,34 +42,50 @@ Not yet available, this needs a review of the SDK.
 
 #### Sessionless API Communication
 
-```php
-require __DIR__ . '/vendor/autoload.php';
-
-// --- SESSIONLESS API COMMUNICATION ---
-$api = \HEXONET\Connection::connect(array(
-    "url" => "https://coreapi.1api.net/api/call.cgi",
-    "login" => "test.user",
-    "password" => "test.passw0rd",
-    "entity" => "1234",
-    //"remoteaddr" => "1.2.3.4" //optional: use this in case of ip filter setting
-));
-
-$r = $api->call(array(
-    "COMMAND" => "StatusAccount"
-));
-echo "<pre>" . htmlspecialchars(print_r($r->asHash(), true)) . "</pre>";
+```perl
+use strict;
+use warnings;
+use WebService::Hexonet::Connector;
+
+my $api = WebService::Hexonet::Connector::connect(
+	{
+		url => "https://coreapi.1api.net/api/call.cgi",
+		entity => "1234",
+		login => "test.user",
+		password => "test.passw0rd"
+	}
+);
+
+# Call a command
+my $response = $api->call(
+	{
+		command => "QueryDomainList",
+		limit => 5
+	}
+);
+
+# get the result in the format you want
+my $res = $response->as_list();
+$res = $response->as_list_hash();
+$res = $response->as_hash();
+
+# get the response code and the response description
+my $code = $response->code();
+my $description = $response->description();
+
+print "$code $description";
 ```
 
 ## Contributing
 
-Please read [our development guide](https://github.com/hexonet/java-sdk/wiki/Development-Guide) for details on our code of conduct, and the process for submitting pull requests to us.
+Please read [our development guide](https://github.com/hexonet/perl-sdk/wiki/Development-Guide) for details on our code of conduct, and the process for submitting pull requests to us.
 
 ## Authors
 
 * **Anthony Schneider** - *development* - [ISharky](https://github.com/isharky)
 * **Kai Schwarz** - *development* - [PapaKai](https://github.com/papakai)
 
-See also the list of [contributors](https://github.com/hexonet/php-sdk/graphs/contributors) who participated in this project.
+See also the list of [contributors](https://github.com/hexonet/perl-sdk/graphs/contributors) who participated in this project.
 
 ## License