IHF: relative_path helper readme added.

Author: dmitry-ivanov

README.md

@@ -56,6 +56,9 @@ Provides Laravel-specific and pure PHP helper functions.
     - [to_rfc2822_email](#to_rfc2822_email)
     - [to_swiftmailer_emails](#to_swiftmailer_emails)
 
+- [Filesystem](#filesystem)
+    - [relative_path](#relative_path)
+
 - [Format](#format)
     - [get_dump](#get_dump)
     - [format_bytes](#format_bytes)
@@ -276,6 +279,26 @@ $address = to_swiftmailer_emails(['address' => 'john.doe@example.com', 'name' =>
 // ["john.doe@example.com" => "John Doe"]
 ```
 
+## Filesystem
+
+#### `relative_path()`
+
+Returns the relative path of a directory given another one:
+
+```php
+$path = relative_path('/var/www/htdocs', '/var/www/htdocs/example')
+
+// '../'
+```
+
+You can pass relative paths as a parameters:
+
+```php
+$path = relative_path('/var/www/htdocs/example/public/../../', '/var/')
+
+// 'www/htdocs/'
+```
+
 ## Format
 
 #### `get_dump()`

tests/HelperFunctions/filesystem/RelativePathTest.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Illuminated\Helpers\HelperFunctions\Tests\FileSystem;
+namespace Illuminated\Helpers\HelperFunctions\Tests\Filesystem;
 
 use Illuminated\Helpers\HelperFunctions\Tests\TestCase;