annotate runtime/doc/if_mzsch.txt @ 13592:a64485061f75 v8.0.1668

patch 8.0.1668: terminal debugger: can't re-open source code window commit https://github.com/vim/vim/commit/c4b533e1e93151658cb170c6796d327a8c0f8612 Author: Bram Moolenaar <Bram@vim.org> Date: Fri Apr 6 22:26:25 2018 +0200 patch 8.0.1668: terminal debugger: can't re-open source code window Problem: Terminal debugger: can't re-open source code window. Solution: Add the :Source command. Also create the window if needed when gdb stops at a source line.
author Christian Brabandt <cb@256bit.org>
date Fri, 06 Apr 2018 22:30:07 +0200
parents b390f5003e2f
children 1174611ad715
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
12608
b390f5003e2f patch 8.0.1182: cannot see or change mzscheme dll name
Christian Brabandt <cb@256bit.org>
parents: 10942
diff changeset
1 *if_mzsch.txt* For Vim version 8.0. Last change: 2017 Oct 08
14
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
2
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
3
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
4 VIM REFERENCE MANUAL by Sergey Khorev
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
5
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
6
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
7 The MzScheme Interface to Vim *mzscheme* *MzScheme*
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
8
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
9 1. Commands |mzscheme-commands|
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
10 2. Examples |mzscheme-examples|
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
11 3. Threads |mzscheme-threads|
2050
afcf9db31561 updated for version 7.2.336
Bram Moolenaar <bram@zimbu.org>
parents: 1919
diff changeset
12 4. Vim access from MzScheme |mzscheme-vim|
afcf9db31561 updated for version 7.2.336
Bram Moolenaar <bram@zimbu.org>
parents: 1919
diff changeset
13 5. mzeval() Vim function |mzscheme-mzeval|
4074
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
14 6. Using Function references |mzscheme-funcref|
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
15 7. Dynamic loading |mzscheme-dynamic|
7609
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 5294
diff changeset
16 8. MzScheme setup |mzscheme-setup|
14
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
17
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
18 {Vi does not have any of these commands}
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
19
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
20 The MzScheme interface is available only if Vim was compiled with the
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
21 |+mzscheme| feature.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
22
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
23 Based on the work of Brent Fulgham.
128
8def260d486d updated for version 7.0044
vimboss
parents: 26
diff changeset
24 Dynamic loading added by Sergey Khorev
14
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
25
4074
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
26 MzScheme and PLT Scheme names have been rebranded as Racket. For more
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
27 information please check http://racket-lang.org
14
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
28
4074
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
29 Futures and places of Racket version 5.x up to and including 5.3.1 do not
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
30 work correctly with processes created by Vim.
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
31 The simplest solution is to build Racket on your own with these features
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
32 disabled: >
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
33 ./configure --disable-futures --disable-places --prefix=your-install-prefix
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
34
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
35 To speed up the process, you might also want to use --disable-gracket and
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
36 --disable-docs
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
37
14
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
38 ==============================================================================
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
39 1. Commands *mzscheme-commands*
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
40
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
41 *:mzscheme* *:mz*
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
42 :[range]mz[scheme] {stmt}
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
43 Execute MzScheme statement {stmt}. {not in Vi}
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
44
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
45 :[range]mz[scheme] << {endmarker}
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
46 {script}
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
47 {endmarker}
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
48 Execute inlined MzScheme script {script}.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
49 Note: This command doesn't work if the MzScheme
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
50 feature wasn't compiled in. To avoid errors, see
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
51 |script-here|.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
52
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
53 *:mzfile* *:mzf*
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
54 :[range]mzf[ile] {file} Execute the MzScheme script in {file}. {not in Vi}
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
55
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
56 All of these commands do essentially the same thing - they execute a piece of
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
57 MzScheme code, with the "current range" set to the given line
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
58 range.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
59
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
60 In the case of :mzscheme, the code to execute is in the command-line.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
61 In the case of :mzfile, the code to execute is the contents of the given file.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
62
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
63 MzScheme interface defines exception exn:vim, derived from exn.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
64 It is raised for various Vim errors.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
65
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
66 During compilation, the MzScheme interface will remember the current MzScheme
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
67 collection path. If you want to specify additional paths use the
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
68 'current-library-collection-paths' parameter. E.g., to cons the user-local
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
69 MzScheme collection path: >
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
70 :mz << EOF
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
71 (current-library-collection-paths
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
72 (cons
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
73 (build-path (find-system-path 'addon-dir) (version) "collects")
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
74 (current-library-collection-paths)))
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
75 EOF
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
76 <
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
77
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
78 All functionality is provided through module vimext.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
79
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
80 The exn:vim is available without explicit import.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
81
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
82 To avoid clashes with MzScheme, consider using prefix when requiring module,
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
83 e.g.: >
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
84 :mzscheme (require (prefix vim- vimext))
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
85 <
1894
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
86 All the examples below assume this naming scheme.
14
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
87
273
2463194c8cdd updated for version 7.0073
vimboss
parents: 128
diff changeset
88 *mzscheme-sandbox*
2463194c8cdd updated for version 7.0073
vimboss
parents: 128
diff changeset
89 When executed in the |sandbox|, access to some filesystem and Vim interface
2463194c8cdd updated for version 7.0073
vimboss
parents: 128
diff changeset
90 procedures is restricted.
14
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
91
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
92 ==============================================================================
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
93 2. Examples *mzscheme-examples*
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
94 >
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
95 :mzscheme (display "Hello")
1894
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
96 :mz (display (string-append "Using MzScheme version " (version)))
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
97 :mzscheme (require (prefix vim- vimext)) ; for MzScheme < 4.x
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
98 :mzscheme (require (prefix-in vim- 'vimext)) ; MzScheme 4.x
14
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
99 :mzscheme (vim-set-buff-line 10 "This is line #10")
10153
715d6c5707b8 commit https://github.com/vim/vim/commit/abd468ed0fbcba391e7833feeaa7de3ced841455
Christian Brabandt <cb@256bit.org>
parents: 7742
diff changeset
100
715d6c5707b8 commit https://github.com/vim/vim/commit/abd468ed0fbcba391e7833feeaa7de3ced841455
Christian Brabandt <cb@256bit.org>
parents: 7742
diff changeset
101 To see what version of MzScheme you have: >
715d6c5707b8 commit https://github.com/vim/vim/commit/abd468ed0fbcba391e7833feeaa7de3ced841455
Christian Brabandt <cb@256bit.org>
parents: 7742
diff changeset
102 :mzscheme (display (version))
14
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
103 <
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
104 Inline script usage: >
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
105 function! <SID>SetFirstLine()
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
106 :mz << EOF
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
107 (display "!!!")
1894
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
108 (require (prefix vim- vimext))
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
109 ; for newer versions (require (prefix-in vim- 'vimext))
14
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
110 (vim-set-buff-line 1 "This is line #1")
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
111 (vim-beep)
1894
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
112 EOF
14
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
113 endfunction
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
114
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
115 nmap <F9> :call <SID>SetFirstLine() <CR>
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
116 <
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
117 File execution: >
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
118 :mzfile supascript.scm
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
119 <
1894
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
120 Vim exception handling: >
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
121 :mz << EOF
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
122 (require (prefix vim- vimext))
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
123 ; for newer versions (require (prefix-in vim- 'vimext))
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
124 (with-handlers
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
125 ([exn:vim? (lambda (e) (display (exn-message e)))])
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
126 (vim-eval "nonsense-string"))
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
127 EOF
14
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
128 <
1894
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
129 Auto-instantiation of vimext module (can be placed in your |vimrc|): >
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
130 function! MzRequire()
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
131 :redir => l:mzversion
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
132 :mz (version)
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
133 :redir END
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
134 if strpart(l:mzversion, 1, 1) < "4"
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
135 " MzScheme versions < 4.x:
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
136 :mz (require (prefix vim- vimext))
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
137 else
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
138 " newer versions:
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
139 :mz (require (prefix-in vim- 'vimext))
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
140 endif
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
141 endfunction
14
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
142
1894
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
143 if has("mzscheme")
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
144 silent call MzRequire()
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
145 endif
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
146 <
14
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
147 ==============================================================================
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
148 3. Threads *mzscheme-threads*
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
149
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
150 The MzScheme interface supports threads. They are independent from OS threads,
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
151 thus scheduling is required. The option 'mzquantum' determines how often
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
152 Vim should poll for available MzScheme threads.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
153 NOTE
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
154 Thread scheduling in the console version of Vim is less reliable than in the
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
155 GUI version.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
156
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
157 ==============================================================================
2050
afcf9db31561 updated for version 7.2.336
Bram Moolenaar <bram@zimbu.org>
parents: 1919
diff changeset
158 4. Vim access from MzScheme *mzscheme-vim*
14
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
159
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
160 *mzscheme-vimext*
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
161 The 'vimext' module provides access to procedures defined in the MzScheme
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
162 interface.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
163
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
164 Common
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
165 ------
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
166 (command {command-string}) Perform the vim ":Ex" style command.
1894
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
167 (eval {expr-string}) Evaluate the vim expression into
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
168 respective MzScheme object: |Lists| are
afb740b5dfab updated for version 7.2-191
vimboss
parents: 1702
diff changeset
169 represented as Scheme lists,
4074
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
170 |Dictionaries| as hash tables,
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
171 |Funcref|s as functions (see also
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
172 |mzscheme-funcref|)
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
173 NOTE the name clashes with MzScheme eval,
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
174 use module qualifiers to overcome this.
14
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
175 (range-start) Start/End of the range passed with
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
176 (range-end) the Scheme command.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
177 (beep) beep
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
178 (get-option {option-name} [buffer-or-window]) Get Vim option value (either
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
179 local or global, see set-option).
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
180 (set-option {string} [buffer-or-window])
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
181 Set a Vim option. String must have option
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
182 setting form (like optname=optval, or
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
183 optname+=optval, etc.) When called with
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
184 {buffer} or {window} the local option will
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
185 be set. The symbol 'global can be passed
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
186 as {buffer-or-window}. Then |:setglobal|
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
187 will be used.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
188
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
189 Buffers *mzscheme-buffer*
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
190 -------
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
191 (buff? {object}) Is object a buffer?
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
192 (buff-valid? {object}) Is object a valid buffer? (i.e.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
193 corresponds to the real Vim buffer)
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
194 (get-buff-line {linenr} [buffer])
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
195 Get line from a buffer.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
196 (set-buff-line {linenr} {string} [buffer])
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
197 Set a line in a buffer. If {string} is #f,
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
198 the line gets deleted. The [buffer]
856
8cd729851562 updated for version 7.0g
vimboss
parents: 842
diff changeset
199 argument is optional. If omitted, the
8cd729851562 updated for version 7.0g
vimboss
parents: 842
diff changeset
200 current buffer will be used.
14
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
201 (get-buff-line-list {start} {end} [buffer])
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
202 Get a list of lines in a buffer. {Start}
2098
3259c3923c1e Updated runtime an documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 2050
diff changeset
203 and {end} are 1-based and inclusive.
14
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
204 (set-buff-line-list {start} {end} {string-list} [buffer])
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
205 Set a list of lines in a buffer. If
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
206 string-list is #f or null, the lines get
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
207 deleted. If a list is shorter than
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
208 {end}-{start} the remaining lines will
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
209 be deleted.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
210 (get-buff-name [buffer]) Get a buffer's text name.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
211 (get-buff-num [buffer]) Get a buffer's number.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
212 (get-buff-size [buffer]) Get buffer line count.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
213 (insert-buff-line-list {linenr} {string/string-list} [buffer])
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
214 Insert a list of lines into a buffer after
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
215 {linenr}. If {linenr} is 0, lines will be
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
216 inserted at start.
2098
3259c3923c1e Updated runtime an documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 2050
diff changeset
217 (curr-buff) Get the current buffer. Use other MzScheme
3259c3923c1e Updated runtime an documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 2050
diff changeset
218 interface procedures to change it.
14
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
219 (buff-count) Get count of total buffers in the editor.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
220 (get-next-buff [buffer]) Get next buffer.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
221 (get-prev-buff [buffer]) Get previous buffer. Return #f when there
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
222 are no more buffers.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
223 (open-buff {filename}) Open a new buffer (for file "name")
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
224 (get-buff-by-name {buffername}) Get a buffer by its filename or #f
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
225 if there is no such buffer.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
226 (get-buff-by-num {buffernum}) Get a buffer by its number (return #f if
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
227 there is no buffer with this number).
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
228
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
229 Windows *mzscheme-window*
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
230 ------
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
231 (win? {object}) Is object a window?
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
232 (win-valid? {object}) Is object a valid window (i.e. corresponds
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
233 to the real Vim window)?
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
234 (curr-win) Get the current window.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
235 (win-count) Get count of windows.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
236 (get-win-num [window]) Get window number.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
237 (get-win-by-num {windownum}) Get window by its number.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
238 (get-win-buffer [window]) Get the buffer for a given window.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
239 (get-win-height [window])
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
240 (set-win-height {height} [window]) Get/Set height of window.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
241 (get-win-width [window])
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
242 (set-win-width {width} [window])Get/Set width of window.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
243 (get-win-list [buffer]) Get list of windows for a buffer.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
244 (get-cursor [window]) Get cursor position in a window as
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
245 a pair (linenr . column).
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
246 (set-cursor (line . col) [window]) Set cursor position.
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
247
625
81fe2ccc1207 updated for version 7.0179
vimboss
parents: 273
diff changeset
248 ==============================================================================
2050
afcf9db31561 updated for version 7.2.336
Bram Moolenaar <bram@zimbu.org>
parents: 1919
diff changeset
249 5. mzeval() Vim function *mzscheme-mzeval*
afcf9db31561 updated for version 7.2.336
Bram Moolenaar <bram@zimbu.org>
parents: 1919
diff changeset
250
2249
6d3d35ff2c2b Use full path in undofile(). Updated docs.
Bram Moolenaar <bram@vim.org>
parents: 2154
diff changeset
251 To facilitate bi-directional interface, you can use |mzeval()| function to
10942
e05695e59f6d patch 8.0.0360: sometimes VimL is used instead of "Vim script"
Christian Brabandt <cb@256bit.org>
parents: 10198
diff changeset
252 evaluate MzScheme expressions and pass their values to Vim script.
2050
afcf9db31561 updated for version 7.2.336
Bram Moolenaar <bram@zimbu.org>
parents: 1919
diff changeset
253
afcf9db31561 updated for version 7.2.336
Bram Moolenaar <bram@zimbu.org>
parents: 1919
diff changeset
254 ==============================================================================
4074
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
255 6. Using Function references *mzscheme-funcref*
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
256
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
257 MzScheme interface allows use of |Funcref|s so you can call Vim functions
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
258 directly from Scheme. For instance: >
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
259 function! MyAdd2(arg)
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
260 return a:arg + 2
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
261 endfunction
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
262 mz (define f2 (vim-eval "function(\"MyAdd2\")"))
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
263 mz (f2 7)
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
264 < or : >
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
265 :mz (define indent (vim-eval "function('indent')"))
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
266 " return Vim indent for line 12
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
267 :mz (indent 12)
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
268 <
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
269
16e8a09e8ab0 updated for version 7.3.791
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
270 ==============================================================================
7742
5f6f35a3cb12 commit https://github.com/vim/vim/commit/705ada1aff27ecd9c47c690df817d043c2ceb5e2
Christian Brabandt <cb@256bit.org>
parents: 7659
diff changeset
271 7. Dynamic loading *mzscheme-dynamic* *E815*
625
81fe2ccc1207 updated for version 7.0179
vimboss
parents: 273
diff changeset
272
81fe2ccc1207 updated for version 7.0179
vimboss
parents: 273
diff changeset
273 On MS-Windows the MzScheme libraries can be loaded dynamically. The |:version|
81fe2ccc1207 updated for version 7.0179
vimboss
parents: 273
diff changeset
274 output then includes |+mzscheme/dyn|.
81fe2ccc1207 updated for version 7.0179
vimboss
parents: 273
diff changeset
275
81fe2ccc1207 updated for version 7.0179
vimboss
parents: 273
diff changeset
276 This means that Vim will search for the MzScheme DLL files only when needed.
81fe2ccc1207 updated for version 7.0179
vimboss
parents: 273
diff changeset
277 When you don't use the MzScheme interface you don't need them, thus you can
81fe2ccc1207 updated for version 7.0179
vimboss
parents: 273
diff changeset
278 use Vim without these DLL files.
7609
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 5294
diff changeset
279 NOTE: Newer version of MzScheme (Racket) require earlier (trampolined)
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 5294
diff changeset
280 initialisation via scheme_main_setup. So Vim always loads the MzScheme DLL at
12608
b390f5003e2f patch 8.0.1182: cannot see or change mzscheme dll name
Christian Brabandt <cb@256bit.org>
parents: 10942
diff changeset
281 startup if possible. This may make Vim startup slower.
625
81fe2ccc1207 updated for version 7.0179
vimboss
parents: 273
diff changeset
282
81fe2ccc1207 updated for version 7.0179
vimboss
parents: 273
diff changeset
283 To use the MzScheme interface the MzScheme DLLs must be in your search path.
81fe2ccc1207 updated for version 7.0179
vimboss
parents: 273
diff changeset
284 In a console window type "path" to see what directories are used.
81fe2ccc1207 updated for version 7.0179
vimboss
parents: 273
diff changeset
285
12608
b390f5003e2f patch 8.0.1182: cannot see or change mzscheme dll name
Christian Brabandt <cb@256bit.org>
parents: 10942
diff changeset
286 On MS-Windows the options 'mzschemedll' and 'mzschemegcdll' are used for the
b390f5003e2f patch 8.0.1182: cannot see or change mzscheme dll name
Christian Brabandt <cb@256bit.org>
parents: 10942
diff changeset
287 name of the library to load. The initial value is specified at build time.
b390f5003e2f patch 8.0.1182: cannot see or change mzscheme dll name
Christian Brabandt <cb@256bit.org>
parents: 10942
diff changeset
288
b390f5003e2f patch 8.0.1182: cannot see or change mzscheme dll name
Christian Brabandt <cb@256bit.org>
parents: 10942
diff changeset
289 The version of the DLL must match the MzScheme version Vim was compiled with.
625
81fe2ccc1207 updated for version 7.0179
vimboss
parents: 273
diff changeset
290 For MzScheme version 209 they will be "libmzsch209_000.dll" and
1121
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
291 "libmzgc209_000.dll". To know for sure look at the output of the ":version"
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
292 command, look for -DDYNAMIC_MZSCH_DLL="something" and
e63691e7c504 updated for version 7.1a
vimboss
parents: 874
diff changeset
293 -DDYNAMIC_MZGC_DLL="something" in the "Compilation" info.
625
81fe2ccc1207 updated for version 7.0179
vimboss
parents: 273
diff changeset
294
7609
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 5294
diff changeset
295 For example, if MzScheme (Racket) is installed at C:\Racket63, you may need
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 5294
diff changeset
296 to set the environment variable as the following: >
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 5294
diff changeset
297
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 5294
diff changeset
298 PATH=%PATH%;C:\Racket63\lib
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 5294
diff changeset
299 PLTCOLLECTS=C:\Racket63\collects
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 5294
diff changeset
300 PLTCONFIGDIR=C:\Racket63\etc
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 5294
diff changeset
301 <
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 5294
diff changeset
302 ==============================================================================
7742
5f6f35a3cb12 commit https://github.com/vim/vim/commit/705ada1aff27ecd9c47c690df817d043c2ceb5e2
Christian Brabandt <cb@256bit.org>
parents: 7659
diff changeset
303 8. MzScheme setup *mzscheme-setup* *E895*
7609
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 5294
diff changeset
304
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 5294
diff changeset
305 Vim requires "racket/base" module for if_mzsch core (fallback to "scheme/base"
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 5294
diff changeset
306 if it doesn't exist), "r5rs" module for test and "raco ctool" command for
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 5294
diff changeset
307 building Vim. If MzScheme did not have them, you can install them with
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 5294
diff changeset
308 MzScheme's raco command:
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 5294
diff changeset
309 >
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 5294
diff changeset
310 raco pkg install scheme-lib # scheme/base module
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 5294
diff changeset
311 raco pkg install r5rs-lib # r5rs module
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 5294
diff changeset
312 raco pkg install cext-lib # raco ctool command
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 5294
diff changeset
313 <
14
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
314 ======================================================================
946da5994c01 updated for version 7.0006
vimboss
parents:
diff changeset
315 vim:tw=78:ts=8:sts=4:ft=help:norl: