============================
	|| vim for Mandrake Linux ||
	============================



====================
| I  Vim users faq |
====================

A] vi vs vim :
==============

This is vim, a Vi IMproved.
if you just want the plain old historic vi, just install vim-minimal.
if you want the full featured vim, either install vim-minimal or vim-X11.
(Both need vim-common package).

Vim features are : multi level undo, multi windows and buffers,
syntax highlighting, command line editing, filename completion, on-line help,
visual selection, etc.. 
(See ":help vi_diff.txt" for a summary of the differences between Vim and Vi)



B] pre-configured vim :
=======================

if you want a good pre configured vim, just type :
		cp /usr/share/vim/vimrc ~/.vimrc


C] enhanced bash ala zsh :
==========================

if you want some kind of zsh like bash, just install the bash-completion
package (from contribs).


On-line help : see :help for further information


D] Tutorial (30 minutes training course for beginners) :
========================================================

You can use the vimtutor to learn your first Vim commands.  This is a
30 minute tutorial that teaches the most basic Vim functionality hands-on.

Just type :
    
	    vimtutor

This should just take the right tutorial for your current language locales.
If you want a tutorial in another language, just type :
		    vimtutor LL
where LL is the iso code for your language (eg: vimtutor fr for french users).

The list of availlable languages for tutorial can be retrieved by
looking at /usr/share/vim/tutor/ directory content.



=============================
| II Notes for im packagers |
=============================

for ease of maintenance, official upstream patches came all together
in a tarball named vim-6.1.???-patches.tar.bz2

the short description of the upstream patches we apply is in
README.upstream_patches.
most patches have a "mail context" longer explanation on top of them.


A] updating upstream patches :
==============================

1) get them from ftp.vim.org/pub/vim/patches through
		make get
   (then type "mget 6.1.???")

2) strip the mail signatures from patches:
		make strip
   (then type the echoed command with the right parameters to edit
   newly downloaded files)

3) do the tarball with "make tar N=???"
   (aka "tar cfj vim-6.1.???-patches{.tar.bz2,}")

4) update the spec file so that %official_ptchlvl reflect
   the new latest patch number


C] Stripped patches :
=====================

some patches're only related to some platforms; the unix sources don't contain
code for others platforms so we've to strip some patches

also, to reduce the patches tarball, we do make strip to remove mail sigs

Here's the list of patches we cutted some parts

- 016 is MS Windows only related
- 019 is MS Windows only related
- 023 is VMS only related
- 035 is MS Windows only related
- 044 is MS Windows only related
- 049 is Amiga only related
- 050 is just a fix for 49
- 073 is Borland C Compiler (bcc) only related
- 076 is MacOS only related
- 088 is win_build only related
- 093 is Mac/Win only related
- 146 is MS Windows only related
- 147 is MS Windows only related
- 148 is MS Windows only related
- 149 is MS Windows only related
- 150 is is OS/2, MS Windows and MS-DOS only related
- 151 is Win32 only related
- 154 is dos only related
- 190 is partially vms only related
- 198 is partially mac only related
- 202 is MS Windows only related
- 221 is partially other oses only related
- 221 is partially other oses only related
- 223 is partially MS Windows only related
- 228 is MS Windows only related
- 230 is MS Windows only related
- 238 is partially MS Windows only related
- 240 is bcc/MS Windows only related
- 243 is MS Windows only related
- 253 is cygwin only related
- 253 is mac os only related
- 289 is window only related
- 290 is window only related
- 291 is window only related
- 300 is window only related