From 89fc399eba5c7adf61c67be60cf5e81cfb21bbdc Mon Sep 17 00:00:00 2001
From: Garret Rieger <grieger@google.com>
Date: Thu, 22 Jul 2021 13:00:34 -0700
Subject: [PATCH] [subset] Add hb-subset section documentation.

---
 src/hb-subset.cc | 11 +++++++++++
 src/hb-subset.h  |  4 ----
 2 files changed, 11 insertions(+), 4 deletions(-)

diff --git a/src/hb-subset.cc b/src/hb-subset.cc
index dd6f16473..30a3cef9a 100644
--- a/src/hb-subset.cc
+++ b/src/hb-subset.cc
@@ -53,6 +53,17 @@
 #include "hb-ot-var-hvar-table.hh"
 #include "hb-repacker.hh"
 
+/**
+ * SECTION:hb-subset
+ * @title: hb-subset
+ * @short_description: Subsets font files.
+ * @include: hb-subset.h
+ *
+ * Subsetting reduces the codepoint coverage of font files and removes all data
+ * that is no longer needed. A subset input describes the desired subset. The input is
+ * provided along with a font to the subsetting operation. Output is a new font file
+ * containing only the data specified in the input.
+ */
 
 static unsigned
 _plan_estimate_subset_table_size (hb_subset_plan_t *plan, unsigned table_len)
diff --git a/src/hb-subset.h b/src/hb-subset.h
index c8a540cd9..4f666f05b 100644
--- a/src/hb-subset.h
+++ b/src/hb-subset.h
@@ -134,10 +134,6 @@ hb_subset_input_set_flag (hb_subset_input_t *input,
 			  hb_subset_flag_t flag,
 			  hb_bool_t value);
 
-/* hb_subset () */
-HB_EXTERN hb_face_t *
-hb_subset (hb_face_t *source, const hb_subset_input_t *input);
-
 HB_EXTERN hb_face_t *
 hb_subset_or_fail (hb_face_t *source, const hb_subset_input_t *input);