Improve running and debugging of scripts

- Adapt for running under Neovim more smoothly.
- Add running scripts using the built-in terminal.
- Add commands :Bash, :BashDirectRun, :BashOutputMethod, and :BashExecutable.
- Remove the definition of the maps `CTRL+F9`, `SHIFT+F9`, and `ALT+F9`.
  Add them to your filetype plug-in if you want to use them.
- Integration of BashDB moved into the toolbox.

Note: The filetype plug-in has been moved, and is thus not loaded
automatically anymore. Copy it from `bash-support/rc` to `ftplugin`,
or add the commands there to your own filetype plug-in.

taken from WolfgangMehner/vim-plugins, revision
WolfgangMehner/vim-plugins@174e6ff

Author: WolfgangMehner

README.md

@@ -3,13 +3,34 @@ Preface
 
 This repository is mainly for the use with plug-in managers.
 
-The development happens here:
-[WolfgangMehner/vim-plugins](https://github.com/WolfgangMehner/vim-plugins)
+Have a look at the [Screenshot Page](https://wolfgangmehner.github.io/vim-plugins/bashsupport.html).
+
+The development happens in [WolfgangMehner/vim-plugins](https://github.com/WolfgangMehner/vim-plugins).
+
+
+Preview Version
+================================================================================
+
+___This is a preview version!___
+
+Notable new features:
+
+- Call the Bash interpreter via the command-line: `:Bash <args>`. You can use it
+  to pass arguments to the script.
+- Run Bash in a terminal window directly inside the editor.
+- The template library now has shell options and variables for BASH Version 4.4.
+- The debugger integration has been move into the toolbox, and comes with
+  extended functionality.
+
+The terminal window relies on the new `+terminal` feature, which becomes
+available with a patch level of approx. `8.0.1000`.
+
+_Please read the release notes below._
 
 
 --------------------------------------------------------------------------------
 
-README for bash-support.vim (Version 4.4pre) / June 22 2017
+README for bash-support.vim (Version 5.0alpha) / October 10 2017
 ================================================================================
 
   *  INSTALLATION
@@ -166,17 +187,10 @@ There are a lot of features and options which can be used and influenced:
   *  removing the root menu
   *  using additional plug-ins
 
-Look at the Bash Support help with:
+Actions differ for different modes. Please read the documentation:
 
       :help bashsupport
 
-               +-----------------------------------------------+
-               | +-------------------------------------------+ |
-               | |    ** Please read the documentation **    | |
-               | |    Actions differ for different modes!    | |
-               | +-------------------------------------------+ |
-               +-----------------------------------------------+
-
 Any problems? See the TROUBLESHOOTING section at the end of the help file
 `doc/bashsupport.txt`.
 
@@ -186,17 +200,34 @@ Any problems? See the TROUBLESHOOTING section at the end of the help file
 RELEASE NOTES
 ================================================================================
 
-RELEASE NOTES FOR VERSION 4.4pre
+RELEASE NOTES FOR VERSION 5.0alpha
 ----------------------------------------------------------------------
-- Add shell options and variables for BASH Version 4.4.
+- Adapt for running under Neovim more smoothly.
+- Add command `:Bash [<args>]` to run the interpreter with arguments.
+- Add command `:BashDirectRun` to run executable scripts without `g:BASH_Executable`.
+- Add command `:BashOutputMethod` to set the output destination for `:Bash`.
+- Add command `:BashExecutable` to set the executable during runtime.
+- Add output method 'terminal' for running scripts in a terminal window
+  (requires +terminal).
 - The templates which are inserted into new files as file skeletons can be
   specified in the templates library, via the property:
-    Bash::FileSkeleton::Script
-- Add configuration variables 'g:BASH_Ctrl_j' and 'g:BASH_Ctrl_d' to control the
-  creation of the CTRL+J and CTRL+D maps.
-- New and reworked templates.
+    `Bash::FileSkeleton::Script`
+- Use `g:Xterm_Executable`.
+- Use `g:Xterm_Options` instead of `g:BASH_XtermDefaults`. The setting
+  `g:BASH_XtermDefaults` still works for backwards compatibility.
+- Add configuration variables `g:BASH_Ctrl_j` and `g:BASH_Ctrl_d` to control the
+  creation of the `CTRL+J` and `CTRL+D` maps.
+- Remove the definition of the maps `CTRL+F9`, `SHIFT+F9`, and `ALT+F9`.
+  Add them to your filetype plug-in if you want to use them.
+- Integration of BashDB moved into the toolbox.
+- Add shell options and variables for BASH Version 4.4.
 - Minor corrections and improvements.
 
+Note: The filetype plug-in has been moved, and is thus not loaded automatically
+anymore. Copy it from `bash-support/rc` to `ftplugin`, or add the commands there
+to your own filetype plug-in.
+
+
 RELEASE NOTES FOR OLDER VERSIONS
 ----------------------------------------------------------------------
 -> see file `bash-support/doc/ChangeLog`
@@ -240,10 +271,6 @@ ___The following files and extensions are for convenience only.___
 ___bash-support.vim will work without them.___
 ___The settings are explained in the files themselves.___
 
-    ftplugin/sh.vim
-                        Suggestion for a filetype plugin:
-                          defines additional maps
-
     ftdetect/template.vim
     ftplugin/template.vim
     syntax/template.vim
@@ -271,6 +298,10 @@ ___The settings are explained in the files themselves.___
                         The file is commented. Append it to your .vimrc if you
                         like.
 
+    bash-support/rc/sh.vim
+                        Example filetype plug-ins for Bash:
+                          defines additional maps
+
     bash-support/rc/*.templates
                         Sample template files for customization. Used by the
                         template setup wizard.