From d02fa5ca6d31d06bbf81dbe67409b491eb4a242d Mon Sep 17 00:00:00 2001 From: Dodji Seketeli Date: Thu, 30 Nov 2023 17:57:21 +0100 Subject: [PATCH] abilint: Alphabetically sort programs options It's a mess to find an option you are looking for both in the manual or when doing abilint --help. So how about sorting the options of the various libabigail programs, starting from abilint? Here we go. * doc/manuals/abilint.rst: Alphabetically sort options in the manual. * tools/abilint.cc (display_usage): Likewise for the help strings. Signed-off-by: Dodji Seketeli --- doc/manuals/abilint.rst | 48 +++++++++++++++++++++++++---------------- tools/abilint.cc | 24 ++++++++++----------- 2 files changed, 42 insertions(+), 30 deletions(-) diff --git a/doc/manuals/abilint.rst b/doc/manuals/abilint.rst index 594dd4c2..5fac4477 100644 --- a/doc/manuals/abilint.rst +++ b/doc/manuals/abilint.rst @@ -34,13 +34,12 @@ Options or even ELF symbols. The purpose is to make the ABIXML output more human-readable for debugging or documenting purposes. - * ``--help`` - Display a short help message and exits. + * ``--ctf`` - * `--version | -v` + Extract ABI information from CTF debug information, if present in + the given object. - Display the version of the program and exit. * ``--debug-info-dir`` <*path*> @@ -57,17 +56,39 @@ Options information installed by your system's package manager because then ``abidiff`` knows where to find it. + * ``--diff`` For XML inputs, perform a text diff between the input and the memory model saved back to disk. This can help to spot issues in the handling of the XML format by the underlying Libabigail library. + + * ``--header-file | --hf`` + + Specifies where to find one of the public headers of the abi file + that the tool has to consider. The tool will thus filter out + types that are not defined in public headers. + + + * ``--headers-dir | --hd`` + + Specifies where to find the public headers of the first shared + library that the tool has to consider. The tool will thus filter + out types that are not defined in public headers. + + + * ``--help`` + + Display a short help message and exits. + + * ``--noout`` Do not display anything on standard output. The return code of the command is the only way to know if the command succeeded. + * ``--suppressions | suppr`` <*path-to-suppression-specifications-file*> Use a :ref:`suppression specification ` file @@ -77,30 +98,21 @@ Options taken into account. ABI artifacts matched by the suppression specifications are suppressed from the output of this tool. - * ``--headers-dir | --hd`` - - Specifies where to find the public headers of the first shared - library that the tool has to consider. The tool will thus filter - out types that are not defined in public headers. - - * ``--header-file | --hf`` - - Specifies where to find one of the public headers of the abi file - that the tool has to consider. The tool will thus filter out - types that are not defined in public headers. * ``--stdin | --`` Read the input content from standard input. + * ``--tu`` Expect the input XML to represent a single translation unit. - * ``--ctf`` - Extract ABI information from CTF debug information, if present in - the given object. + * `--version | -v` + + Display the version of the program and exit. + .. _ELF: http://en.wikipedia.org/wiki/Executable_and_Linkable_Format .. _DWARF: http://www.dwarfstd.org diff --git a/tools/abilint.cc b/tools/abilint.cc index 9c6ed897..40fe6f37 100644 --- a/tools/abilint.cc +++ b/tools/abilint.cc @@ -485,25 +485,25 @@ display_usage(const string& prog_name, ostream& out) emit_prefix(prog_name, out) << "usage: " << prog_name << " [options] []\n" << " where options can be:\n" - << " --help display this message\n" - << " --version|-v display program version information and exit\n" - << " --debug-info-dir the path under which to look for " - "debug info for the elf \n" - << " --headers-dir|--hd the path to headers of the elf file\n" - << " --header-file|--hf the path to one header of the elf file\n" - << " --suppressions|--suppr specify a suppression file\n" - << " --diff for xml inputs, perform a text diff between " - "the input and the memory model saved back to disk\n" - << " --noout do not display anything on stdout\n" << " --annotate annotate the ABI artifacts emitted in the output\n" - << " --stdin read abi-file content from stdin\n" - << " --tu expect a single translation unit file\n" #ifdef WITH_CTF << " --ctf use CTF instead of DWARF in ELF files\n" #endif + << " --debug-info-dir the path under which to look for " + "debug info for the elf \n" + << " --diff for xml inputs, perform a text diff between " + "the input and the memory model saved back to disk\n" + << " --header-file|--hf the path to one header of the elf file\n" + << " --headers-dir|--hd the path to headers of the elf file\n" + << " --help display this message\n" + << " --noout do not display anything on stdout\n" #ifdef WITH_SHOW_TYPE_USE_IN_ABILINT << " --show-type-use show how a type is used from the abixml file\n" #endif + << " --stdin read abi-file content from stdin\n" + << " --suppressions|--suppr specify a suppression file\n" + << " --tu expect a single translation unit file\n" + << " --version|-v display program version information and exit\n" ; }