From 59001aa9527c056ad08626cfec9a079b65d8aec8 Mon Sep 17 00:00:00 2001
From: Behdad Esfahbod <behdad@behdad.org>
Date: Wed, 26 Mar 2025 12:33:06 -0600
Subject: [PATCH] [util] Add brief --help descriptions

Part of https://github.com/harfbuzz/harfbuzz/issues/5208
---
 util/hb-info.cc      | 1 +
 util/hb-subset.cc    | 1 +
 util/shape-output.hh | 2 ++
 util/view-cairo.hh   | 2 ++
 4 files changed, 6 insertions(+)

diff --git a/util/hb-info.cc b/util/hb-info.cc
index de3ede169..197ce3b58 100644
--- a/util/hb-info.cc
+++ b/util/hb-info.cc
@@ -67,6 +67,7 @@ struct info_t :
   void add_options ()
   {
     set_summary ("Query font information.");
+    set_description ("Queries font file for various information. If no query option is specified, --show-all is assumed.");
 
     font_options_t::add_options (this);
 
diff --git a/util/hb-subset.cc b/util/hb-subset.cc
index bca58a935..bc8f27f73 100644
--- a/util/hb-subset.cc
+++ b/util/hb-subset.cc
@@ -859,6 +859,7 @@ void
 subset_main_t::add_options ()
 {
   set_summary ("Subset font to specification.");
+  set_description ("Subsets font file to a specified set of glyphs, Unicode codepoints, or text, design-space limiting, and other reductions.");
 
   face_options_t::add_options (this);
 
diff --git a/util/shape-output.hh b/util/shape-output.hh
index ebf8dc465..5808112de 100644
--- a/util/shape-output.hh
+++ b/util/shape-output.hh
@@ -37,6 +37,8 @@ struct shape_output_t : output_options_t<>
   void add_options (option_parser_t *parser)
   {
     parser->set_summary ("Shape text with given font.");
+    parser->set_description ("Shows results of shaping text with a given font in textual or JSON format.");
+
     output_options_t::add_options (parser, hb_buffer_serialize_list_formats ());
     format.add_options (parser);
   }
diff --git a/util/view-cairo.hh b/util/view-cairo.hh
index b8f034a48..3a486766a 100644
--- a/util/view-cairo.hh
+++ b/util/view-cairo.hh
@@ -41,6 +41,8 @@ struct view_cairo_t : view_options_t, output_options_t<>
   void add_options (option_parser_t *parser)
   {
     parser->set_summary ("View text with given font.");
+    parser->set_description ("Shows image of rendering text with a given font in various formats.");
+
     view_options_t::add_options (parser);
     output_options_t::add_options (parser, helper_cairo_supported_formats);
   }