improve layout of command-line tools help page

Author: farindk

examples/heif_dec.cc

@@ -27,6 +27,7 @@
 
 #include <cstring>
 #include <getopt.h>
+#include <filesystem>
 #include "libheif/heif_items.h"
 
 #if defined(HAVE_UNISTD_H)
@@ -72,10 +73,18 @@
 
 static void show_help(const char* argv0)
 {
-  std::cerr << " " << argv0 << "  libheif version: " << heif_get_version() << "\n"
-            << "---------------------------------------\n"
-               "Usage: " << argv0 << " [options]  <input-image> [output-image]\n"
-               "\n"
+  std::filesystem::path p(argv0);
+  std::string filename = p.filename().string();
+
+  std::stringstream sstr;
+  sstr << " " << filename << "  libheif version: " << heif_get_version();
+
+  std::string title = sstr.str();
+
+  std::cerr << title << "\n"
+            << std::string(title.length() + 1, '-') << "\n"
+            << "Usage: " << filename << " [options]  <input-image> [output-image]\n"
+            << "\n"
                "The program determines the output file format from the output filename suffix.\n"
                "These suffixes are recognized: jpg, jpeg, png, tif, tiff, y4m. If no output filename is specified, 'jpg' is used.\n"
                "\n"

examples/heif_enc.cc

@@ -159,9 +159,17 @@ static struct option long_options[] = {
 
 void show_help(const char* argv0)
 {
-  std::cerr << " heif-enc  libheif version: " << heif_get_version() << "\n"
-            << "----------------------------------------\n"
-            << "Usage: heif-enc [options] image.jpeg ...\n"
+  std::filesystem::path p(argv0);
+  std::string filename = p.filename().string();
+
+  std::stringstream sstr;
+  sstr << " " << filename << "  libheif version: " << heif_get_version();
+
+  std::string title = sstr.str();
+
+  std::cerr << title << "\n"
+            << std::string(title.length() + 1, '-') << "\n"
+            << "Usage: " << filename << " [options] <input-image> ...\n"
             << "\n"
             << "When specifying multiple source images, they will all be saved into the same HEIF/AVIF file.\n"
             << "\n"

examples/heif_info.cc

@@ -47,6 +47,7 @@
 #include <getopt.h>
 #include <assert.h>
 #include <stdio.h>
+#include <filesystem>
 #include "common.h"
 
 
@@ -91,17 +92,25 @@ static const char* fourcc_to_string(uint32_t fourcc)
 
 void show_help(const char* argv0)
 {
-  fprintf(stderr, " heif-info  libheif version: %s\n", heif_get_version());
-  fprintf(stderr, "------------------------------------\n");
-  fprintf(stderr, "usage: heif-info [options] image.heic\n");
-  fprintf(stderr, "\n");
-  fprintf(stderr, "options:\n");
-  //fprintf(stderr,"  -w, --write-raw ID   write raw compressed data of image 'ID'\n");
-  //fprintf(stderr,"  -o, --output NAME    output file name for image selected by -w\n");
-  fprintf(stderr, "  -d, --dump-boxes     show a low-level dump of all MP4 file boxes\n");
-  fprintf(stderr, "      --disable-limits disable all security limits (do not use in production environment)\n");
-  fprintf(stderr, "  -h, --help           show help\n");
-  fprintf(stderr, "  -v, --version        show version\n");
+  std::filesystem::path p(argv0);
+  std::string filename = p.filename().string();
+
+  std::stringstream sstr;
+  sstr << " " << filename << "  libheif version: " << heif_get_version();
+
+  std::string title = sstr.str();
+
+  std::cerr << title << "\n"
+            << std::string(title.length() + 1, '-') << "\n"
+            << "Usage: " << filename << " [options] <HEIF-image>\n"
+            << "\n"
+               "options:\n"
+               //fprintf(stderr,"  -w, --write-raw ID   write raw compressed data of image 'ID'\n");
+               //fprintf(stderr,"  -o, --output NAME    output file name for image selected by -w\n");
+               "  -d, --dump-boxes     show a low-level dump of all MP4 file boxes\n"
+               "      --disable-limits disable all security limits (do not use in production environment)\n"
+               "  -h, --help           show help\n"
+               "  -v, --version        show version\n";
 }