Improve plug-in configuration and set-up

- Remove filetype detection for *.t, should be handled reasonably by Vim's
  own detection.
- Remove adjustment of syntax for *.pod, this can be done by the user.
- Remove the template personalization hint.
- Move filetype plug-ins.
- Update the suggestions for configuration files ".vimrc" and ".gvimrc".
- Improve the documentation.

Note: Some configuration for `*.t` and `*.pod` files has been removed.
See `perl-support/rc/customization.vimrc` for how to add them to your
configuration files.

Note: The filetype plug-ins have been moved, and are thus not loaded
automatically anymore. Copy them from 'perl-support/rc' to 'ftplugin',
or add the commands there to your own filetype plug-ins.

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

Author: WolfgangMehner

README.md

@@ -10,7 +10,7 @@ The development happens in [WolfgangMehner/vim-plugins](https://github.com/Wolfg
 
 --------------------------------------------------------------------------------
 
-README for perl-support.vim (Version 5.5pre) / October 02 2017
+README for perl-support.vim (Version 5.5pre) / April 21 2019
 ================================================================================
 
   *  INSTALLATION
@@ -71,7 +71,12 @@ 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/perl-support/rc` as a starting point.
 
-(1.3) Set at least some personal details. Use the map `\ntw` inside a Perl 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 Perl buffer
    or the menu entry:
 
       Perl -> Snippets -> template setup wizard
@@ -90,11 +95,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
@@ -128,7 +128,12 @@ 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/perl-support/rc` as a starting point.
 
-(2.3) Set at least some personal details. Use the map `\ntw` inside a Perl 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 Perl buffer
    or the menu entry:
 
       Perl -> Snippets -> template setup wizard
@@ -147,11 +152,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
@@ -175,17 +175,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 Perl Support help with:
+Actions differ for different modes. Please read the documentation:
 
       :help perlsupport
 
-               +-----------------------------------------------+
-               | +-------------------------------------------+ |
-               | |    ** PLEASE READ THE DOCUMENTATION **    | |
-               | |    Actions differ for different modes!    | |
-               | +-------------------------------------------+ |
-               +-----------------------------------------------+
-
 Any problems? See the TROUBLESHOOTING section at the end of the help file
 `doc/perlsupport.txt`.
 
@@ -199,12 +192,21 @@ RELEASE NOTES FOR VERSION 5.5pre
 ----------------------------------------------------------------------
 - The templates which are inserted into new files as file skeletons can be
   specified in the templates library, via the properties:
-    Perl::FileSkeleton::Script, Perl::FileSkeleton::Module,
-    Perl::FileSkeleton::Test,   Perl::FileSkeleton::POD
-- Add configuration variable and 'g:Perl_Ctrl_d' to control the creation
-  of the CTRL+D map.
+    `Perl::FileSkeleton::Script`, `Perl::FileSkeleton::Module`,
+    `Perl::FileSkeleton::Test`,   `Perl::FileSkeleton::POD`
+- Add configuration variable `g:Perl_Ctrl_d` to control the creation
+  of the `CTRL+D` map.
 - Minor changes.
 
+Note: The filetype plug-ins have been moved, and are thus not loaded
+automatically anymore. Copy them from `perl-support/rc` to `ftplugin`,
+or add the commands there to your own filetype plug-ins.
+
+Note: Some configuration for `*.t` and `*.pod` files has been removed.
+See `perl-support/rc/customization.vimrc` for how to add them to your
+configuration files.
+
+
 RELEASE NOTES FOR OLDER VERSIONS
 ----------------------------------------------------------------------
 -> see file `perl-support/doc/ChangeLog`
@@ -259,16 +261,6 @@ ___The following files and extensions are for convenience only.___
 ___perl-support.vim will work without them.___
 ___The settings are explained in the files themselves.___
 
-    ftplugin/make.vim
-                        Access hotkeys for make(1) in makefiles.
-    ftplugin/perl.vim
-                        A filetype plugin. Define hotkeys, create a local
-                        dictionary for each Perl file.
-    ftplugin/pod.vim
-                        A filetype plugin. Define hotkeys for filetype 'pod'.
-    ftplugin/qf.vim
-                        A filetype plugin used by the profilers.
-
     ftdetect/template.vim
     ftplugin/template.vim
     syntax/template.vim
@@ -295,6 +287,17 @@ ___The settings are explained in the files themselves.___
                         The file is commented. Append it to your .vimrc if you
                         like.
 
+    perl-support/rc/make.vim
+                        Access hotkeys for make(1) in makefiles.
+    perl-support/rc/perl.vim
+    perl-support/rc/pod.vim
+                        Example filetype plug-ins for Perl and POD:
+                          defines additional maps,
+                          set tabs according to Perl Style Guide
+                          expands keyword characters for better support of tokens,
+    perl-support/rc/qf.vim
+                        Some maps to help with the profilers' output.
+
     perl-support/rc/*.templates
                         Sample template files for customization. Used by the
                         template setup wizard.

autoload/mmtoolbox/make.vim

@@ -13,7 +13,7 @@
 "  Organization:  
 "       Version:  see variable g:Make_Version below
 "       Created:  06.05.2013
-"      Revision:  07.10.2016
+"      Revision:  17.10.2017
 "       License:  Copyright (c) 2013-2015, 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
@@ -367,11 +367,11 @@ function! s:Run ( args )
 	if s:Makefile == ''
 		exe 'make '.cmdlinearg
 	else
-		exe 'lchdir '.fnameescape( fnamemodify( s:Makefile, ':p:h' ) )
-		"
+		exe 'cd '.fnameescape( fnamemodify( s:Makefile, ':p:h' ) )
+
 		exe 'make -f '.shellescape( s:Makefile ).' '.cmdlinearg
-		"
-		lchdir -
+
+		cd -
 	endif
 	"
 	botright cwindow

autoload/perlsupportprofiling.vim

@@ -10,7 +10,7 @@
 "       Created:  22.02.2009
 "      Revision:  27.09.2017
 "       License:  Copyright (c) 2009-2016, Fritz Mehner
-"                 Copyright (c) 2017-2017, Wolfgang Mehner
+"                 Copyright (c) 2017-2019, Wolfgang Mehner
 "===============================================================================
 "
 " Exit quickly when:
@@ -20,7 +20,7 @@
 if exists("g:loaded_perlsupportprofiling") || &compatible
   finish
 endif
-let g:loaded_perlsupportregex = "v1.0"
+let g:loaded_perlsupportprofiling = "v1.0"
 "
 let s:MSWIN = has("win16") || has("win32")   || has("win64")    || has("win95")
 let s:UNIX	= has("unix")  || has("macunix") || has("win32unix")

autoload/perlsupportregex.vim

@@ -12,7 +12,7 @@
 "       Created:  16.12.2008
 "      Revision:  27.09.2017
 "       License:  Copyright (c) 2008-2016, Fritz Mehner
-"                 Copyright (c) 2017-2017, Wolfgang Mehner
+"                 Copyright (c) 2017-2019, Wolfgang Mehner
 "===============================================================================
 "
 " Exit quickly when:
@@ -22,7 +22,7 @@
 if exists("g:loaded_perlsupportregex") || &compatible
   finish
 endif
-let g:loaded_perlsupportregex = "v1.0"
+let g:loaded_perlsupportregex = "v1.0.1"
 
 let s:MSWIN = has("win16") || has("win32")   || has("win64")    || has("win95")
 "
@@ -717,7 +717,6 @@ endfunction    " ----------  end of function perlsupportregex#Perl_RegexMatchSev
 "
 "-------------------------------------------------------------------------------
 "   read the substitution characters for \n, \t,  ... from the command line
-"   used in ftplugin/perl.vim
 "-------------------------------------------------------------------------------
 function! perlsupportregex#Perl_PerlRegexSubstitutions ( string )
   let result  = a:string

doc/perlsupport.txt

@@ -1,4 +1,4 @@
-*perlsupport.txt*                Perl Support                      Oct 02 2017
+*perlsupport.txt*                Perl Support                      Apr 21 2019
 
 Perl Support                                      *perl-support* *perlsupport*
 
@@ -860,8 +860,8 @@ For convenience consider to use maps like
 >
   noremap  <silent> <F5>    :copen<CR>
   noremap  <silent> <F6>    :cclose<CR>
-  noremap  <silent> <F7>    :cp<CR>
-  noremap  <silent> <F8>    :cn<CR>
+  noremap  <silent> <F7>    :cprevious<CR>
+  noremap  <silent> <F8>    :cnext<CR>
 <
 in your .vimrc file to jump to the error locations (F7,F8) and to open and
 close the error window (F5,F6). This makes navigation a lot easier (see also
@@ -2432,7 +2432,7 @@ was compiled for your platform. Install it and all is done.
 
 COMPILE YOUR OWN VERSION (LINUX/UNIX).
 --------------------------------------
-(1) Download the sources from http://vim.sourceforge.net/ and extract the
+(1) Download the sources from https://www.vim.org/ and extract the
 sources from the archive (for patches see|perlsupport-compile-vim-patches|).
 
 (2) Inspect the current version again. The section 'Compilation' shows how

doc/templatesupport.txt

@@ -31,9 +31,9 @@ can exist in parallel. This makes it relatively easy to write a plug-in for
 the programming language of your choice.
 
 Here is a list of high profile plug-ins which use the template support:
-- Bash-Support (www.vim.org/scripts/script.php?script_id=365)
-- C-Support (www.vim.org/scripts/script.php?script_id=213)
-- Perl-Support (www.vim.org/scripts/script.php?script_id=556)
+- Bash-Support (https://www.vim.org/scripts/script.php?script_id=365)
+- C-Support (https://www.vim.org/scripts/script.php?script_id=213)
+- Perl-Support (https://www.vim.org/scripts/script.php?script_id=556)
 
 ==============================================================================
 0.  TABLE OF CONTENTS                              *template-support-contents*
@@ -236,7 +236,7 @@ the library, are case sensitive.
 
 A template library can be organized in several files. The command: >
 	IncludeFile ( "<path>/<file>" )
-loads templates from another file (|template-support-IncludeFile|). The path
+loads templates from another file (|template-support-IncludeFile()|). The path
 is given relative to the including file. The call: >
 	IncludeFile ( "<path>/<file>", "abs" )
 interprets the path as a absolute path instead.
@@ -295,7 +295,7 @@ found in |template-support-menus|.
 ------------------------------------------------------------------------------
 
 A personalization of the template library can be achieved by using macros. The
-command 'SetMacro' (|template-support-SetMacro|) is used to set replacements
+command 'SetMacro' (|template-support-SetMacro()|) is used to set replacements
 for various macros (my settings as an example):
 >
 	SetMacro( 'AUTHOR',       'Wolfgang Mehner' )
@@ -326,7 +326,7 @@ Then the template for the file description may look as follows:
 	== ENDTEMPLATE ==
 <
 The format of the included dates and times can be set in a similar fashion,
-using 'SetFormat' (|template-support-SetFormat|):
+using 'SetFormat' (|template-support-SetFormat()|):
 >
   SetFormat( 'DATE', '%D'      )
   SetFormat( 'TIME', '%H:%M'   )
@@ -478,7 +478,7 @@ Except for using flags, the user has no further influence on the replacements
 of these macros, they can not be set via SetMacro().
 
 Dates and timestamps are inserted analogously. Their format can be set via
-SetFormat (see |template-support-SetFormat|).
+SetFormat (see |template-support-SetFormat()|).
 
   *|TIME|*     : the current time
   *|DATE|*     : the current date
@@ -1154,7 +1154,7 @@ Templates inside nested statements are only associated with the styles
 listed in the innermost "USE STYLES" statement.
 
 When files are included inside a "USE STYLES" statement (see
-|template-support-IncludeFile|), the templates inside the file are associated
+|template-support-IncludeFile()|), the templates inside the file are associated
 with the style, as they would if they appeared in the including file itself.
 The rules for nested "USE STYLES" statements also hold across included files.
 
@@ -1168,7 +1168,7 @@ directory, such the include mechanism of the C preprocessor or LaTeX's
 support offers so-called file pickers.
 
 File pickers are templates which use the command PickFile( <prompt>, <path> )
-(|template-support-PickFile|), which asks the user to interactively select a
+(|template-support-PickFile()|), which asks the user to interactively select a
 file:
 >
 	SetPath( 'global_include', '/usr/include/' )
@@ -1187,10 +1187,10 @@ beforehand, such as "global_include". After the user selects a file, several
 macros are created which can be used in the template. *|PICK|* is the path and
 name of the file, relative to the path given as the second argument.
 *|FILENAME|* is only the name of the file. For a list of all macros, see
-|template-support-PickFile|.
+|template-support-PickFile()|.
 
 Names for paths are created using the function SetPath( <name>, <path> )
-(see |template-support-SetPath|), which is a lot like SetMacro.
+(see |template-support-SetPath()|), which is a lot like SetMacro.
 
 For example, if the user picks "/usr/include/GL/gl.h", the first template
 would result in the line >
@@ -1217,7 +1217,7 @@ directory.
 
 The template support automatically creates menus for every template. The user
 has a measure of influence on the result. Some of these options were already
-explained in |templates-support-templ-maps|, this chapter will introduce further
+explained in |template-support-templ-maps|, this chapter will introduce further
 capabilities.
 
 The menu entries appear in the order the templates have been read. Including a
@@ -1326,7 +1326,7 @@ flag is 'W', the |WORD| under the cursor is picked up: >
 	|Word('W')|
 Otherwise the |word| under the cursor is picked: >
 	|Word('')|
-Lastly, the word can be picked using a regular expression (see |regex|): >
+Lastly, the word can be picked using a regular expression (see |regexp|): >
 	|Pattern( '[\\@]\w\+' )|
 This call picks a word prefix by "\" or "@", which in a C comment could be a
 Doxygen command.
@@ -3208,7 +3208,7 @@ Fritz Mehner (vim.org user name: mehner):
 Jeremy Cantrell (jmcantrell):
 - the solution for getting the visual area is take from his plug-in
   "opener.vim", which is distributed under the same licence as Vim itself
-  ( http://www.vim.org/scripts/script.php?script_id=3543 )
+  ( https://www.vim.org/scripts/script.php?script_id=3543 )
 
 Andrew L:
 - suggested to insert a breakpoint into the undo sequence before inserting

doc/toolbox.txt

@@ -20,8 +20,8 @@ exist in parallel. This makes it easy to integrate a toolbox into your
 plug-in.
 
 Here is a list of high profile plug-ins which use the toolbox support:
-- C-Support (www.vim.org/scripts/script.php?script_id=213)
-- Perl-Support (www.vim.org/scripts/script.php?script_id=556)
+- C-Support (https://www.vim.org/scripts/script.php?script_id=213)
+- Perl-Support (https://www.vim.org/scripts/script.php?script_id=556)
 
 ==============================================================================
 0.  TABLE OF CONTENTS                               *toolbox-support-contents*

doc/toolboxmake.txt

@@ -1,4 +1,4 @@
-*toolboxmake.txt*                  Make Tool                       Oct 07 2016
+*toolboxmake.txt*                  Make Tool                       Oct 16 2017
 
 Make Tool                                                       *toolbox-make*
 
@@ -178,6 +178,8 @@ A.  CHANGE LOG                                       *toolbox-make-change-log*
 
 - Change: If make is not executable, still provide the functionality for
   finding targets in a Makefile.
+- Change: Do not use :lchdir internally, switch to :cd, which has less
+  side-effects.
 
 ------------------------------------------------------------------------------
   RELEASE NOTES FOR VERSION 1.1