annotate runtime/doc/if_pyth.txt @ 2577:073ff46fe397

Fold Vim 7.2 default branch back to trunk to avoid two heads. (Tony Mechelynck)
author Bram Moolenaar <bram@vim.org>
date Fri, 20 Aug 2010 11:11:57 +0200
parents ee53a39d5896 733f0dc510c3
children 7d8af31066c8
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2572
ee53a39d5896 Last changes for the 7.3 release!
Bram Moolenaar <bram@vim.org>
parents: 2561
diff changeset
1 *if_pyth.txt* For Vim version 7.3. Last change: 2010 Aug 13
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4 VIM REFERENCE MANUAL by Paul Moore
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7 The Python Interface to Vim *python* *Python*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9 1. Commands |python-commands|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10 2. The vim module |python-vim|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11 3. Buffer objects |python-buffer|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12 4. Range objects |python-range|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13 5. Window objects |python-window|
557
862863033fdd updated for version 7.0158
vimboss
parents: 236
diff changeset
14 6. Dynamic loading |python-dynamic|
2340
99c1eba60b2d Make automatic prototype generation work with more interfaces.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
15 7. Python 3 |python3|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
16
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
17 {Vi does not have any of these commands}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
18
2350
06feaf4fe36a Rename some "python3" symbols to "py3", as the command name.
Bram Moolenaar <bram@vim.org>
parents: 2345
diff changeset
19 The Python 2.x interface is available only when Vim was compiled with the
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
20 |+python| feature.
2350
06feaf4fe36a Rename some "python3" symbols to "py3", as the command name.
Bram Moolenaar <bram@vim.org>
parents: 2345
diff changeset
21 The Python 3 interface is available only when Vim was compiled with the
06feaf4fe36a Rename some "python3" symbols to "py3", as the command name.
Bram Moolenaar <bram@vim.org>
parents: 2345
diff changeset
22 |+python3| feature.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
23
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
24 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
25 1. Commands *python-commands*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
26
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
27 *:python* *:py* *E205* *E263* *E264*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
28 :[range]py[thon] {stmt}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
29 Execute Python statement {stmt}.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
30
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
31 :[range]py[thon] << {endmarker}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
32 {script}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
33 {endmarker}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
34 Execute Python script {script}.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
35 Note: This command doesn't work when the Python
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
36 feature wasn't compiled in. To avoid errors, see
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
37 |script-here|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
38
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
39 {endmarker} must NOT be preceded by any white space. If {endmarker} is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
40 omitted from after the "<<", a dot '.' must be used after {script}, like
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
41 for the |:append| and |:insert| commands.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
42 This form of the |:python| command is mainly useful for including python code
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
43 in Vim scripts.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
44
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
45 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
46 function! IcecreamInitialize()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
47 python << EOF
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
48 class StrawberryIcecream:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
49 def __call__(self):
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
50 print 'EAT ME'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
51 EOF
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
52 endfunction
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
53 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
54 Note: Python is very sensitive to the indenting. Also make sure the "class"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
55 line and "EOF" do not have any indent.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
56
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
57 *:pyfile* *:pyf*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
58 :[range]pyf[ile] {file}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
59 Execute the Python script in {file}. The whole
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
60 argument is used as a single file name. {not in Vi}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
61
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
62 Both of these commands do essentially the same thing - they execute a piece of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
63 Python code, with the "current range" |python-range| set to the given line
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
64 range.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
65
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
66 In the case of :python, the code to execute is in the command-line.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
67 In the case of :pyfile, the code to execute is the contents of the given file.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
68
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
69 Python commands cannot be used in the |sandbox|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
70
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
71 To pass arguments you need to set sys.argv[] explicitly. Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
72
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
73 :python import sys
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
74 :python sys.argv = ["foo", "bar"]
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
75 :pyfile myscript.py
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
76
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
77 Here are some examples *python-examples* >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
78
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
79 :python from vim import *
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
80 :python from string import upper
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
81 :python current.line = upper(current.line)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
82 :python print "Hello"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
83 :python str = current.buffer[42]
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
84
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
85 (Note that changes - like the imports - persist from one command to the next,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
86 just like in the Python interpreter.)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
87
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
88 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
89 2. The vim module *python-vim*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
90
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
91 Python code gets all of its access to vim (with one exception - see
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 20
diff changeset
92 |python-output| below) via the "vim" module. The vim module implements two
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
93 methods, three constants, and one error object. You need to import the vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
94 module before using it: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
95 :python import vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
96
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
97 Overview >
20
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
98 :py print "Hello" # displays a message
2033
de5a43c5eedc Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 1702
diff changeset
99 :py vim.command(cmd) # execute an Ex command
20
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
100 :py w = vim.windows[n] # gets window "n"
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
101 :py cw = vim.current.window # gets the current window
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
102 :py b = vim.buffers[n] # gets buffer "n"
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
103 :py cb = vim.current.buffer # gets the current buffer
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
104 :py w.height = lines # sets the window height
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
105 :py w.cursor = (row, col) # sets the window cursor position
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
106 :py pos = w.cursor # gets a tuple (row, col)
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
107 :py name = b.name # gets the buffer file name
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
108 :py line = b[n] # gets a line from the buffer
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
109 :py lines = b[n:m] # gets a list of lines
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
110 :py num = len(b) # gets the number of lines
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
111 :py b[n] = str # sets a line in the buffer
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
112 :py b[n:m] = [str1, str2, str3] # sets a number of lines at once
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
113 :py del b[n] # deletes a line
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
114 :py del b[n:m] # deletes a number of lines
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
115
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
116
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
117 Methods of the "vim" module
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
118
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
119 vim.command(str) *python-command*
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 20
diff changeset
120 Executes the vim (ex-mode) command str. Returns None.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
121 Examples: >
20
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
122 :py vim.command("set tw=72")
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
123 :py vim.command("%s/aaa/bbb/g")
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
124 < The following definition executes Normal mode commands: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
125 def normal(str):
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
126 vim.command("normal "+str)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
127 # Note the use of single quotes to delimit a string containing
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
128 # double quotes
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
129 normal('"a2dd"aP')
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
130 < *E659*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
131 The ":python" command cannot be used recursively with Python 2.2 and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
132 older. This only works with Python 2.3 and later: >
20
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
133 :py vim.command("python print 'Hello again Python'")
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
134
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
135 vim.eval(str) *python-eval*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
136 Evaluates the expression str using the vim internal expression
633
7437be625546 updated for version 7.0183
vimboss
parents: 557
diff changeset
137 evaluator (see |expression|). Returns the expression result as:
7437be625546 updated for version 7.0183
vimboss
parents: 557
diff changeset
138 - a string if the Vim expression evaluates to a string or number
7437be625546 updated for version 7.0183
vimboss
parents: 557
diff changeset
139 - a list if the Vim expression evaluates to a Vim list
856
8cd729851562 updated for version 7.0g
vimboss
parents: 842
diff changeset
140 - a dictionary if the Vim expression evaluates to a Vim dictionary
633
7437be625546 updated for version 7.0183
vimboss
parents: 557
diff changeset
141 Dictionaries and lists are recursively expanded.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
142 Examples: >
20
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
143 :py text_width = vim.eval("&tw")
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
144 :py str = vim.eval("12+12") # NB result is a string! Use
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
145 # string.atoi() to convert to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
146 # a number.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
147
856
8cd729851562 updated for version 7.0g
vimboss
parents: 842
diff changeset
148 :py tagList = vim.eval('taglist("eval_expr")')
633
7437be625546 updated for version 7.0183
vimboss
parents: 557
diff changeset
149 < The latter will return a python list of python dicts, for instance:
7437be625546 updated for version 7.0183
vimboss
parents: 557
diff changeset
150 [{'cmd': '/^eval_expr(arg, nextcmd)$/', 'static': 0, 'name':
7437be625546 updated for version 7.0183
vimboss
parents: 557
diff changeset
151 'eval_expr', 'kind': 'f', 'filename': './src/eval.c'}]
7437be625546 updated for version 7.0183
vimboss
parents: 557
diff changeset
152
7437be625546 updated for version 7.0183
vimboss
parents: 557
diff changeset
153
7437be625546 updated for version 7.0183
vimboss
parents: 557
diff changeset
154
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
155 Error object of the "vim" module
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
156
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
157 vim.error *python-error*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
158 Upon encountering a Vim error, Python raises an exception of type
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
159 vim.error.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
160 Example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
161 try:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
162 vim.command("put a")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
163 except vim.error:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
164 # nothing in register a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
165
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
166 Constants of the "vim" module
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
167
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
168 Note that these are not actually constants - you could reassign them.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
169 But this is silly, as you would then lose access to the vim objects
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
170 to which the variables referred.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
171
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
172 vim.buffers *python-buffers*
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 20
diff changeset
173 A sequence object providing access to the list of vim buffers. The
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
174 object supports the following operations: >
20
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
175 :py b = vim.buffers[i] # Indexing (read-only)
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
176 :py b in vim.buffers # Membership test
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
177 :py n = len(vim.buffers) # Number of elements
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
178 :py for b in vim.buffers: # Sequential access
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
179 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
180 vim.windows *python-windows*
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 20
diff changeset
181 A sequence object providing access to the list of vim windows. The
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
182 object supports the following operations: >
20
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
183 :py w = vim.windows[i] # Indexing (read-only)
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
184 :py w in vim.windows # Membership test
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
185 :py n = len(vim.windows) # Number of elements
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
186 :py for w in vim.windows: # Sequential access
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
187 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
188 vim.current *python-current*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
189 An object providing access (via specific attributes) to various
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
190 "current" objects available in vim:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
191 vim.current.line The current line (RW) String
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
192 vim.current.buffer The current buffer (RO) Buffer
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
193 vim.current.window The current window (RO) Window
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
194 vim.current.range The current line range (RO) Range
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
195
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 20
diff changeset
196 The last case deserves a little explanation. When the :python or
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
197 :pyfile command specifies a range, this range of lines becomes the
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 20
diff changeset
198 "current range". A range is a bit like a buffer, but with all access
4707450c2b33 updated for version 7.0066
vimboss
parents: 20
diff changeset
199 restricted to a subset of lines. See |python-range| for more details.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
200
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
201
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
202 Output from Python *python-output*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
203 Vim displays all Python code output in the Vim message area. Normal
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
204 output appears as information messages, and error output appears as
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
205 error messages.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
206
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
207 In implementation terms, this means that all output to sys.stdout
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
208 (including the output from print statements) appears as information
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
209 messages, and all output to sys.stderr (including error tracebacks)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
210 appears as error messages.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
211
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
212 *python-input*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
213 Input (via sys.stdin, including input() and raw_input()) is not
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 20
diff changeset
214 supported, and may cause the program to crash. This should probably be
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
215 fixed.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
216
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
217 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
218 3. Buffer objects *python-buffer*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
219
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 20
diff changeset
220 Buffer objects represent vim buffers. You can obtain them in a number of ways:
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
221 - via vim.current.buffer (|python-current|)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
222 - from indexing vim.buffers (|python-buffers|)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
223 - from the "buffer" attribute of a window (|python-window|)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
224
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
225 Buffer objects have one read-only attribute - name - the full file name for
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 20
diff changeset
226 the buffer. They also have three methods (append, mark, and range; see below).
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
227
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 20
diff changeset
228 You can also treat buffer objects as sequence objects. In this context, they
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
229 act as if they were lists (yes, they are mutable) of strings, with each
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 20
diff changeset
230 element being a line of the buffer. All of the usual sequence operations,
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
231 including indexing, index assignment, slicing and slice assignment, work as
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 20
diff changeset
232 you would expect. Note that the result of indexing (slicing) a buffer is a
4707450c2b33 updated for version 7.0066
vimboss
parents: 20
diff changeset
233 string (list of strings). This has one unusual consequence - b[:] is different
4707450c2b33 updated for version 7.0066
vimboss
parents: 20
diff changeset
234 from b. In particular, "b[:] = None" deletes the whole of the buffer, whereas
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
235 "b = None" merely updates the variable b, with no effect on the buffer.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
236
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 20
diff changeset
237 Buffer indexes start at zero, as is normal in Python. This differs from vim
4707450c2b33 updated for version 7.0066
vimboss
parents: 20
diff changeset
238 line numbers, which start from 1. This is particularly relevant when dealing
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
239 with marks (see below) which use vim line numbers.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
240
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
241 The buffer object methods are:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
242 b.append(str) Append a line to the buffer
2391
f1d95a986dfb Document extra argument for Python append().
Bram Moolenaar <bram@vim.org>
parents: 2366
diff changeset
243 b.append(str, nr) Idem, below line "nr"
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
244 b.append(list) Append a list of lines to the buffer
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
245 Note that the option of supplying a list of strings to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
246 the append method differs from the equivalent method
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
247 for Python's built-in list objects.
2391
f1d95a986dfb Document extra argument for Python append().
Bram Moolenaar <bram@vim.org>
parents: 2366
diff changeset
248 b.append(list, nr) Idem, below line "nr"
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
249 b.mark(name) Return a tuple (row,col) representing the position
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
250 of the named mark (can also get the []"<> marks)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
251 b.range(s,e) Return a range object (see |python-range|) which
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
252 represents the part of the given buffer between line
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
253 numbers s and e |inclusive|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
254
20
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
255 Note that when adding a line it must not contain a line break character '\n'.
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
256 A trailing '\n' is allowed and ignored, so that you can do: >
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
257 :py b.append(f.readlines())
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
258
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
259 Examples (assume b is the current buffer) >
20
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
260 :py print b.name # write the buffer file name
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
261 :py b[0] = "hello!!!" # replace the top line
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
262 :py b[:] = None # delete the whole buffer
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
263 :py del b[:] # delete the whole buffer
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
264 :py b[0:0] = [ "a line" ] # add a line at the top
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
265 :py del b[2] # delete a line (the third)
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
266 :py b.append("bottom") # add a line at the bottom
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
267 :py n = len(b) # number of lines
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
268 :py (row,col) = b.mark('a') # named mark
4ac1dce8dd5e updated for version 7.0012
vimboss
parents: 7
diff changeset
269 :py r = b.range(1,5) # a sub-range of the buffer
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
270
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
271 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
272 4. Range objects *python-range*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
273
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 20
diff changeset
274 Range objects represent a part of a vim buffer. You can obtain them in a
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
275 number of ways:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
276 - via vim.current.range (|python-current|)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
277 - from a buffer's range() method (|python-buffer|)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
278
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 20
diff changeset
279 A range object is almost identical in operation to a buffer object. However,
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
280 all operations are restricted to the lines within the range (this line range
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
281 can, of course, change as a result of slice assignments, line deletions, or
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
282 the range.append() method).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
283
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
284 The range object attributes are:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
285 r.start Index of first line into the buffer
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
286 r.end Index of last line into the buffer
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
287
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
288 The range object methods are:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
289 r.append(str) Append a line to the range
2391
f1d95a986dfb Document extra argument for Python append().
Bram Moolenaar <bram@vim.org>
parents: 2366
diff changeset
290 r.append(str, nr) Idem, after line "nr"
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
291 r.append(list) Append a list of lines to the range
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
292 Note that the option of supplying a list of strings to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
293 the append method differs from the equivalent method
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
294 for Python's built-in list objects.
2391
f1d95a986dfb Document extra argument for Python append().
Bram Moolenaar <bram@vim.org>
parents: 2366
diff changeset
295 r.append(list, nr) Idem, after line "nr"
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
296
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
297 Example (assume r is the current range):
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
298 # Send all lines in a range to the default printer
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
299 vim.command("%d,%dhardcopy!" % (r.start+1,r.end+1))
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
300
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
301 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
302 5. Window objects *python-window*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
303
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 20
diff changeset
304 Window objects represent vim windows. You can obtain them in a number of ways:
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
305 - via vim.current.window (|python-current|)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
306 - from indexing vim.windows (|python-windows|)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
307
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 20
diff changeset
308 You can manipulate window objects only through their attributes. They have no
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
309 methods, and no sequence or other interface.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
310
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
311 Window attributes are:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
312 buffer (read-only) The buffer displayed in this window
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
313 cursor (read-write) The current cursor position in the window
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
314 This is a tuple, (row,col).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
315 height (read-write) The window height, in rows
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
316 width (read-write) The window width, in columns
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
317 The height attribute is writable only if the screen is split horizontally.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
318 The width attribute is writable only if the screen is split vertically.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
319
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
320 ==============================================================================
557
862863033fdd updated for version 7.0158
vimboss
parents: 236
diff changeset
321 6. Dynamic loading *python-dynamic*
862863033fdd updated for version 7.0158
vimboss
parents: 236
diff changeset
322
862863033fdd updated for version 7.0158
vimboss
parents: 236
diff changeset
323 On MS-Windows the Python library can be loaded dynamically. The |:version|
862863033fdd updated for version 7.0158
vimboss
parents: 236
diff changeset
324 output then includes |+python/dyn|.
862863033fdd updated for version 7.0158
vimboss
parents: 236
diff changeset
325
862863033fdd updated for version 7.0158
vimboss
parents: 236
diff changeset
326 This means that Vim will search for the Python DLL file only when needed.
862863033fdd updated for version 7.0158
vimboss
parents: 236
diff changeset
327 When you don't use the Python interface you don't need it, thus you can use
862863033fdd updated for version 7.0158
vimboss
parents: 236
diff changeset
328 Vim without this DLL file.
862863033fdd updated for version 7.0158
vimboss
parents: 236
diff changeset
329
862863033fdd updated for version 7.0158
vimboss
parents: 236
diff changeset
330 To use the Python interface the Python DLL must be in your search path. In a
862863033fdd updated for version 7.0158
vimboss
parents: 236
diff changeset
331 console window type "path" to see what directories are used.
862863033fdd updated for version 7.0158
vimboss
parents: 236
diff changeset
332
862863033fdd updated for version 7.0158
vimboss
parents: 236
diff changeset
333 The name of the DLL must match the Python version Vim was compiled with.
862863033fdd updated for version 7.0158
vimboss
parents: 236
diff changeset
334 Currently the name is "python24.dll". That is for Python 2.4. To know for
862863033fdd updated for version 7.0158
vimboss
parents: 236
diff changeset
335 sure edit "gvim.exe" and search for "python\d*.dll\c".
862863033fdd updated for version 7.0158
vimboss
parents: 236
diff changeset
336
862863033fdd updated for version 7.0158
vimboss
parents: 236
diff changeset
337 ==============================================================================
2560
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
338 7. Python 3 *python3*
2340
99c1eba60b2d Make automatic prototype generation work with more interfaces.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
339
2560
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
340 *:py3* *:python3*
2409
0ca06a92adfb Add support for horizontal scroll wheel. (Bjorn Winckler)
Bram Moolenaar <bram@vim.org>
parents: 2391
diff changeset
341 The |:py3| and |:python3| commands work similar to |:python|.
2560
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
342 *:py3file*
2409
0ca06a92adfb Add support for horizontal scroll wheel. (Bjorn Winckler)
Bram Moolenaar <bram@vim.org>
parents: 2391
diff changeset
343 The |:py3file| command works similar to |:pyfile|.
2340
99c1eba60b2d Make automatic prototype generation work with more interfaces.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
344
2409
0ca06a92adfb Add support for horizontal scroll wheel. (Bjorn Winckler)
Bram Moolenaar <bram@vim.org>
parents: 2391
diff changeset
345 Vim can be built in four ways (:version output):
2560
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
346 1. No Python support (-python, -python3)
2409
0ca06a92adfb Add support for horizontal scroll wheel. (Bjorn Winckler)
Bram Moolenaar <bram@vim.org>
parents: 2391
diff changeset
347 2. Python 2 support only (+python or +python/dyn, -python3)
0ca06a92adfb Add support for horizontal scroll wheel. (Bjorn Winckler)
Bram Moolenaar <bram@vim.org>
parents: 2391
diff changeset
348 3. Python 3 support only (-python, +python3 or +python3/dyn)
0ca06a92adfb Add support for horizontal scroll wheel. (Bjorn Winckler)
Bram Moolenaar <bram@vim.org>
parents: 2391
diff changeset
349 4. Python 2 and 3 support (+python/dyn, +python3/dyn)
2340
99c1eba60b2d Make automatic prototype generation work with more interfaces.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
350
2560
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
351 Some more details on the special case 4:
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
352
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
353 When Python 2 and Python 3 are both supported they must be loaded dynamically.
2540
9397d2d76340 Runtime file updates.
Bram Moolenaar <bram@vim.org>
parents: 2527
diff changeset
354
2560
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
355 When doing this on Linux/Unix systems and importing global symbols, this leads
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
356 to a crash when the second Python version is used. So either global symbols
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
357 are loaded but only one Python version is activated, or no global symbols are
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
358 loaded. The latter makes Python's "import" fail on libaries that expect the
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
359 symbols to be provided by Vim.
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
360 *E836* *E837*
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
361 Vim's configuration script makes a guess for all libraries based on one
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
362 standard Python library (termios). If importing this library succeeds for
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
363 both Python versions, then both will be made available in Vim at the same
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
364 time. If not, only the version first used in a session will be enabled.
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
365 When trying to use the other one you will get the E836 or E837 error message.
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
366
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
367 Here Vim's behavior depends on the system in which it was configured. In a
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
368 system where both versions of Python were configured with --enable-shared,
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
369 both versions of Python will be activated at the same time. There will still
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
370 be problems with other third party libraries that were not linked to
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
371 libPython.
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
372
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
373 To work around such problems there are these options:
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
374 1. The problematic library is recompiled to link to the according
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
375 libpython.so.
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
376 2. Vim is recompiled for only one Python version.
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
377 3. You undefine PY_NO_RTLD_GLOBAL in auto/config.h after configuration. This
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
378 may crash Vim though.
84ba6293f9d7 Preparations for 7.3f release.
Bram Moolenaar <bram@vim.org>
parents: 2554
diff changeset
379
2340
99c1eba60b2d Make automatic prototype generation work with more interfaces.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
380
99c1eba60b2d Make automatic prototype generation work with more interfaces.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
381 ==============================================================================
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
382 vim:tw=78:ts=8:ft=help:norl: