From 55a62f281d2ccac2d803f0a69d58d1d4652f29a8 Mon Sep 17 00:00:00 2001
From: Simon Cozens <simon@simon-cozens.org>
Date: Wed, 3 Feb 2021 14:27:03 +0000
Subject: [PATCH] Add "sub A by NULL" to specification

---
 docs/OpenTypeFeatureFileSpecification.md | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/docs/OpenTypeFeatureFileSpecification.md b/docs/OpenTypeFeatureFileSpecification.md
index ecc911f07..ce59f3a6b 100644
--- a/docs/OpenTypeFeatureFileSpecification.md
+++ b/docs/OpenTypeFeatureFileSpecification.md
@@ -195,7 +195,7 @@ contexts.
 [`MarkAttachmentType`](#4.d)<br>
 [`markClass`](#4.f)<br>
 [`nameid`](#9.e)<br>
-`NULL` (used in [device](#2.e.iii), [value record](#2.e.iv), [anchor](#2.e.vii))<br>
+`NULL` (used in [substitute](#5.a), [device](#2.e.iii), [value record](#2.e.iv), [anchor](#2.e.vii))<br>
 [`parameters`](#4.c)<br>
 [`pos`](#6)<br>
 [`position`](#6)<br>
@@ -1558,6 +1558,13 @@ substitute c by C.sc;
 substitute z by Z.sc;
 ```
 
+If the replacement glyph is the reserved word `NULL`, then the substitution
+has no replacement, removing the input glyph from the glyph sequence:
+
+```fea
+substitute a by NULL;
+```
+
 <a name="5.b"></a>
 ### 5.b. [GSUB LookupType 2] Multiple substitution