simon-git: xtruss (main): Simon Tatham

[Commits to Tartarus hosted VCS]

TL;DR:
  c082496 Document -t in the usage message and man page.
  f723509 Conform to my 'Stop helping!' principles.

Repository:     https://git.tartarus.org/simon/xtruss.git
On the web:     https://git.tartarus.org/?p=simon/xtruss.git
Branch updated: main
Committer:      Simon Tatham <anakin at pobox.com>
Date:           2025-04-27 11:32:27

commit c0824964cba3dbda1784432830ff940071bf3b9e
web diff https://git.tartarus.org/?p=simon/xtruss.git;a=commitdiff;h=c0824964cba3dbda1784432830ff940071bf3b9e;hp=ee4d171c630847ae9b6a825d4112d3cb54b10663
Author: Simon Tatham <anakin at pobox.com>
Date:   Sun Apr 27 11:16:47 2025 +0100

    Document -t in the usage message and man page.
    
    Oops. Should have been in the previous commit, of course.

 doc/man-xtruss.but | 19 +++++++++++++++++++
 xtruss.c           |  1 +
 2 files changed, 20 insertions(+)

commit f723509a3acde14ba371fe819474422fe6da92de
web diff https://git.tartarus.org/?p=simon/xtruss.git;a=commitdiff;h=f723509a3acde14ba371fe819474422fe6da92de;hp=c0824964cba3dbda1784432830ff940071bf3b9e
Author: Simon Tatham <anakin at pobox.com>
Date:   Sun Apr 27 11:18:38 2025 +0100

    Conform to my 'Stop helping!' principles.
    
    I now believe it's wrong to print a long multiline usage message
    alongside a specific complaint about a command-line syntax error. It
    distracts from the specific message, and might even scroll it off the
    top of the window, consumes scrollback space, and in many cases is
    completely unnecessary, as I said at greater length in a 2023 blog
    post:
    
    https://www.chiark.greenend.org.uk/~sgtatham/quasiblog/stop-helping/
    
    Now the full help message is only printed if you say --help.
    (Corollary: it only ever needs to go to stdout, so usage() doesn't
    need a parameter any more.) All other syntax errors print one extra
    line suggesting where you _can_ find more information, but don't
    volunteer the whole screenful unasked-for.

 xtruss.c | 19 ++++++++++++++-----
 1 file changed, 14 insertions(+), 5 deletions(-)