forked from vim-scripts/perl-support.vim
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README.perlsupport
275 lines (191 loc) · 11.6 KB
/
README.perlsupport
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
README for perl-support.vim (Version 5.1) / May 04 2012
* INSTALLATION
* RELEASE NOTES
* FILES
* ADDITIONAL TIPS
* CREDITS
Perl Support implements a Perl-IDE for Vim/gVim. It has been written to
considerably speed up writing code in a consistent style. This is done by
inserting complete statements, comments, idioms, code snippets, templates, and
POD documentation. Reading perldoc is integrated. Syntax checking, running a
script, running perltidy, running perlcritics, starting a debugger and a
profiler can be done with a keystroke. There are many additional hints and
options which can improve speed and comfort when writing Perl. Please read the
documentation.
This plugin can be used with Vim version 7.x . Most features should work with
Vim version 6.x.
================================================================================
INSTALLATION
================================================================================
(1) LINUX
----------------------------------------------------------------------
(if you use pathogen, most of the below is unnecessary, simply clone
this repo into your ~/.vim/bundle directory)
The subdirectories in the zip archive perl-support.zip mirror the directory
structure which is needed below the local installation directory $HOME/.vim/
(find the value of $HOME with ":echo $HOME" from inside Vim).
(1.0) Save the template files in '$HOME/.vim/perl-support/templates/Templates' if
you have changed any of them.
(1.1) Copy the zip archive perl-support.zip to $HOME/.vim and run
unzip perl-support.zip
(1.2) Loading of plugin files must be enabled. If not use
:filetype plugin on
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 in the file
'$HOME/.vim/perl-support/templates/Templates'
Here is the minimal personalization (my settings as an example):
SetMacro( 'AUTHOR', 'Dr. Fritz Mehner' )
SetMacro( 'AUTHORREF', 'fgm' )
SetMacro( 'EMAIL', 'mehner.fritz@fh-swf.de' )
SetMacro( 'ORGANIZATION','FH Südwestfalen, Iserlohn' )
SetMacro( 'COPYRIGHT', 'Copyright (c) |YEAR|, |AUTHOR|' )
(Read more about the template system in the plugin documentation)
(1.4) Make the plugin help accessable 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
are documented.
(2) WINDOWS
----------------------------------------------------------------------
The subdirectories in the zip archive perl-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).
(2.0) Save the template files in '$HOME/vimfiles/perl-support/templates/Templates'
if you have changed any of them.
(2.1) Copy the zip archive perl-support.zip to $HOME/vimfiles and run
unzip perl-support.zip
(2.2) Loading of plugin files must be enabled. If not use
:filetype plugin on
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 in the file
'$HOME/vimfiles/perl-support/templates/Templates'
Here is the minimal personalization (my settings as an example):
SetMacro( 'AUTHOR', 'Dr. Fritz Mehner' )
SetMacro( 'AUTHORREF', 'fgm' )
SetMacro( 'EMAIL', 'mehner.fritz@fh-swf.de' )
SetMacro( 'ORGANIZATION','FH Südwestfalen, Iserlohn' )
SetMacro( 'COPYRIGHT', 'Copyright (c) |YEAR|, |AUTHOR|' )
(Read more about the template system in the plugin documentation)
(2.4) Make the plugin help accessable 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
are documented.
There are a lot of features and options which can be used and influenced:
* use of template files and tags
* using and managing personal code snippets
* Perl dictionary for keyword completion
* the Perl module list
* reading Perl documentation with integrated calls to perldoc
* removing the root menu
* using additional plugins
Look at the perlsupport help with
: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'.
For a system-wide installation please see the help file 'doc/perlsupport.txt'.
=======================================================================================
RELEASE NOTES
=======================================================================================
---------------------------------------------------------------------------------------
RELEASE NOTES FOR VERSION 5.1
---------------------------------------------------------------------------------------
- New menu items: 'choose makefile' (\rcm), 'make clean' (\rmc)
- Bugfix: g:Perl_LocalTemplateFile ignored if present (thanks to Sébastien Nobili)
- Bugfix: debugger do not start in console mode
- Several internal improvements.
---------------------------------------------------------------------------------------
OLDER RELEASE NOTES : see file 'ChangeLog'
---------------------------------------------------------------------------------------
=======================================================================================
FILES
=======================================================================================
README.perlsupport This file.
autoload/perlsupportprofiling.vim Profiler support.
autoload/perlsupportregex.vim Regex analyser code.
autoload/mmtemplates/core.vim The template system.
doc/perlsupport.txt The help file for perl support.
doc/templatesupport.txt The help file for the template system.
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.
plugin/perl-support.vim The Perl plugin for Vim/gVim.
perl-support/codesnippets-perl/* Some Perl code snippets as a starting point.
perl-support/modules/ Directory for the list of installed Perl modules
perl-support/scripts/* Several helper scripts.
perl-support/templates/Templates Perl main template file
perl-support/templates/*.template Several dependent template files.
perl-support/wordlists/perl.list A file used as dictionary for automatic word completion.
This file is referenced in the file customization.vimrc.
----------------------- -------------------------------------------------------------
----------------------- The following files and extensions are for convenience only.
perl-support.vim will work without them.
-------------------------------------------------------------
perl-support/rc/customization.ctags Additional settings I use in .ctags to enable
navigation through POD with the plugin taglist.vim.
perl-support/rc/customization.gvimrc Additional settings I use in .gvimrc:
hot keys, mouse settings, ...
The file is commented. Append it to your .gvimrc
if you like.
perl-support/rc/customization.perltidyrc Additional settings I use in .perltidyrc to
customize perltidy.
perl-support/rc/customization.smallprof Additional settings I use to control the profiler
Devel::SmallProf
perl-support/rc/customization.vimrc Additional settings I use in .vimrc: incremental search,
tabstop, hot keys, font, use of dictionaries, ...
The file is commented. Append it to your .vimrc if you like.
perl-support/doc/perl-hot-keys.pdf Reference card for the key mappings.
The mappings can also be used with the non-GUI Vim,
where the menus are not available.
perl-support/doc/pmdesc3.text The man page for pmdesc3.
perl-support/doc/ChangeLog The change log.
=======================================================================================
ADDITIONAL TIPS
=======================================================================================
(1) You may want to use a central hidden directory for all your backup files (see also
rc/customization.vimrc ):
1.1 Add the following line to .vimrc (see also rc/customization.vimrc ):
set backupdir =$HOME/.vim.backupdir
1.2 Create $HOME/.vim.backupdir .
1.3 Add the following line to your shell initialization file ~/.profile :
find $HOME/.vim.backupdir/ -name "*" -type f -mtime +60 -exec rm -f {} \;
When you are logging in all files in the backup directory older then 60
days (-mtime +60) will be removed (60 days is a suggestion, of course).
Be shure to backup in shorter terms !
(2) gVim. Toggle 'insert mode' <--> 'normal mode' with the right mouse button
(see mapping in file customization.gvimrc).
(3) gVim. Use tear off menus.
(4) Try 'Focus under mouse' as window behavior (No mouse click when the mouse
pointer is back from the menu entry).
(5) Use Emulate3Buttons "on" (X11) even for a 3-button mouse. Pressing left and
right button simultaneously without moving your fingers is faster than
moving a finger to the middle button (which is often a wheel).
=======================================================================================
CREDITS
=======================================================================================
Wolfgang Mehner <wolfgang-mehner@web.de> for the implementation of the powerful
template system templatesupport.
David Fishburn <fishburn@ianywhere.com> for the implementation of the
single root menu and several suggestions for improving the customization
and the documentation.
Ryan Hennig <hennig@amazon.com> improved the install script.
Aristotle, http://qs321.pair.com/~monkads/ is the author of the script pmdesc2
which is the base of the included script pmdesc3.
David Fishburn contributed changes for the Windows platform and suggested to not let
enter snippets and templates the list of alternate files.
The two files pod-template-application.pl and pod-template-module.pl are taken from
Damian Conway's book "Perl Best Practices".
=======================================================================================