runtime/doc/workshop.txt

   1 *workshop.txt*  For Vim version 7.0.  Last change: 2006 Apr 24
   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
  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
  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
  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
  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
  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
  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
  58     o You should use the compiler in VWS rather than gcc.  We have neither
  59       built nor tested with gcc and cannot guarantee it will build properly.
  60
  61     o You must supply your own XPM library.  See |workshop-xpm| below for
  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
  65       Visual WorkShop.  You can easily find these by searching for the string
  66       FEAT_SUN_WORKSHOP
  67
  68     o We also suggest you use Motif for your gui.  This will provide gvim with
  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
  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
  80 symlink <VWS-install-dir>/bin/gvim to point to the vim in your newly installed
  81 directory.  The <vim-version> should be a unique version string.  I use "vim"
  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
  90 The XPM library is provide by Arnaud Le Hors of the French National Institute
  91 for Research in Computer Science and Control.  It can be downloaded from
  92 http://koala.ilog.fr/ftp/pub/xpm.  The current release, as of this writing, is
  93 xpm-3.4k-solaris.tgz, which is a gzip'ed tar file.  If you create the directory
  94 /usr/local/xpm and untar the file there you can use the uncommented lines in
  95 the Makefile without changing them.  If you use another xpm directory you will
  96 need to change the XPM_DIR in src/Makefile.
  97
  98  vim:tw=78:ts=8:ft=help:norl: