https://bugzilla.redhat.com/show_bug.cgi?id=2239811 --- Comment #8 from Ben Beasley <code@xxxxxxxxxxxxxxxxxx> --- (In reply to Sandro from comment #7) > Based on Ben's feedback, I took a closer look at the manpages. I agree: > > > The result is still far from beautiful, but at least does contain useful text. > > At least it's no longer broken. I wonder how helpful it is having a man page > when the output is almost identical to the output of the '--help' switch. > But that's more a philosophical question and `nsgr_job` appears to lack a > `--help` switch all together (it uses '-h' instead). As a matter of purely personal preference, I am *much* happier typing man foobar than foobar --help | less or when the command doesn’t follow conventions, maybe something like foobar -h 2>&1 | less -S I find a man page more ergonomic even if it is merely a lightly-formatted regurgitation of the help text. > While I was busy I noted that `nsgr_job` crashes without any options. I'd > say that's a bug: > > [...] > Exception: Didn't find the file: ~/.nsgrest.conf or ~/nsgrest.conf (which > should contain properties {'USERNAME', 'URL', 'APPID', 'APPNAME', > 'PASSWORD'}) or /opt/user/nsgrest.conf on Open Source Brain v2. > > Probably not a reason to not grant the review, but I'll ponder that while > I'm afk and decide later I would say it’s a bug, because spewing a traceback is an ugly way to report an error, but at least the exception message is useful (basically: “you need to configure authentication credentials first, and here’s where you should put them.”) -- You are receiving this mail because: You are always notified about changes to this product and component You are on the CC list for the bug. https://bugzilla.redhat.com/show_bug.cgi?id=2239811 Report this comment as SPAM: https://bugzilla.redhat.com/enter_bug.cgi?product=Bugzilla&format=report-spam&short_desc=Report%20of%20Bug%202239811%23c8 _______________________________________________ package-review mailing list -- package-review@xxxxxxxxxxxxxxxxxxxxxxx To unsubscribe send an email to package-review-leave@xxxxxxxxxxxxxxxxxxxxxxx Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/ List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines List Archives: https://lists.fedoraproject.org/archives/list/package-review@xxxxxxxxxxxxxxxxxxxxxxx Do not reply to spam, report it: https://pagure.io/fedora-infrastructure/new_issue
