diff --git a/runtime/doc/gui_mac.txt b/runtime/doc/gui_mac.txt
index a3d3ea729c..012c2a0031 100644
--- a/runtime/doc/gui_mac.txt
+++ b/runtime/doc/gui_mac.txt
@@ -111,7 +111,7 @@ to your .gvimrc file to revert back to the default Vim tab label.
 							*macvim-options*
 These are the non-standard options that MacVim supports:
 	'antialias'	'blurradius'	'fullscreen'
-	'fuoptions'	'macmeta'	'toolbariconsize'
+	'fuoptions'	'macmeta'	'macligatures'	'toolbariconsize'
 	'transparency'
 
 							*macvim-commands*
diff --git a/runtime/doc/options.txt b/runtime/doc/options.txt
index ffa5b679a1..ad18ef396d 100644
--- a/runtime/doc/options.txt
+++ b/runtime/doc/options.txt
@@ -4997,6 +4997,19 @@ A jump table for the options with a short description can be found at |Q_op|.
 	bound with the Meta flag even when this option is disabled, but this
 	is not the case for the majority of keys (e.g. <M-a>, <M-`>).
 
+				*'macligatures'* *'nomacligatures'*
+'macligatures' 		boolean (default off)
+			global
+			{not in Vi}
+                        {only available when compiled with GUI enabled on
+			 Mac OS X}
+	This option only has an effect in the GUI version of Vim on Mac OS X
+	v10.2 or later.  When on, Vim will display ligatures if the selected
+	'guifont' supports them. Examples for such fonts are Fira Code or
+	Haskelig.
+	Note: Currently this option only has an effect if
+	'Use Core Text renderer' is enabled in the GUI preferences pane.
+
 						*'magic'* *'nomagic'*
 'magic'			boolean	(default on)
 			global