Add clearer documentation about how to query the system appearance mode

See #1306
This commit is contained in:
Yee Cheng Chin
2022-10-07 16:38:53 -07:00
parent 2fbd8bf2ce
commit 52dcad216b
3 changed files with 14 additions and 1 deletions

View File

@@ -1042,6 +1042,7 @@ OptionSet After setting an option. The pattern is
OSAppearanceChanged After changing the variable |v:os_appearance|.
This change happens only if the OS changes
its appearance and Vim is running with a GUI.
{only in MacVim GUI}
*QuickFixCmdPre*
QuickFixCmdPre Before a quickfix command is run (|:make|,

View File

@@ -121,6 +121,10 @@ These are the non-standard commands that MacVim supports:
These are the non-standard events that MacVim supports:
|OSAppearanceChanged|
*macvim-internal-variables*
These are the non-standard internal variables that MacVim supports:
|v:os_appearance|
*macvim-find*
Whenever you search for something in Vim (e.g. using "/"), or hit <D-e> when
you have text selected, the search query is copied to the macOS "Find
@@ -319,7 +323,7 @@ this behaviour set MMLoginShellArgument to "--".
==============================================================================
4. MacVim appearance *macvim-appearance*
MacVim can be used in full screen mode, see 'fullscreen'.
For more configuration options, see the Preferences… → Appearance pane.
*macvim-appearance-mode* *macvim-dark-mode*
MacVim will by default use the system apperance mode (light or dark). However,
@@ -330,7 +334,14 @@ color scheme while system preferences are configured to use light mode. It's
also the recommended setting when title bar is configured to be "Transparent"
(see |MMTitlebarAppearsTransparent|).
If you would like to query the system apperance mode in Vim (e.g. to change
the color scheme at launch), see |v:os_appearance|. You can also use the
autocommand |OSAppearanceChanged| to be notified when the OS changes its
appearance.
*macvim-full-screen*
MacVim can be used in full screen mode, see 'fullscreen'.
There are two types of full screen modes. By default, MacVim uses macOS'
native full screen functionality, which creates a separate space in Mission
Control. MacVim also provides a non-native full screen mode, which can be set

View File

@@ -8389,6 +8389,7 @@ macvim-full-screen gui_mac.txt /*macvim-full-screen*
macvim-gestures gui_mac.txt /*macvim-gestures*
macvim-help-menu gui_mac.txt /*macvim-help-menu*
macvim-hints gui_mac.txt /*macvim-hints*
macvim-internal-variables gui_mac.txt /*macvim-internal-variables*
macvim-international gui_mac.txt /*macvim-international*
macvim-login-shell gui_mac.txt /*macvim-login-shell*
macvim-menus gui_mac.txt /*macvim-menus*