Change some maps

- Change some maps.
- Rename the output methods for running Bash.
- Improve running scripts with ranges.
- Add shell options and variables for BASH Version 4.4 and 5.0.
- Update documentation.

taken from WolfgangMehner/vim-plugins, revision
WolfgangMehner/vim-plugins@a88f0b5

Author: WolfgangMehner

README.md

@@ -30,7 +30,7 @@ _Please read the release notes below._
 
 --------------------------------------------------------------------------------
 
-README for bash-support.vim (Version 5.0alpha) / October 10 2017
+README for bash-support.vim (Version 5.0beta) / November 22 2020
 ================================================================================
 
   *  INSTALLATION
@@ -46,7 +46,7 @@ script, starting a debugger can be done with a keystroke. There are many
 additional hints and options which can improve speed and comfort when writing
 shell scripts.
 
-This plug-in can be used with Vim version 7.x.
+This plug-in can be used with Vim version 7.4+ and Neovim 0.2.1+.
 
 
 --------------------------------------------------------------------------------
@@ -89,12 +89,17 @@ structure which is needed below the local installation directory `$HOME/.vim/`
    This is the minimal content of the file `$HOME/.vimrc`. Create one if there
    is none or use the files in `$HOME/.vim/bash-support/rc` as a starting point.
 
-(1.3) Set at least some personal details. Use the map `\ntw` inside a Bash buffer
+(1.3) Make the plug-in help accessible by typing the following command on the
+   Vim command line:
+
+      :helptags $HOME/.vim/doc/
+
+(1.4) Set at least some personal details. Use the map `\ntw` inside a Bash buffer
    or the menu entry:
 
       Bash -> Snippets -> template setup wizard
 
-   It will help you set up the file _runtimepath_/templates/personal.templates .
+   It will help you set up the file `_runtimepath_/templates/personal.templates`.
    The file is read by all plug-ins supporting this feature to get your personal
    details. Here is the minimal personalization (my settings as an example):
 
@@ -108,11 +113,6 @@ structure which is needed below the local installation directory `$HOME/.vim/`
 
    (Read more about the template system in the plug-in documentation.)
 
-(1.4) Make the plug-in help accessible by typing the following command on the
-   Vim command line:
-
-      :helptags $HOME/.vim/doc/
-
 (1.5) Consider additional settings in the file `$HOME/.vimrc`. The files
    `customization.vimrc` and `customization.gvimrc` are replacements or extensions
    for your `.vimrc` and `.gvimrc`. You may want to use parts of them. The files
@@ -124,7 +124,7 @@ structure which is needed below the local installation directory `$HOME/.vim/`
 
 The subdirectories in the zip archive `bash-support.zip` mirror the directory
 structure which is needed below the local installation directory
-`$HOME/vimfiles/` (find the value of $HOME with `:echo $HOME` from inside Vim).
+`$HOME/vimfiles/` (find the value of `$HOME` with `:echo $HOME` from inside Vim).
 
 (2.0) Save the template files in `$HOME/vimfiles/bash-support/templates/Templates`
    if you have changed any of them.
@@ -146,12 +146,17 @@ structure which is needed below the local installation directory
    This is the minimal content of the file `$HOME/_vimrc`. Create one if there
    is none or use the files in `$HOME/vimfiles/bash-support/rc` as a starting point.
 
-(2.3) Set at least some personal details. Use the map `\ntw` inside a Bash buffer
+(2.3) Make the plug-in help accessible by typing the following command on the
+   Vim command line:
+
+      :helptags $HOME\vimfiles\doc\
+
+(2.4) Set at least some personal details. Use the map `\ntw` inside a Bash buffer
    or the menu entry:
 
       Bash -> Snippets -> template setup wizard
 
-   It will help you set up the file _runtimepath_/templates/personal.templates .
+   It will help you set up the file `_runtimepath_/templates/personal.templates`.
    The file is read by all plug-ins supporting this feature to get your personal
    details. Here is the minimal personalization (my settings as an example):
 
@@ -165,11 +170,6 @@ structure which is needed below the local installation directory
 
    (Read more about the template system in the plug-in documentation.)
 
-(2.4) Make the plug-in help accessible by typing the following command on the
-   Vim command line:
-
-      :helptags $HOME\vimfiles\doc\
-
 (2.5) Consider additional settings in the file `$HOME/_vimrc`. The files
    `customization.vimrc` and `customization.gvimrc` are replacements or extensions
    for your `_vimrc` and `_gvimrc`. You may want to use parts of them. The files
@@ -200,10 +200,11 @@ Any problems? See the TROUBLESHOOTING section at the end of the help file
 RELEASE NOTES
 ================================================================================
 
-RELEASE NOTES FOR VERSION 5.0alpha
+RELEASE NOTES FOR VERSION 5.0beta
 ----------------------------------------------------------------------
 - Adapt for running under Neovim more smoothly.
 - Add command `:Bash [<args>]` to run the interpreter with arguments.
+- Add command `:BashCheck.` the run the syntax checker.
 - 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.
@@ -220,7 +221,7 @@ RELEASE NOTES FOR VERSION 5.0alpha
 - 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.
+- Add shell options and variables for BASH Version 4.4 and 5.0.
 - Minor corrections and improvements.
 
 Note: The filetype plug-in has been moved, and is thus not loaded automatically

autoload/mmtemplates/core.vim

@@ -11,8 +11,8 @@
 "  Organization:  
 "       Version:  see variable g:Templates_Version below
 "       Created:  30.08.2011
-"      Revision:  14.04.2017
-"       License:  Copyright (c) 2012-2016, Wolfgang Mehner
+"      Revision:  06.08.2020
+"       License:  Copyright (c) 2012-2020, Wolfgang Mehner
 "                 This program is free software; you can redistribute it and/or
 "                 modify it under the terms of the GNU General Public License as
 "                 published by the Free Software Foundation, version 2 of the
@@ -23,27 +23,27 @@
 "                 PURPOSE.
 "                 See the GNU General Public License version 2 for more details.
 "===============================================================================
-"
+
 "-------------------------------------------------------------------------------
 " === Basic Checks ===   {{{1
 "-------------------------------------------------------------------------------
-"
+
 " need at least 7.0
 if v:version < 700
 	echohl WarningMsg
 	echo 'The plugin templates.vim needs Vim version >= 7.'
 	echohl None
 	finish
 endif
-"
+
 " prevent duplicate loading
 " need compatible
 if &cp || ( exists('g:Templates_Version') && g:Templates_Version != 'searching' && ! exists('g:Templates_DevelopmentOverwrite') )
 	finish
 endif
-"
-let s:Templates_Version = '1.1alpha'     " version number of this script; do not change
-"
+
+let s:Templates_Version = '1.1beta'     " version number of this script; do not change
+
 "----------------------------------------------------------------------
 "  --- Find Newest Version ---   {{{2
 "----------------------------------------------------------------------
@@ -133,13 +133,13 @@ else
 endif
 " }}}2
 "-------------------------------------------------------------------------------
-"
+
 let g:Templates_Version = s:Templates_Version     " version number of this script; do not change
-"
+
 "----------------------------------------------------------------------
 "  === Modul Setup ===   {{{1
 "----------------------------------------------------------------------
-"
+
 "-------------------------------------------------------------------------------
 " s:ApplyDefaultSetting : Write default setting to a global variable.   {{{2
 "
@@ -152,13 +152,13 @@ let g:Templates_Version = s:Templates_Version     " version number of this scrip
 " If g:<varname> does not exists, assign:
 "   g:<varname> = value
 "-------------------------------------------------------------------------------
-"
+
 function! s:ApplyDefaultSetting ( varname, value )
-	if ! exists ( 'g:'.a:varname )
-		let { 'g:'.a:varname } = a:value
+	if ! exists( 'g:'.a:varname )
+		let {'g:'.a:varname} = a:value
 	endif
-endfunction    " ----------  end of function s:ApplyDefaultSetting  ----------
-"
+endfunction
+
 "-------------------------------------------------------------------------------
 " s:GetGlobalSetting : Get a setting from a global variable.   {{{2
 "
@@ -175,20 +175,20 @@ endfunction    " ----------  end of function s:ApplyDefaultSetting  ----------
 "   g:<varname> == 0  ->  s:<varname> = "no"
 "   otherwise         ->  s:<varname> = "yes"
 "-------------------------------------------------------------------------------
-"
+
 function! s:GetGlobalSetting ( varname, ... )
-	if a:0 > 0 && a:1 == 'bin' && exists ( 'g:'.a:varname ) && type ( 0 ) == type ( { 'g:'.a:varname } )
-		let { 's:'.a:varname } = { 'g:'.a:varname } == 0 ? 'no' : 'yes'
-	elseif exists ( 'g:'.a:varname )
-		let { 's:'.a:varname } = { 'g:'.a:varname }
+	if a:0 > 0 && a:1 == 'bin' && exists( 'g:'.a:varname ) && type( 0 ) == type( {'g:'.a:varname} )
+		let {'s:'.a:varname} = {'g:'.a:varname} == 0 ? 'no' : 'yes'
+	elseif exists( 'g:'.a:varname )
+		let {'s:'.a:varname} = {'g:'.a:varname}
 	endif
-	"
-	let s:Templates_AllSettings[ a:varname ] = { 's:'.a:varname }
-endfunction    " ----------  end of function s:GetGlobalSetting  ----------
-"
+
+	let s:Templates_AllSettings[ a:varname ] = {'s:'.a:varname}
+endfunction
+
 " }}}2
 "-------------------------------------------------------------------------------
-"
+
 " platform specifics
 let s:MSWIN = has("win16") || has("win32")   || has("win64")     || has("win95")
 let s:UNIX	= has("unix")  || has("macunix") || has("win32unix")

autoload/mmtoolbox/bash/bashdb.vim

@@ -8,13 +8,13 @@
 "
 "                 See help file bashdbintegration.txt .
 " 
-"   VIM Version:  7.0+
+"   VIM Version:  7.3+
 "        Author:  Wolfgang Mehner, wolfgang-mehner@web.de
 "  Organization:  
 "       Version:  see variable g:BashDB_Version below
 "       Created:  28.09.2017
-"      Revision:  -
-"       License:  Copyright (c) 2017-2017, Wolfgang Mehner
+"      Revision:  19.04.2019
+"       License:  Copyright (c) 2017-2019, Wolfgang Mehner
 "                 This program is free software; you can redistribute it and/or
 "                 modify it under the terms of the GNU General Public License as
 "                 published by the Free Software Foundation, version 2 of the
@@ -257,8 +257,8 @@ function! s:ShellParseArgs ( line )
 			let curr .= mlist[1]
 			let line  = mlist[2]
 		else
-			" otherwise parse up to next space
-			let mlist = matchlist ( line, '^\(\S\+\)\(.*\)' )
+			" otherwise parse up to next special char.: space, backslash, quote
+			let mlist = matchlist ( line, '^\([^[:space:]\\''"]\+\)\(.*\)' )
 			let curr .= mlist[1]
 			let line  = mlist[2]
 		endif
@@ -395,7 +395,7 @@ if executable ( s:BashDB_DDD_Exec )
 	let s:BashDB_DebuggerList += [ 'ddd' ]
 endif
 if has ( 'terminal' )
-	let s:BashDB_DebuggerList += [ 'terminal' ]
+	let s:BashDB_DebuggerList += [ 'terminal', 'integrated' ]
 endif
 call sort ( s:BashDB_DebuggerList )
 
@@ -649,6 +649,8 @@ function! s:Run ( args )
 
 		silent exe '!ddd --debugger '.s:BashDB_Executable.' '.script_name.script_args.' &'
 	elseif s:BashDB_Debugger == 'terminal'
+		call s:ImportantMsg ( 'not implemented yet' )
+	elseif s:BashDB_Debugger == 'integrated'
 		call s:StartInternal ( script_name.script_args )
 	endif
 endfunction    " ----------  end of function s:Run  ----------
@@ -665,7 +667,9 @@ endfunction    " ----------  end of function s:Run  ----------
 
 let s:debug_status   = ''
 let s:debug_buf_ctrl = -1
+let s:debug_win_ctrl = -1
 let s:debug_buf_io   = -1
+let s:debug_win_io   = -1
 
 let s:debug_buf_script = -1
 let s:debug_win_script = -1
@@ -684,28 +688,50 @@ function! s:StartInternal ( args )
 		return s:WarningMsg ( 'debugger already running' )
 	endif
 
+	" bashdb: uses --tty the other way around
+	let is_bashdb = 0
+	let name_pty = 'BashDB - I/O'
+	let name_job = 'BashDB - CTRL'
+	if s:BashDB_Executable =~? '\cbashdb'
+		let is_bashdb = 1
+		let name_pty = 'BashDB - CTRL'
+		let name_job = 'BashDB - I/O'
+	endif
+
 	" script buffer/window
 	let s:debug_buf_script = bufnr( '%' )
 	let s:debug_win_script = win_getid( winnr() )
 
-	" the BashDB control commands are run through this terminal
-	let s:debug_buf_ctrl = term_start ( 'NONE', {
-				\ 'term_name' : 'BashDB - CTRL',
+	" only the script I/O appears here
+	let s:debug_buf_io = term_start ( 'NONE', {
+				\ 'term_name' : name_pty,
 				\ } )
+	let s:debug_win_io = win_getid( winnr() )
 
-	let tty = term_gettty ( s:debug_buf_ctrl )
+	let tty = term_gettty ( s:debug_buf_io )
 
-	" start bashdb in another terminal, only the script I/O appears here
+	" start in another terminal, the control commands are run through this terminal
 	let arg_list  = [ s:BashDB_Executable ]
 	let arg_list += [ '--tty', tty, '-x', tty ]
 	let arg_list += s:ShellParseArgs ( a:args )
 
-	belowright new
-	let s:debug_buf_io = term_start ( arg_list, {
-				\ 'term_name' : 'BashDB - I/O',
-				\ 'curwin'    : 1,
+	" bashdb: switch order of windows (also see 'curwin' below)
+	if is_bashdb
+		belowright new
+	endif
+
+	let s:debug_buf_ctrl = term_start ( arg_list, {
+				\ 'term_name' : name_job,
+				\ 'curwin'    : is_bashdb,
 				\ 'exit_cb'   : function ( 's:EndInternal' ),
 				\ } )
+	let s:debug_win_ctrl = win_getid( winnr() )
+
+	" bashdb: switch the buffers
+	if is_bashdb
+		let [ s:debug_buf_io, s:debug_buf_ctrl ] = [ s:debug_buf_ctrl, s:debug_buf_io ]
+		let [ s:debug_win_io, s:debug_win_ctrl ] = [ s:debug_win_ctrl, s:debug_win_io ]
+	endif
 
 	" now we're cooking
 	let s:debug_status = 'running'