documentation update

Author: ddmitov

CREDITS.md

@@ -30,6 +30,8 @@ http://hackafe.org/
 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  
 
 http://qt-project.org/doc/qt-4.8/qwebhistory.html  
 http://qt-project.org/doc/qt-4.8/qdir.html  
@@ -63,7 +65,9 @@ http://qt-project.org/forums/viewthread/15487 (How to list foreach from array)
 http://qt-project.org/forums/viewthread/8876 (Setting global variable in main())  
 
 http://doc.qt.digia.com/qtcreator-extending/coding-style.html  
+
 https://doc.qt.io/archives/4.6/webkit-fancybrowser-mainwindow-cpp.html  
+http://doc.qt.io/archives/qt-5.5/qwebpage.html#windowCloseRequested  
 
 http://doc.qt.io/qt-4.8/qmake-advanced-usage.html  
 http://doc.qt.io/qt-4.8/qwebframe.html  
@@ -77,6 +81,12 @@ http://doc.qt.io/qt-5/qhash.html
 http://doc.qt.io/qt-5/qhash-iterator.html  
 http://doc.qt.io/qt-5/qdesktopwidget.html  
 http://doc.qt.io/archives/qt-5.5/qwebview.html  
+http://doc.qt.io/qt-5/qtwebenginewidgets-qtwebkitportingguide.html  
+http://doc.qt.io/qt-5/qwebenginepage.html#runJavaScript  
+http://doc.qt.io/qt-5/qwebenginepage.html#fullScreenRequested  
+http://doc.qt.io/qt-5/qwebenginepage.html#windowCloseRequested  
+http://doc.qt.io/qt-5/qtwebengine-webenginewidgets-simplebrowser-example.html#adding-context-menu-items  
+http://doc.qt.io/qt-5/qwebenginefullscreenrequest.html  
 
 https://wiki.qt.io/Qt_Coding_Style  
 https://wiki.qt.io/Open_Web_Page_in_QWebView  
@@ -138,11 +148,9 @@ http://stackoverflow.com/questions/19822211/qt-parsing-json-using-qjsondocument-
 http://stackoverflow.com/questions/25254043/is-it-possible-to-compare-ifdef-values-for-conditional-use  
 http://stackoverflow.com/questions/10701504/command-working-in-terminal-but-not-via-qprocess  
 http://stackoverflow.com/questions/17680207/qhash-iterator-example-no-match-for-operator  
-
-http://www.codeprogress.com/cpp/libraries/qt/showQtExample.php?index=598&key=QWebViewCustomContextMenu  
-
-http://comments.gmane.org/gmane.comp.lib.qt.user/960 (QString to QByteArray conversion)  
-http://comments.gmane.org/gmane.comp.lib.qt.general/35521 (webkit - how to prevent alert popups)  
+https://stackoverflow.com/questions/23174393/parse-jsonarray  
+https://stackoverflow.com/questions/24899558/how-to-check-qt-version-to-include-different-header  
+https://stackoverflow.com/questions/19822211/qt-parsing-json-using-qjsondocument-qjsonobject-qjsonarray  
 
 http://www.java2s.com/Code/Cpp/Qt/CheckfileexistanceandfilenamewithQFile.htm  
 http://webkit.sed.hu/content/disabling-cache  
@@ -155,6 +163,8 @@ http://habrahabr.ru/post/150329/ (Qt Coding Style)
 http://www.freehackers.org/thomas/2009/03/10/fixing-qmake-missing-rule-for-ts-qm/  
 http://lemirep.wordpress.com/2013/06/01/deploying-qt-applications-on-linux-and-windows-3/  
 https://unix.stackexchange.com/questions/116254/how-do-i-change-which-version-of-qt-is-used-for-qmake  
+https://www.developpez.net/forums/d1549582/c-cpp/bibliotheques/qt/moteurs-web/runjavascript-fonction-lambda-plante/  
+https://medium.com/genymobile/how-c-lambda-expressions-can-improve-your-qt-code-8cd524f4ed9f  
 
 ## Perl 5
 https://perlbrew.pl/  
@@ -192,10 +202,10 @@ http://www.tizag.com/perlT/perlhashes.php
 http://www.w3schools.com/bootstrap/bootstrap_tooltip.asp  
 http://www.w3schools.com/bootstrap/bootstrap_ref_js_tooltip.asp  
 http://www.w3schools.com/cssref/css_websafe_fonts.asp  
-http://www.w3schools.com/html/html_lists.asp  
-http://www.w3schools.com/jquery/html_html.asp  
+http://www.w3schools.com/html/html_lists.asp    
 http://www.w3schools.com/js/js_loop_for.asp  
 http://www.w3schools.com/jsref/prop_html_innerhtml.asp  
+https://www.w3schools.com/jsref/met_form_submit.asp  
 
 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  
@@ -204,6 +214,9 @@ 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  
 
 http://getbootstrap.com/components/#dropdowns  
 

README.md

@@ -45,7 +45,7 @@ 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`` file within the PEB demo package as an example.
+  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.
 
 * **4.** Connect your Perl scripts using a link to ``name-of-script-configuration-object.settings``.  
 
@@ -71,7 +71,7 @@ PEB is created to work from any folder without installation and all your local H
 
 ## Security
 * PEB does not need administrative privileges, but does not refuse to use them if needed.
-* PEB does not install or start any kind of server.
+* PEB does not use any kind of server.
 * PEB executes with no sandbox only local Perl 5 scripts and
   users have full access to their local files.
 * Cross-origin requests and cross-site scripting are disabled.
@@ -115,7 +115,9 @@ CONFIG += app_bundle
 ```
 
 ## 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`` script.
+
 * Perl 5 distribution - any Linux, Mac or Windows Perl distribution.  
 
   Tested successfully using the following Perl distributions:  
@@ -129,11 +131,11 @@ CONFIG += app_bundle
   PEB can also use any Perl on PATH.
 
 ## Preparing a Perl Distribution for PEB
-Sometimes it is important to minimize the size of the relocatable (or portable) Perl distribution used by a PEB-based application. ``{PEB_binary_directory}/sdk/compactor.pl`` script is one solution to this problem. It finds all dependencies of all Perl scripts in the ``{PEB_binary_directory}/resources/app`` directory and copies them in a new ``{PEB_binary_directory}/perl/lib`` folder; a new ``{PEB_binary_directory}/perl/bin`` is also created. The original ``bin`` and ``lib`` folders are saved as ``{PEB_binary_directory}/perl/bin-original`` and ``{PEB_binary_directory}/perl/lib-original`` respectively. These directories should be manually archived for future use or removed.  
+Sometimes it is important to minimize the size of the relocatable (or portable) Perl distribution used by a PEB-based application. [{PEB_binary_directory}/sdk/compactor.pl](sdk/compactor.pl) script is one solution to this problem. It finds all dependencies of all Perl scripts in the ``{PEB_binary_directory}/resources/app`` directory and copies them in a new ``{PEB_binary_directory}/perl/lib`` folder; a new ``{PEB_binary_directory}/perl/bin`` is also created. The original ``bin`` and ``lib`` folders are saved as ``{PEB_binary_directory}/perl/bin-original`` and ``{PEB_binary_directory}/perl/lib-original`` respectively. These directories should be manually archived for future use or removed.  
 
-``compactor.pl`` should be started using ``{PEB_binary_directory}/compactor.sh`` on a Linux or a Mac machine and ``{PEB_binary_directory}/compactor.cmd`` on a Windows machine to ensure that only the Perl distribution used by PEB is going to start ``compactor.pl``. This is necessary to avoid dependency mismatches with any other Perl on PATH.  
+``compactor.pl`` should be started using [{PEB_binary_directory}/compactor.sh](compactor.sh) on a Linux or a Mac machine or [{PEB_binary_directory}/compactor.cmd](compactor.cmd) on a Windows machine to ensure that only the Perl distribution used by PEB is going to start ``compactor.pl``. This is necessary to avoid dependency mismatches with any other Perl on PATH.  
 
-``compactor.pl`` relies on ``Module::ScanDeps`` and ``File::Copy::Recursive`` CPAN modules, which are located in the ``{PEB_binary_directory}/sdk/lib`` folder.  
+``compactor.pl`` relies on ``Module::ScanDeps`` and ``File::Copy::Recursive`` CPAN modules, which are included in the ``{PEB_binary_directory}/sdk/lib`` folder.  
 
 ## Perl Scripts API
 Every Perl script run by PEB is called by clicking a link or submitting a form to a pseudo filename composed from the name of the JavaScript object with the settings of the Perl script and a ``.settings`` extension.  
@@ -174,7 +176,7 @@ peb.startScript('perl_test.settings');
   *This object property is mandatory.*  
 
 * ``stdoutFunction``  
-  The ``stdoutFunction`` object property must be a JavaScript function. Every piece of script output is passed to this function as its only argument.  
+  Every piece of script output is passed to this function as its only argument.  
   *This object property is mandatory.*  
 
 * ``requestMethod``  
@@ -184,7 +186,7 @@ peb.startScript('perl_test.settings');
   This object property is useless if ``requestMethod`` is not set.  
 
 * ``inputDataHarvester``  
-  This object property is a function that can get input data from an HTML form or other data source and supply it to PEB.  
+  This object property is a function that can get input data from an HTML form and supply it to PEB.  
 
   Single input box example with no dependencies:  
 
@@ -255,7 +257,7 @@ The following code shows how to start an interactive Perl script right after a l
 </html>
 ```
 
-The ``index.htm`` file of the demo package demonstrates how to start one script in two instances immediately after a page is loaded.
+The [index.htm](resources/app/index.html) file of the demo package demonstrates how to start one script in two instances immediately after a page is loaded.
 
 ## Selecting Files and Folders
 Selecting files or folders with their full paths is performed by clicking a link to a pseudo filename composed from the name of the JavaScript object with the settings of the wanted dialog and a ``.dialog`` extension. Selected files or folders are seamlessly inserted in any local page by the ``receiverFunction`` taking all selected files or folders as its only argument.  

start-peb.sh renamed to start-peb-webkit.sh

@@ -1,7 +1,7 @@
 #! /bin/sh
 
-# Sometimes the Qt libraries, that PEB depends on, are not available on PATH.
-# This script can start PEB with no Qt libraries on PATH,
+# Sometimes the Qt libraries that PEB depends on are not available on PATH.
+# This script can start a QtWebKit 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: