documentation update

Author: ddmitov

README.md

@@ -30,6 +30,7 @@ Perl Executing Browser (PEB) is an HTML5 user interface for [Perl 5](https://www
   * [HTML Page API](./doc/SETTINGS.md#html-page-api)
   * [Perl Scripts API](./doc/SETTINGS.md#perl-scripts-api)
   * [Interactive Perl Scripts](./doc/SETTINGS.md#interactive-perl-scripts)
+  * [Long-Running Windows Perl Scripts](./doc/SETTINGS.md#long-running-windows-perl-scripts)
   * [Starting Local Server](./doc/SETTINGS.md#starting-local-server)
   * [Selecting Files and Folders](./doc/SETTINGS.md#selecting-files-and-folders)
 * [LOGGING](./doc/LOGGING.md)
@@ -48,9 +49,14 @@ in the documentation of this project are to be interpreted as described in [RFC
 ## Quick Start
 
 * Common Steps:
-  * **1.** [Download PEB](https://github.com/ddmitov/perl-executing-browser/releases/latest).
+  * **1.** [Download PEB](https://github.com/ddmitov/perl-executing-browser/releases/latest).  
+    Linux 64-bit single-file [AppImage](https://appimage.org/) executable and  
+    Windows 32-bit zipped executable with its Qt libraries are available.  
 
   * **2.** [Select your Perl distribution](./doc/REQUIREMENTS.md#runtime-requirements).  
+    You can choose between a relocatable Perl distribution and the first Perl on PATH.  
+    Linux 64-bit [Relocatable Perl](https://github.com/skaji/relocatable-perl) or  
+    Windows 32-bit [Strawberry Perl](http://strawberryperl.com/) PortableZIP distributions are available by third-party vendors.  
 
     Place your relocatable Perl distribution in:  
     ``{PEB_executable_directory}/resources/app/perl``  
@@ -119,7 +125,7 @@ in the documentation of this project are to be interpreted as described in [RFC
 * Only single-page applications are supported with no pop-up windows and no Perl scripting inside frames.
 * No files can be downloaded.
 * ``QtWebEngine`` builds do not support printing and ``window.print()`` is not supported.
-* Windows builds of PEB do no support [interactive Perl Scripts](./doc/SETTINGS.md#interactive-perl-scripts).
+* Windows builds of PEB do not support [interactive Perl Scripts](./doc/SETTINGS.md#interactive-perl-scripts).
 
 ## History
 

doc/REQUIREMENTS.md

@@ -10,7 +10,7 @@ Compiling Windows binaries of PEB is subject to the following restrictions:
   but only MSVC-based Qt versions 5.6.x or higher include the ``QtWebEngine`` on the Windows platform.
 * The source code of PEB is not MSVC-compatible and can not use the ``QtWebEngine``.
 * Windows MinGW Qt versions 5.6.x - 5.8.x have neither ``QtWebEngine``, nor ``QtWebKit`` and an updated ``QtWebKit`` has to be manually added from the [QtWebKit repository of Konstantin Tokarev (annulen)](https://github.com/annulen/webkit/releases).
-* Windows builds of PEB do no support [interactive Perl Scripts](SETTINGS.md#interactive-perl-scripts) with STDIN event loops.
+* Windows builds of PEB do not support [interactive Perl Scripts](SETTINGS.md#interactive-perl-scripts) with STDIN event loops.
 
 Compiled and tested successfully using:
 
@@ -87,5 +87,5 @@ All compile-time settings require editing the ``src/peb.pro`` project file accor
   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 if a relocatable Perl distribution is not found in the  
+  PEB will use the first Perl on PATH if a relocatable Perl distribution is not found in the  
   ``{PEB_executable_directory}/resources/app/perl`` folder.

doc/SETTINGS.md

@@ -113,12 +113,26 @@ A JavaScript settings object for a Perl script run by PEB has the following prop
   The only parameter passed to the ``stdoutFunction`` is the STDOUT ``String``.  
   *This object property is mandatory.*  
 
+  An example of an immediate STDOUT data display without accumulation:
+
   ```javascript
   perl_script.stdoutFunction = function (stdout) {
     document.getElementById("DOM-element-id").textContent = stdout;
   };
   ```
 
+  Please note that many Perl scripts do not give their STDOUT data in a single shot.  
+  If several chunks of output have to be combined, this should also be done at JavaScript level:  
+
+  ```javascript
+  var accumulatedOutput;
+
+  perl_script.stdoutFunction = function (stdout) {
+    accumulatedOutput = accumulatedOutput + stdout;
+    document.getElementById("DOM-element-id").textContent = accumulatedOutput;
+  };
+  ```
+
 * **inputData**  
   ``String`` or ``Function`` supplying user data as its return value  
   ``inputData`` is written on script STDIN.  
@@ -206,6 +220,12 @@ The [index.htm](https://github.com/ddmitov/perl-executing-browser/blob/master/re
 
 The [interactive.pl](https://github.com/ddmitov/perl-executing-browser/blob/master/resources/app/perl/interactive.pl) script of the demo package is an example of a Perl interactive script for PEB.
 
+## Long-Running Windows Perl Scripts
+
+Windows builds of PEB do not support [interactive Perl Scripts](./doc/SETTINGS.md#interactive-perl-scripts), but long-running Windows Perl scripts are supported provided that they also have ``$|=1;`` among their first lines to disable the built-in buffering of the Perl interpreter.  
+
+Long-running Windows Perl scripts can not receive the ``SIGTERM`` signal and if they are still running when PEB is closed, they can only be killed with no mechanism for a graceful shutdown.
+
 ## Starting Local Server
 
 A [Mojolicious](http://mojolicious.org/) application or other local Perl server can be started by PEB provided that