documentation update

Author: ddmitov

ACKNOWLEDGEMENTS

@@ -1,6 +1,7 @@
 
-THANKS, ACKNOWLEDGEMENTS AND REFERENCES FOR
-PERL EXECUTING BROWSER
+PERL EXECUTING BROWSER -
+THANKS, ACKNOWLEDGEMENTS AND REFERENCES
+================================
 
 Amata mea Argeia - gratiam magnam tibi ago!
 Patientia tua in studiis meis computatoriis auxilium meum maximum!
@@ -37,7 +38,7 @@ This is the syntax highlighter of the Perl Debugger GUI inside Perl Executing Br
 https://metacpan.org/release/Syntax-Highlight-Engine-Kate
 
 QT
-==
+================================
 https://gitorious.org/qt-examples/qt-examples/source/sitespecificbrowser
 
 https://github.com/richmoore/qt-examples/tree/master/sitespecificbrowser
@@ -204,18 +205,20 @@ 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/
 
 CGI
-===
+================================
 http://en.wikipedia.org/wiki/Common_Gateway_Interface
 
 PERL
-====
-Larry Wall, Tom Christiansen, Jon Orwant "Programming Perl. Third Edition", O'Reilly, July 2000, ISBN 0-596-00027-8, 31.13. use lib
+================================
+Larry Wall, Tom Christiansen, Jon Orwant "Programming Perl. Third Edition", O'Reilly, July 2000, ISBN 0-596-00027-8,
+31.13. use lib
 http://docstore.mik.ua/orelly/perl2/prog/ch31_13.htm
 
 Peter Wainwright "Pro Perl. A comprehensive guide for developers who want to master the Perl programming language", Apress, 2005, p. 104 - 107
 https://books.google.bg/books?id=1bbjLxkBLaMC&pg=PA105
 
-Eric Cholet, Stas Bekman "Practical mod_perl", O'Reilly, May 2003, ISBN 0-596-00227-0, 3.9.2.1. Modifying @INC
+Eric Cholet, Stas Bekman "Practical mod_perl", O'Reilly, May 2003, ISBN 0-596-00227-0,
+3.9.2.1. Modifying @INC
 http://modperlbook.org/html/3-9-2-1-Modifying-INC.html
 
 http://www.perlmonks.org/?node_id=737134 "How to redirect STDOUT to an array (not executing program)"
@@ -242,13 +245,13 @@ http://modperlbook.org/html/3-9-2-1-Modifying-INC.html
 http://www.tutorialspoint.com/perl/perl_syscall.htm
 
 MAC
-===
+================================
 http://www.zestymeta.com/2013/02/qt-osx-app-bundles-and-you.html
 http://leonid.shevtsov.me/en/how-to-create-icns-icons-for-os-x
 http://iconverticons.com/online/
 
 HTML, CSS & JAVASCRIPT
-=================
+================================
 http://stackoverflow.com/questions/9051200/twitter-bootstrap-dropdown-menu
 http://stackoverflow.com/questions/9436534/ajax-tutorial-for-post-and-get
 http://stackoverflow.com/questions/6395720/get-data-from-php-array-ajax-jquery
@@ -288,3 +291,7 @@ 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/
+
+MARKDOWN
+================================
+https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet

README.md

@@ -37,8 +37,8 @@ Perl Executing Browser (PEB) is a C++ [Qt 5] (https://www.qt.io/) WebKit impleme
 * Optional warning for unsaved data in HTML forms before closing a window to prevent accidental data loss.
 
 **Development goodies:**
-* PEB can interact with the built-in Perl 5 debugger. Any Perl script can be selected for debugging in an HTML user interface. The debugger output is displayed together with the syntax highlighted source code of the debugged script and it's modules. Interaction with the built-in Perl debugger is an idea proposed by Valcho Nedelchev.
-* ```QWebInspector``` window can be invoked using Ctrl+I keyboard shortcut.
+* PEB can interact with the Perl 5 debugger in graphical mode - see section 'HTML Interface for the Perl Debugger'  
+* ```QWebInspector``` window can be invoked using ```Ctrl+I``` keyboard shortcut.
 * Extensive optional logging of all browser activities.
 
 ## Compile-time Requirements
@@ -62,7 +62,8 @@ Compiled and tested successfully using:
 ## Runtime Requirements
 
 * Qt 5 libraries,
-* Perl 5 distribution - any Linux, Mac or Windows Perl distribution.
+* Perl 5 distribution - any Linux, Mac or Windows Perl distribution.  
+  [Strawberry Perl] (http://strawberryperl.com/) PortableZIP edition is successfully used with all Windows builds of PEB.
 
 ## Settings
 
@@ -232,9 +233,9 @@ JavaScript-based settings are created to facilitate the development of fully tra
 
 * **About Qt dialog box:** ```http://perl-executing-browser-pseudodomain/?type=browser```
 
-## HTML interface for Interaction with the Perl Debugger
-  
-![PEB Perl Debugger HTML Interface](https://github.com/ddmitov/perl-executing-browser/raw/master/screenshots/peb-perl-debugger.png "PEB Perl Debugger HTML Interface")
+## HTML Interface for the Perl Debugger
+   Any Perl script can be selected for debugging in an embedded HTML user interface. The debugger output is displayed together with the syntax highlighted source code of the debugged script and it's modules. Syntax highlighting is achieved using ```Syntax::Highlight::Engine::Kate``` CPAN module by Hans Jeuken and Gábor Szabó. Interaction with the built-in Perl debugger is an idea proposed by Valcho Nedelchev and provoked by the scarcity of graphical frontends for the built-in Perl debugger.  
+   ![PEB Perl Debugger HTML Interface](https://github.com/ddmitov/perl-executing-browser/raw/master/screenshots/peb-perl-debugger.png "PEB Perl Debugger HTML Interface")
 
 ## Special URLs for Interaction with the Perl Debugger
 
@@ -260,13 +261,13 @@ JavaScript-based settings are created to facilitate the development of fully tra
 * **Font files:** ```.eot``` ```.ttf``` ```.woff``` ```.woff2```
 
 ## Keyboard Shortcuts
-* Ctrl+A - Select All
-* Ctrl+C - Copy  
-* Ctrl+V - Paste  
-* F11 - toggle Fullscreen
-* Alt+F4 - Close window
-* Ctrl+P - Print
-* Ctrl+I - debug current page using ```QWebInspector```
+* ```Ctrl+A``` - Select All
+* ```Ctrl+C``` - Copy  
+* ```Ctrl+V``` - Paste  
+* ```F11``` - toggle Fullscreen
+* ```Alt+F4``` - Close window
+* ```Ctrl+P``` - Print
+* ```Ctrl+I``` - debug current page using ```QWebInspector```
 
 ## Security