Update mvim script document

Author: splhack

runtime/doc/gui_mac.txt

@@ -158,55 +158,36 @@ have files open in e.g. splits by changing the "Open files from applications"
 option in the General preference pane).  Finally, you can use Mac OS X System
 Services to open files in MacVim, see |macvim-services|.
 
-There are essentially two ways to start MacVim from Terminal: either call the
-Vim binary with the -g switch >
-	/Applications/MacVim.app/Contents/MacOS/Vim -g file ...
-or use the "open" command (this method can not be used to pass parameters to
+Use |mvim| script to start MacVim from Terminal.
+
+Or use the "open" command (this method can not be used to pass parameters to
 Vim) >
 	open -a MacVim file ...
 The advantage of using the latter method is that the settings relating to file
 opening in the preferences panel are respected, and files open instantly if
 |Quickstart| is enabled.
 
-To save yourself from having to type the entire path to the Vim binary each
-time you start MacVim, you could create an alias such as >
-	alias gvim='/Applications/MacVim.app/Contents/MacOS/Vim -g'
-and add that to "~/.profile".
-
-Note: Do NOT call the MacVim binary inside the app bundle to start MacVim.
-
-							*mvim*
-A more flexible way to start MacVim is to use the shell script "mvim" which
-comes bundled with MacVim.  Put this script in a folder in your path and then
-simply type "mvim" to start MacVim.  This script will try to find MacVim.app
-in various typical folders such as >
-	~/Applications              ~/Applications/vim
-	/Applications               /Applications/vim
-	/Applications/Utilities     /Applications/Utilities/vim
-If you would rather put MacVim.app in some other directory then that is also
-possible, simply set the environment variable VIM_APP_DIR to whatever folder
-you have placed MacVim.app in.
-
-The "mvim" script can be symlinked to in order to start up MacVim in different
-modes as follows (assuming you placed "mvim" in "/usr/local/bin"): >
-	* Diff:		ln -s /usr/local/bin/mvim mvimdiff
-	* Read-only:	ln -s /usr/local/bin/mvim mview
-	* Ex:		ln -s /usr/local/bin/mvim mex
-	* Restricted:	ln -s /usr/local/bin/mvim rmvim
-If the symlink destination starts with "m" (or "g"), Vim will start in GUI
-mode.  Removing the initial "m" from the above destination names makes Vim
-start without the GUI.  (In the last case, the destination name can be
-"rmvim", "rgvim" or "rvim".)
-
-Note: Starting MacVim by creating a symlink to >
-	.../MacVim.app/Contents/MacOS/Vim
-with 'ln -s' does not work.
-
 Once in terminal Vim it is possible to start MacVim by using the following
 command:
 	:gui [++opt] [+cmd] [-f|-b] [files...]
 Note: Forking ("-b") currently does not work.
 
+							*mvim*
+The "mvim" shell script bundled with MacVim. >
+	/Applications/MacVim.app/Contents/bin/mvim
+This is a wrapper script to launch Vim executable in the bundle.  Put this
+folder >
+	/Applications/MacVim.app/Contents/bin
+in your path and then simply type "mvim" to start MacVim from Terminal. >
+	$ mvim
+You can also specify files to open with. >
+	$ mvim file ...
+Also the bin folder has convenient scripts for diffing and opening file as the file is read-only. >
+	* Diff:		mvimdiff
+	* Read-only:	mview
+
+You can use "vim", "vimdiff", and "view" if you want to use non-GUI Vim.
+
 							*Quickstart*
 Quickstart ensures that new windows open instantaneously e.g. when <D-n> is
 pressed.  This feature can be enabled from the Advanced preferences pane (it