documentation update

Author: ddmitov

CREDITS.md

@@ -247,7 +247,7 @@ https://ryanstutorials.net/bash-scripting-tutorial/bash-functions.php
 https://www.freedesktop.org/software/appstream/docs/chap-Quickstart.html  
 https://specifications.freedesktop.org/desktop-entry-spec/1.1/apa.html  
 
-## Macintosh
+## Mac
 
 http://leonid.shevtsov.me/en/how-to-create-icns-icons-for-os-x  
 https://iconverticons.com/online/  

README.md

@@ -49,7 +49,15 @@ in the documentation of this project are to be interpreted as described in [RFC
 
 * Common Steps:
   * **1.** [Download PEB](https://github.com/ddmitov/perl-executing-browser/releases/latest).
-  * **2.** [Select your Perl distribution](./doc/REQUIREMENTS.md#runtime-requirements).
+
+  * **2.** [Select your Perl distribution](./doc/REQUIREMENTS.md#runtime-requirements).  
+  Place your Perl relocatable distribution in:  
+  ``{PEB_executable_directory}/resources/app/perl``  
+  Your relocatable Perl interpreter must be:  
+  ``{PEB_executable_directory}/resources/perl/bin/perl`` on a Linux or Mac macine or  
+  ``{PEB_executable_directory}/resources/perl/bin/wperl.exe`` on a Windows macine.  
+  Your relocatable PERL5LIB folder must be:  
+  ``{PEB_executable_directory}/resources/perl/lib``  
 
 * Serverless Application:
   * **3.** Write your Perl application reading user input on STDIN:
@@ -59,14 +67,14 @@ in the documentation of this project are to be interpreted as described in [RFC
     chomp $input;
     ```
 
-  * **4.** Write an appropriate HTML interface with a [settings JavaScript object](./doc/SETTINGS.md#perl-scripts-api) for your Perl application.  
-    Triggering a Perl script from a local HTML page is configured using [one of the three possible methods](./doc/SETTINGS.md#perl-scripts-api).  
+  * **4.** Write ``{PEB_executable_directory}/resources/app/index.html`` with a [settings JavaScript object](./doc/SETTINGS.md#perl-scripts-api) for your Perl application.  
+    Triggering a Perl script from a local HTML page can be configured using [one of the three possible methods](./doc/SETTINGS.md#perl-scripts-api).  
     [Selecting files or folders with their full paths](./doc/SETTINGS.md#selecting-files-and-folders) is also possible.
 
 * Local Server Application:
   * **3.** Write your Perl server application.
   * **4.** Write [local-server.json](./doc/SETTINGS.md#starting-local-server) for your local Perl server.
-  * **5.** Write an appropriate HTML interface and connect it to your server application by traditional web  communication protocols.
+  * **5.** Write a start page.
 
 ## Design Objectives
 
@@ -80,7 +88,7 @@ in the documentation of this project are to be interpreted as described in [RFC
 
 * PEB can be started from any folder without installation procedure.
 * [Perl script output is seamlessly inserted in any local page.](./doc/SETTINGS.md#perl-scripts-api)
-* [Perl scripts with STDIN event loops can be repeatedly fed with data (Linux and Macintosh builds only).](./doc/SETTINGS.md#interactive-perl-scripts)
+* [Perl scripts with STDIN event loops can be repeatedly fed with data (Linux and Mac builds only).](./doc/SETTINGS.md#interactive-perl-scripts)
 * [Perl local servers can be started.](./doc/SETTINGS.md#starting-local-server)
 * [Any version of Perl 5 can be used.](./doc/REQUIREMENTS.md#runtime-requirements)
 * [Single file or multiple files, new filename, existing or new directory can be selected by user.](./doc/SETTINGS.md#selecting-files-and-folders)  

doc/CONSTANTS.md

@@ -16,7 +16,7 @@ A typical ``{PEB_executable_directory}`` looks like this:
     │   └── {application_data}
     ├── perl
     │   ├── bin
-    │   │   └── {perl_interpreter}
+    │   │   └── perl || wperl.exe
     │   └── lib
     │       └── {perl_modules}
     └── app.png

doc/REQUIREMENTS.md

@@ -2,7 +2,7 @@
 
 ## Compile-Time Requirements
 
-The only Linux and Macintosh compile-time requirement of PEB is a Qt development bundle version 5.2 or any later version.  
+The only Linux and Mac compile-time requirement of PEB is a Qt development bundle version 5.2 or any later version.  
 
 Compiling Windows binaries of PEB is subject to the following restrictions:  
 
@@ -53,7 +53,7 @@ All compile-time settings require editing the ``src/peb.pro`` project file accor
 
   Setting ``ANNULEN_QTWEBKIT`` to ``1`` has no effect on Qt versions 5.5 or lower.  
 
-* Macintosh Bundle  
+* Mac Bundle  
   To make a bundle-less binary, which is the default setting:  
 
   ```QMake
@@ -81,10 +81,10 @@ All compile-time settings require editing the ``src/peb.pro`` project file accor
   Tested successfully using the following Perl distributions:  
 
   Linux 64-bit [Perlbrew](https://perlbrew.pl/) Perl versions 5.18.4, 5.23.7  
-  Linux 64-bit [Relocatable Perl](https://github.com/skaji/relocatable-perl) version 5.24.1  
+  Linux 64-bit [Relocatable Perl](https://github.com/skaji/relocatable-perl) versions 5.24.1, 5.26.1  
   Windows 32-bit [Strawberry Perl](http://strawberryperl.com/) PortableZIP versions 5.12.2.0, 5.16.1.1, 5.20.2.1  
 
-  To use a Perlbrew Perl with PEB create a symlink to the wanted Perl interpreter named:  
-  ``{PEB_executable_directory}/perl/bin/perl``  
+  To use a Perlbrew Perl with PEB create a symlink at:  
+  ``{PEB_executable_directory}/resources/perl/bin/perl``  
 
   PEB can also use any Perl on PATH.

src/peb.pro

@@ -48,7 +48,7 @@ greaterThan (QT_MAJOR_VERSION, 4) {
     DEFINES += "ANNULEN_QTWEBKIT=$$ANNULEN_QTWEBKIT"
 
     ##########################################################
-    # MACINTOSH BUNDLE
+    # MAC BUNDLE
 
     # To make a bundle-less binary:
     # BUNDLE = 0