1*os_mac.txt*    For Vim version 7.3.  Last change: 2006 Apr 30
2
3
4		  VIM REFERENCE MANUAL    by Bram Moolenaar et al.
5
6
7					*mac* *Mac* *macintosh* *Macintosh*
8
9This file documents the particularities of the Macintosh version of Vim.
10
11NOTE: This file is a bit outdated.  You might find more useful info here:
12	http://macvim.org/
13
141. Filename Convention		|mac-filename|
152. .vimrc an .vim files		|mac-vimfile|
163. FAQ				|mac-faq|
174. Known Lack			|mac-lack|
185. Mac Bug Report		|mac-bug|
196. Compiling Vim		|mac-compile|
20
21There was a Mac port for version 3.0 of Vim.  Here are the first few lines
22from the old file:
23
24VIM Release Notes
25Initial Macintosh release, VIM version 3.0
2619 October 1994
27
28Eric Fischer
29<enf1@midway.uchicago.edu>, <eric@jcp.uchicago.edu>, <etaoin@uchicago.edu>
305759 N. Guilford Ave
31Indianapolis IN 46220 USA
32
33==============================================================================
341. Filename Convention					*mac-filename*
35
36Starting with Vim version 7 you can just use the unix path separators with
37Vim. In order to determine if the specified filename is relative to the
38current folder or absolute (i.e. relative to the "Desktop"), the following
39algorithm is used:
40
41	If the path start by a "/", the path is absolute
42	If the path start by a ":", the path is relative
43	If the path doesn't start by neither a "/" nor ":",
44	  and a ":" is found before a "/" then the path is absolute
45>
46		:e /HD/text
47		:e HD:text
48<	Edit the file "text" of the disk "HD" >
49		:e :src:main.c
50		:e src/main.c
51<	Edit the file "main.c" in the folder "src" in the current folder >
52		:e os_mac.c
53<	Edit the file "os_mac.c" in the current folder.
54
55You can use the |$VIM| and |$VIMRUNTIME|  variable. >
56
57		:so $VIMRUNTIME:syntax:syntax.vim
58
59==============================================================================
602. .vimrc and .vim files				*mac-vimfile*
61
62It is recommended to use Unix style line separators for Vim scripts, thus a
63single newline character.
64
65When starting up Vim will load the $VIMRUNTIME/macmap.vim script to define
66default command-key mappings.
67
68On older systems files starting with a dot "." are discouraged, thus the rc
69files are named "vimrc" or "_vimrc" and "gvimrc" or "_gvimrc".  These files
70can be in any format (mac, dos or unix).  Vim can handle any file format when
71the |'nocompatible'| option is set, otherwise it will only handle mac format
72files.
73
74==============================================================================
753. Mac FAQ						*mac-faq*
76
77On the internet:  http://macvim.org/OSX/index.php#FAQ
78
79Q: I can't enter non-ASCII character in Apple Terminal.
80A: Under Window Settings, Emulation, make sure that "Escape non-ASCII
81   characters" is not checked.
82
83Q: How do I start the GUI from the command line?
84A: Assuming that Vim.app is located in /Applications:
85	open /Applications/Vim.app
86   Or:
87	/Applications/Vim.app/Contents/MacOS/Vim -g  {arguments}
88
89Q: How can I set $PATH to something reasonable when I start Vim.app from the
90   GUI or with open?
91A: The following trick works with most shells.  Put it in your vimrc file.
92   This is included in the system vimrc file included with the binaries
93   distributed at macvim.org . >
94	let s:path = system("echo echo VIMPATH'${PATH}' | $SHELL -l")
95	let $PATH = matchstr(s:path, 'VIMPATH\zs.\{-}\ze\n')
96
97==============================================================================
984. Mac Lack						*mac-lack*
99
100In a terminal CTRL-^ needs to be entered as Shift-Control-6.  CTRL-@ as
101Shift-Control-2.
102
103==============================================================================
1045. Mac Bug Report					*mac-bug*
105
106When reporting any Mac specific bug or feature change, please use the vim-mac
107maillist |vim-mac|.  However, you need to be subscribed.  An alternative is to
108send a message to the current MacVim maintainers:
109
110	mac@vim.org
111
112==============================================================================
1136. Compiling Vim					*mac-compile*
114
115See the file "src/INSTALLmac.txt" that comes with the source files.
116
117
118 vim:tw=78:ts=8:ft=help:norl:
119