documentation update

Author: ddmitov

CREDITS.md

@@ -26,12 +26,17 @@ for being welcoming host of the first public presentation of Perl Executing Brow
 on the 2nd of March 2014 and for their helpful proposals.  
 http://hackafe.org/  
 
+Thanks to Roderich Schupp and all contributors of the [Module::ScanDeps](https://metacpan.org/pod/Module::ScanDeps) CPAN module.
+
+Thanks to Daniel Muey and all contributors of the [File::Copy::Recursive](https://metacpan.org/pod/File::Copy::Recursive) CPAN module.
+
 ## Qt
 https://github.com/richmoore/qt-examples/tree/master/sitespecificbrowser  
 https://github.com/rsdn/avalon/blob/master/web_view.cpp  
 https://github.com/ariya/phantomjs/blob/master/src/qt/src/3rdparty/webkit/Source/WebKit/qt/Api/qwebpage.cpp  
 https://github.com/OtterBrowser/otter-browser/blob/master/src/modules/backends/web/qtwebengine/QtWebEnginePage.cpp  
 https://github.com/OtterBrowser/otter-browser/blob/master/src/modules/backends/web/qtwebengine/QtWebEnginePage.h  
+https://github.com/NixOS/nixpkgs/issues/16327  
 
 http://qt-project.org/doc/qt-4.8/qwebhistory.html  
 http://qt-project.org/doc/qt-4.8/qdir.html  
@@ -120,7 +125,6 @@ http://developer.nokia.com/community/wiki/How_to_write_data_to_a_file_in_Qt (def
 http://harmattan-dev.nokia.com/docs/library/html/qt4/qkeysequence.html (defunct)  
 http://harmattan-dev.nokia.com/docs/library/html/qt4/qdir.html (defunct)  
 http://harmattan-dev.nokia.com/docs/library/html/qt4/qtglobal.html (defunct)  
-http://harmattan-dev.nokia.com/docs/library/html/qtwebkit/qwebpage.html (defunct)  
 
 http://stackoverflow.com/questions/10666998/qwebkit-display-local-webpage  
 http://stackoverflow.com/questions/7402576/how-to-get-current-working-directory-in-a-qt-application  
@@ -211,9 +215,6 @@ http://stackoverflow.com/questions/9051200/twitter-bootstrap-dropdown-menu
 http://stackoverflow.com/questions/2214066/get-list-of-all-input-objects-using-javascript-without-accessing-a-form-obj  
 http://stackoverflow.com/questions/8963693/how-to-create-json-string-in-javascript  
 http://stackoverflow.com/questions/8003089/dynamically-create-and-submit-form  
-http://stackoverflow.com/questions/8003089/dynamically-create-and-submit-form  
-http://stackoverflow.com/questions/588040/window-onload-vs-document-onload  
-http://stackoverflow.com/questions/359788/how-to-execute-a-javascript-function-when-i-have-its-name-as-a-string  
 https://stackoverflow.com/questions/6964927/how-to-create-a-form-dynamically-via-javascript  
 https://stackoverflow.com/questions/16452699/how-to-reset-a-form-using-jquery-with-reset-method  
 https://stackoverflow.com/questions/3955229/remove-all-child-elements-of-a-dom-node-in-javascript  
@@ -225,10 +226,7 @@ http://www.tutorialrepublic.com/twitter-bootstrap-tutorial/bootstrap-dropdowns.p
 http://www.tutorialspoint.com/bootstrap/bootstrap_dropdown_plugin.htm  
 http://twitter-bootstrap.node1.zygote.cc/javascript.html  
 
-http://css3buttongenerator.com/  
-http://callmenick.com/post/various-css-input-text-styles  
 http://www.raymondcamden.com/2015/03/06/warning-a-user-before-they-leave-a-form/  
-https://css-tricks.com/snippets/javascript/check-if-function-exists-before-calling/  
 http://youmightnotneedjquery.com/  
 
 ## Markdown
@@ -241,10 +239,6 @@ http://meta.stackexchange.com/questions/70356/key-stroke-combination-markdown
 ## Bash
 http://tldp.org/LDP/abs/html/fto.html  
 https://www.shellhacks.com/bash-test-if-file-exists/  
-https://www.shellcheck.net/  
-
-## Linux
-http://askubuntu.com/questions/501812/how-do-i-provide-arguments-to-a-command-run-from-gksudo  
 
 ## Mac
 http://www.zestymeta.com/2013/02/qt-osx-app-bundles-and-you.html  

README.md

@@ -9,7 +9,7 @@ Perl Executing Browser
 
 Perl Executing Browser (PEB) is an HTML5 user interface for [Perl 5](https://www.perl.org/) desktop applications. It runs local Perl 5 scripts as child processes with no server or execution timeout and is implemented as a C++ executable based on the [Qt 5](https://www.qt.io/) libraries.  
 
-Inspired by [Electron](http://electron.atom.io/) and [NW.js](http://nwjs.io/), PEB is another reuse of web technologies in desktop applications with Perl doing the heavy lifting. In contrast to Electron and NW.js, PEB does not depend on Node.js, runs JavaScript in a sandbox and blocks cross-origin requests.
+Inspired by [Electron](http://electron.atom.io/) and [NW.js](http://nwjs.io/), PEB is another reuse of web technologies in desktop applications with Perl doing the heavy lifting. In contrast to Electron and NW.js, PEB does not depend on [Node.js](https://nodejs.org/en/), always runs JavaScript in a sandbox and blocks cross-origin requests.
 
 ## Contents
 * [Quick Start](#quick-start)
@@ -45,7 +45,8 @@ These are the basic steps for building your first PEB-based application:
 * **2.** Write [a settings JavaScript object](#perl-scripts-api) for every Perl script you are going to run.
 
 * **3.** Write your Perl scripts.  
-  Input from local HTML forms is read just like reading POST or GET requests in a Perl CGI script. Use the [get-post-test.pl](resources/app/perl/get-post-test.pl) file as an example.
+  Input from local HTML forms is read just like reading POST or GET requests in a Perl CGI script.  
+  You may use the [get-post-test.pl](resources/app/perl/get-post-test.pl) file as an example.
 
 * **4.** Connect your Perl scripts to your local HTML page using [one of the three possible methods](#perl-scripts-api).  
 
@@ -117,6 +118,7 @@ CONFIG += app_bundle
 ## Runtime Requirements
 * Qt 5 libraries.  
   Their full list for a QtWebKit Linux build of PEB can be found inside the [start-peb-webkit.sh](start-peb-webkit.sh) script.  
+  Their full list for a QtWebEngine Linux build of PEB can be found inside the [start-peb-webengine.sh](start-peb-webengine.sh) script.  
 
 * Perl 5 distribution - any Linux, Mac or Windows Perl distribution.  
 

REQUIREMENTS.md

@@ -17,7 +17,10 @@ make
 ```
 
 ## Runtime Requirements
-* Qt 5 libraries - their full Linux list can be found inside the ``start-peb.sh`` script,
+* Qt 5 libraries.  
+  Their full list for a QtWebKit Linux build of PEB can be found inside the [start-peb-webkit.sh](start-peb-webkit.sh) script.  
+  Their full list for a QtWebEngine Linux build of PEB can be found inside the [start-peb-webengine.sh](start-peb-webengine.sh) script.  
+
 * Perl 5 distribution - any Linux, Mac or Windows Perl distribution.  
 
   Tested successfully using the following Perl distributions:  

resources/app/index.html

@@ -272,7 +272,7 @@ <h2>Perl Executing Browser</h2>
 
       <div class="row">
         <div class="col-lg-12 introduction">
-          Inspired by <a href="http://electron.atom.io/">Electron</a> and <a href="http://nwjs.io/">NW.js</a>, PEB is another reuse of web technologies in desktop applications with Perl doing the heavy lifting. In contrast to Electron and NW.js, PEB does not depend on Node.js, runs JavaScript in a sandbox and blocks cross-origin requests.
+          Inspired by <a href="http://electron.atom.io/">Electron</a> and <a href="http://nwjs.io/">NW.js</a>, PEB is another reuse of web technologies in desktop applications with Perl doing the heavy lifting. In contrast to Electron and NW.js, PEB does not depend on <a href="https://nodejs.org/en/">Node.js</a>, always runs JavaScript in a sandbox and blocks cross-origin requests.
         </div>
       </div>
 

start-peb-webengine.sh

@@ -0,0 +1,29 @@
+#! /bin/sh
+
+# Sometimes the Qt libraries that PEB depends on are not available on PATH.
+# This script can start a QtWebEngine build of PEB with no Qt libraries on PATH,
+# if the following libraries are placed in a folder named 'qt'
+# inside the folder of PEB binary and this script:
+
+# qt/libicudata.so.56.1
+# qt/libicui18n.so.56.1
+# qt/libicuuc.so.56.1
+# qt/libQt5Core.so.5.8.0
+# qt/libQt5Gui.so.5.8.0
+# qt/libQt5Network.so.5.8.0
+# qt/libQt5Positioning.so.5.8.0
+# qt/libQt5PrintSupport.so.5.8.0
+# qt/libQt5Qml.so.5.8.0
+# qt/libQt5QuickWidgets.so.5.8.0
+# qt/libQt5WebChannel.so.5.8.0
+# qt/libQt5WebEngineCore.so.5.8.0
+# qt/libQt5WebEngineWidgets.so.5.8.0
+# qt/libQt5Widgets.so.5.8.0
+# qt/libqxcb.so
+
+# This file list was created using the 'ldd' utility and a Qt5.8 build of PEB.
+
+export NO_AT_BRIDGE=1
+export LD_LIBRARY_PATH=$(pwd)/qt
+export QT_QPA_PLATFORM_PLUGIN_PATH=$(pwd)/qt
+./peb