diff --git a/docs/Makefile.am b/docs/Makefile.am
index 987feb5f4..88e090c9c 100644
--- a/docs/Makefile.am
+++ b/docs/Makefile.am
@@ -29,7 +29,7 @@ SCANGOBJ_OPTIONS=
 # Extra options to supply to gtkdoc-scan.
 # e.g. SCAN_OPTIONS=--deprecated-guards="GTK_DISABLE_DEPRECATED"
 SCAN_OPTIONS=--rebuild-types --deprecated-guards="HB_DISABLE_DEPRECATED" \
-	--ignore-decorators="HB_EXTERN"
+	--ignore-decorators='HB_EXTERN|HB_DEPRECATED|HB_DEPRECATED_FOR()'
 
 # Header files or dirs to ignore when scanning. Use base file/dir names
 # e.g. IGNORE_HFILES=gtkdebug.h gtkintl.h private_code
diff --git a/docs/meson.build b/docs/meson.build
index f3bf46079..cf7f60180 100644
--- a/docs/meson.build
+++ b/docs/meson.build
@@ -56,7 +56,7 @@ gnome.gtkdoc('harfbuzz',
             join_paths(meson.current_build_dir(), '..'),
            ],
   scan_args: ['--deprecated-guards=HB_DISABLE_DEPRECATED',
-              '--ignore-decorators=HB_EXTERN',
+              '--ignore-decorators=HB_EXTERN|HB_DEPRECATED|HB_DEPRECATED_FOR()',
              ],
   mkdb_args: ['--source-suffixes=h,cc',
               '--xml-mode',