Mercurial > vim
annotate runtime/doc/workshop.txt @ 5146:6ec6b7ff2d43 v7.4a
Vim 7.4a BETA release.
| author | Bram Moolenaar <bram@vim.org> |
|---|---|
| date | Sat, 06 Jul 2013 15:44:11 +0200 |
| parents | 073ff46fe397 |
| children | 09c88160095d |
| rev | line source |
|---|---|
| 5146 | 1 *workshop.txt* For Vim version 7.4a. Last change: 2013 Jul 06 |
| 7 | 2 |
| 3 | |
| 4 VIM REFERENCE MANUAL by Gordon Prieur | |
| 5 | |
| 6 | |
| 7 Sun Visual WorkShop Features *workshop* *workshop-support* | |
| 8 | |
| 9 1. Introduction |workshop-intro| | |
| 10 2. Commands |workshop-commands| | |
| 11 3. Compiling vim/gvim for WorkShop |workshop-compiling| | |
| 12 4. Configuring gvim for a WorkShop release tree |workshop-configure| | |
| 13 5. Obtaining the latest version of the XPM library |workshop-xpm| | |
| 14 | |
| 15 {Vi does not have any of these features} | |
| 16 {only available when compiled with the |+sun_workshop| feature} | |
| 17 | |
| 18 ============================================================================== | |
| 19 1. Introduction *workshop-intro* | |
| 20 | |
| 21 Sun Visual WorkShop has an "Editor of Choice" feature designed to let users | |
| 237 | 22 debug using their favorite editors. For the 6.0 release we have added support |
| 23 for gvim. A workshop debug session will have a debugging window and an editor | |
| 24 window (possibly others as well). The user can do many debugging operations | |
| 7 | 25 from the editor window, minimizing the need to switch from window to window. |
| 26 | |
| 27 The version of vim shipped with Sun Visual WorkShop 6 (also called Forte | |
| 237 | 28 Developer 6) is vim 5.3. The features in this release are much more reliable |
| 29 than the vim/gvim shipped with Visual WorkShop. VWS users wishing to use vim | |
| 7 | 30 as their editor should compile these sources and install them in their |
| 31 workshop release tree. | |
| 32 | |
| 33 ============================================================================== | |
| 34 2. Commands *workshop-commands* | |
| 35 | |
| 36 *:ws* *:wsverb* | |
| 37 :ws[verb] verb Pass the verb to the verb executor | |
| 38 | |
| 39 Pass the verb to a workshop function which gathers some arguments and | |
| 40 sends the verb and data to workshop over an IPC connection. | |
| 41 | |
| 42 ============================================================================== | |
| 43 3. Compiling vim/gvim for WorkShop *workshop-compiling* | |
| 44 | |
| 45 Compiling vim with FEAT_SUN_WORKSHOP turns on all compile time flags necessary | |
| 237 | 46 for building a vim to work with Visual WorkShop. The features required for VWS |
| 47 have been built and tested using the Sun compilers from the VWS release. They | |
| 48 have not been built or tested using Gnu compilers. This does not mean the | |
| 7 | 49 features won't build and run if compiled with gcc, just that nothing is |
| 50 guaranteed with gcc! | |
| 51 | |
| 52 ============================================================================== | |
| 53 4. Configuring gvim for a WorkShop release tree *workshop-configure* | |
| 54 | |
| 55 There are several assumptions which must be met in order to compile a gvim for | |
| 56 use with Sun Visual WorkShop 6. | |
| 57 | |
| 237 | 58 o You should use the compiler in VWS rather than gcc. We have neither |
| 7 | 59 built nor tested with gcc and cannot guarantee it will build properly. |
| 60 | |
| 237 | 61 o You must supply your own XPM library. See |workshop-xpm| below for |
| 7 | 62 details on obtaining the latest version of XPM. |
| 63 | |
| 64 o Edit the Makefile in the src directory and uncomment the lines for Sun | |
| 237 | 65 Visual WorkShop. You can easily find these by searching for the string |
| 7 | 66 FEAT_SUN_WORKSHOP |
| 67 | |
| 237 | 68 o We also suggest you use Motif for your gui. This will provide gvim with |
| 7 | 69 the same look-and-feel as the rest of Sun Visual WorkShop. |
| 70 | |
| 71 The following configuration line can be used to configure vim to build for use | |
| 72 with Sun Visual WorkShop: | |
| 73 | |
| 74 $ CC=cc configure --enable-workshop --enable-gui=motif \ | |
| 75 -prefix=<VWS-install-dir>/contrib/contrib6/<vim-version> | |
| 76 | |
| 77 The VWS-install-dir should be the base directory where your Sun Visual WorkShop | |
| 237 | 78 was installed. By default this is /opt/SUNWspro. It will normally require |
| 79 root permissions to install the vim release. You will also need to change the | |
| 7 | 80 symlink <VWS-install-dir>/bin/gvim to point to the vim in your newly installed |
| 237 | 81 directory. The <vim-version> should be a unique version string. I use "vim" |
| 7 | 82 concatenated with the equivalent of version.h's VIM_VERSION_SHORT. |
| 83 | |
| 84 ============================================================================== | |
| 85 5. Obtaining the latest version of the XPM library *workshop-xpm* | |
| 86 | |
| 87 The XPM library is required to show images within Vim with Motif or Athena. | |
| 88 Without it the toolbar and signs will be disabled. | |
| 89 | |
|
2283
7e1bd501306d
Mainly documentation updates.
Bram Moolenaar <bram@vim.org>
parents:
2236
diff
changeset
|
90 The XPM library is provided by Arnaud Le Hors of the French National Institute |
| 237 | 91 for Research in Computer Science and Control. It can be downloaded from |
|
2236
dc2e5ec0500d
Added the undofile() function. Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents:
2154
diff
changeset
|
92 http://cgit.freedesktop.org/xorg/lib/libXpm. The current release, as of this |
|
dc2e5ec0500d
Added the undofile() function. Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents:
2154
diff
changeset
|
93 writing, is xpm-3.4k-solaris.tgz, which is a gzip'ed tar file. If you create |
|
dc2e5ec0500d
Added the undofile() function. Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents:
2154
diff
changeset
|
94 the directory /usr/local/xpm and untar the file there you can use the |
|
dc2e5ec0500d
Added the undofile() function. Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents:
2154
diff
changeset
|
95 uncommented lines in the Makefile without changing them. If you use another |
|
dc2e5ec0500d
Added the undofile() function. Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents:
2154
diff
changeset
|
96 xpm directory you will need to change the XPM_DIR in src/Makefile. |
| 7 | 97 |
| 98 vim:tw=78:ts=8:ft=help:norl: |