]> git.ipfire.org Git - thirdparty/pdns.git/commit
Friendlier usage output. 15082/head
authorMiod Vallat <miod.vallat@open-xchange.com>
Thu, 23 Jan 2025 14:28:26 +0000 (15:28 +0100)
committerMiod Vallat <miod.vallat@powerdns.com>
Mon, 24 Feb 2025 08:56:29 +0000 (09:56 +0100)
commitee4527c3ff25f55a79d77531bd50cc967847ee79
treeecb8feab6b66a8c317ff510f0f63ec04d7c41bb1
parent15a2bcc64d498de6c5782a070cf8158f7d33a10e
Friendlier usage output.

1. The commands dictionary is extended with a command group, as well as
   the one-liner synopsis and help message. When the list of these
   one-liners get output, they are now output in sorted order within
   each group.

2. Instead of having the syntax on the leftmost 40 columns and the
   description on the rightmost 40 columns, causing many commands to
   span more than one line total, we now display the syntax on a whole
   line, and the description on the next one, indented by a tab.

   This should hopefully improve readability (especially for complex
   syntax lines).

3. The command synopsis is now passed to the command handler. This
   allows error messages in case of invocation error to be consistent
   with the output of `pdnsutil help`.

4. Tweak and homogeneize command synopsis, and sync the pdnsutil
   documentation accordingly.

Co-authored-by: Josh Soref <2119212+jsoref@users.noreply.github.com>
docs/manpages/pdnsutil.1.rst
pdns/pdnsutil.cc