golden hour

/usr/share/vim/vim82/doc

File/Folder	Size	Actions
arabic.txt	11.62 KB
autocmd.txt	70.53 KB
change.txt	76.22 KB
channel.txt	49.13 KB
cmdline.txt	48.19 KB
debug.txt	6.73 KB
debugger.txt	5.32 KB
develop.txt	22.33 KB
diff.txt	16.63 KB
digraph.txt	60.53 KB
editing.txt	72.42 KB
eval.txt	528.52 KB
farsi.txt	523 B
filetype.txt	26.95 KB
fold.txt	23.13 KB
ft_ada.txt	17.82 KB
ft_rust.txt	9.37 KB
ft_sql.txt	29.98 KB
gui.txt	51.5 KB
gui_w32.txt	19 KB
gui_x11.txt	29.21 KB
hangulin.txt	598 B
hebrew.txt	5.53 KB
help.txt	8.69 KB
helphelp.txt	15.36 KB
howto.txt	2.85 KB
if_cscop.txt	18.87 KB
if_lua.txt	16.36 KB
if_mzsch.txt	11.66 KB
if_ole.txt	7.19 KB
if_perl.txt	11.02 KB
if_pyth.txt	37.53 KB
if_ruby.txt	8.32 KB
if_sniff.txt	271 B
if_tcl.txt	22.41 KB
indent.txt	41.29 KB
index.txt	78.75 KB
insert.txt	83.29 KB
intro.txt	38.06 KB
map.txt	69.14 KB
mbyte.txt	58.24 KB
message.txt	30.69 KB
mlang.txt	8 KB
motion.txt	50.14 KB
netbeans.txt	37.09 KB
options.txt	382.14 KB
os_390.txt	4.64 KB
os_amiga.txt	5.34 KB
os_beos.txt	293 B
os_dos.txt	12.09 KB
os_haiku.txt	8.39 KB
os_mac.txt	6.7 KB
os_mint.txt	391 B
os_msdos.txt	523 B
os_os2.txt	299 B
os_qnx.txt	3.98 KB
os_risc.txt	328 B
os_unix.txt	2.54 KB
os_vms.txt	32.13 KB
os_win32.txt	13.04 KB
pattern.txt	58.73 KB
pi_getscript.txt	20.59 KB
pi_gzip.txt	1.26 KB
pi_logipat.txt	4.1 KB
pi_netrw.txt	175.08 KB
pi_paren.txt	2.22 KB
pi_spec.txt	4.03 KB
pi_tar.txt	6.65 KB
pi_vimball.txt	11.58 KB
pi_zip.txt	7.12 KB
popup.txt	38.55 KB
print.txt	30.3 KB
quickfix.txt	80.98 KB
quickref.txt	70.45 KB
quotes.txt	12.45 KB
recover.txt	10.47 KB
remote.txt	8.22 KB
repeat.txt	41.2 KB
rileft.txt	4.82 KB
russian.txt	2.95 KB
scroll.txt	13.46 KB
sign.txt	25.25 KB
spell.txt	62.6 KB
sponsor.txt	7.03 KB
starting.txt	71.87 KB
syntax.txt	220.57 KB
tabpage.txt	16.84 KB
tags	346.5 KB
tagsrch.txt	39.33 KB
term.txt	46.38 KB
terminal.txt	54.79 KB
testing.txt	14.6 KB
textprop.txt	13.09 KB
tips.txt	20.57 KB
todo.txt	302.17 KB
uganda.txt	13.7 KB
undo.txt	16.2 KB
usr_01.txt	6.92 KB
usr_02.txt	23.66 KB
usr_03.txt	23.31 KB
usr_04.txt	18.68 KB
usr_05.txt	26.39 KB
usr_06.txt	9.39 KB
usr_07.txt	15.62 KB
usr_08.txt	18.92 KB
usr_09.txt	11.23 KB
usr_10.txt	28.52 KB
usr_11.txt	12.72 KB
usr_12.txt	13.11 KB
usr_20.txt	13.39 KB
usr_21.txt	18.02 KB
usr_22.txt	14.65 KB
usr_23.txt	12.45 KB
usr_24.txt	20.34 KB
usr_25.txt	18.73 KB
usr_26.txt	8.07 KB
usr_27.txt	17.29 KB
usr_28.txt	15.64 KB
usr_29.txt	19.65 KB
usr_30.txt	22.13 KB
usr_31.txt	10.16 KB
usr_32.txt	5.25 KB
usr_40.txt	22.65 KB
usr_41.txt	95.1 KB
usr_42.txt	13.53 KB
usr_43.txt	7.24 KB
usr_44.txt	28.27 KB
usr_45.txt	17.27 KB
usr_46.txt	6.93 KB
usr_90.txt	16.44 KB
usr_toc.txt	9.28 KB
various.txt	30.37 KB
version4.txt	13.58 KB
version5.txt	301.3 KB
version6.txt	563.42 KB
version7.txt	658.89 KB
version8.txt	1.85 MB
vi_diff.txt	56.08 KB
vim9.txt	55.82 KB
visual.txt	21.28 KB
windows.txt	54.43 KB
workshop.txt	371 B

Edit: os_mac.txt

*os_mac.txt*    For Vim version 8.2.  Last change: 2019 Apr 21

VIM REFERENCE MANUAL    by Bram Moolenaar et al.

*mac* *Mac* *macintosh* *Macintosh*

This file documents the particularities of the Macintosh version of Vim.

NOTE: This file is a bit outdated.  You might find more useful info here:
	http://macvim.org/

There was a Mac port for version 3.0 of Vim.  Here are the first few lines
from the old file:

VIM Release Notes
Initial Macintosh release, VIM version 3.0
19 October 1994

Eric Fischer
<enf1@midway.uchicago.edu>, <eric@jcp.uchicago.edu>, <etaoin@uchicago.edu>
5759 N. Guilford Ave
Indianapolis IN 46220 USA

==============================================================================
1. Filename Convention					*mac-filename*

Starting with Vim version 7 you can just use the unix path separators with
Vim. In order to determine if the specified filename is relative to the
current folder or absolute (i.e. relative to the "Desktop"), the following
algorithm is used:

If the path start by a "/", the path is absolute
	If the path start by a ":", the path is relative
	If the path doesn't start by neither a "/" nor ":",
	  and a ":" is found before a "/" then the path is absolute
>
		:e /HD/text
		:e HD:text
<	Edit the file "text" of the disk "HD" >
		:e :src:main.c
		:e src/main.c
<	Edit the file "main.c" in the folder "src" in the current folder >
		:e os_mac.c
<	Edit the file "os_mac.c" in the current folder.

You can use the |$VIM| and |$VIMRUNTIME|  variable. >

:so $VIMRUNTIME:syntax:syntax.vim

==============================================================================
2. .vimrc and .vim files				*mac-vimfile*

It is recommended to use Unix style line separators for Vim scripts, thus a
single newline character.

When starting up Vim will load the $VIMRUNTIME/macmap.vim script to define
default command-key mappings.

On older systems files starting with a dot "." are discouraged, thus the rc
files are named "vimrc" or "_vimrc" and "gvimrc" or "_gvimrc".  These files
can be in any format (mac, dos or unix).  Vim can handle any file format when
the |'nocompatible'| option is set, otherwise it will only handle mac format
files.

==============================================================================
3. Standard mappings				*mac-standard-mappings*

The following mappings are available for cut/copy/paste from/to clipboard.

key		Normal	Visual	  Insert	Description ~
Command-v	"*P	"-d"*P    <C-R>*	paste text       *<D-v>*
Command-c		"*y			copy Visual text *<D-c>*
Command-x		"*d			cut Visual text  *<D-x>*
Backspace		"*d			cut Visual text

==============================================================================
4. Mac FAQ						*mac-faq*

On the internet:  http://macvim.org/OSX/index.php#FAQ

Q: I can't enter non-ASCII character in Apple Terminal.
A: Under Window Settings, Emulation, make sure that "Escape non-ASCII
   characters" is not checked.

Q: How do I start the GUI from the command line?
A: Assuming that Vim.app is located in /Applications:
	open /Applications/Vim.app
   Or:
	/Applications/Vim.app/Contents/MacOS/Vim -g  {arguments}

Q: How can I set $PATH to something reasonable when I start Vim.app from the
   GUI or with open?
A: The following trick works with most shells.  Put it in your vimrc file.
   This is included in the system vimrc file included with the binaries
   distributed at macvim.org . >
	let s:path = system("echo echo VIMPATH'${PATH}' | $SHELL -l")
	let $PATH = matchstr(s:path, 'VIMPATH\zs.\{-}\ze\n')

==============================================================================
5. Mac Lack						*mac-lack*

In a terminal CTRL-^ needs to be entered as Shift-Control-6.  CTRL-@ as
Shift-Control-2.

==============================================================================
6. Mac Bug Report					*mac-bug*

When reporting any Mac specific bug or feature change, please use the vim-mac
maillist |vim-mac|.  However, you need to be subscribed.  An alternative is to
send a message to the current MacVim maintainers:

mac@vim.org

==============================================================================
7. Compiling Vim					*mac-compile*

See the file "src/INSTALLmac.txt" that comes with the source files.

==============================================================================
8. The Darwin Feature					*mac-darwin-feature*

If you have a Mac that isn't very old, you will be running OS X, also called
Darwin.  The last pre-Darwin OS was Mac OS 9.  The darwin feature makes Vim
use Darwin-specific properties.

What is accomplished with this feature is two-fold:

- Make Vim interoperable with the system clipboard.
- Incorporate into Vim a converter module that bridges the gap between some
  character encodings specific to the platform and those known to Vim.

Needless to say, both are not to be missed for any decent text editor to work
nicely with other applications running on the same desktop environment.

As Vim is not an application dedicated only to macOS, we need an extra feature
to add in order for it to offer the same user experience that our users on
other platforms enjoy to people on macOS.

For brevity, the feature is referred to as "darwin" to signify it one of the
Vim features that are specific to that particular platform.

The feature is a configuration option.  Accordingly, whether it is enabled or
not is determined at build time; once it is selected to be enabled, it is
compiled in and hence cannot be disabled at runtime.

The feature is enabled by default.  For most macOS users, that should be
sufficient unless they have specific needs mentioned briefly below.

If you want to disable it, pass `--disable-darwin` to the configure script: >

./configure --disable-darwin <other options>

and then run `make` to build Vim.  The order of the options doesn't matter.

To make sure at runtime whether or not the darwin feature is compiled in, you
can use `has('osxdarwin')` which returns 1 if the feature is compiled in; 0
otherwise.  For backward compatibility, you can still use `macunix` instead of
`osxdarwin`.

Notable use cases where `--disable-darwin` is turned out to be useful are:

- When you want to use |x11-selection| instead of the system clipboard.
- When you want to use |x11-clientserver|.

Since both have to make use of X11 inter-client communication for them to work
properly, and since the communication mechanism can come into conflict with
the system clipboard, the darwin feature should be disabled to prevent Vim
from hanging at runtime.

vim:tw=78:ts=8:noet:ft=help:norl: