https://bugzilla.redhat.com/show_bug.cgi?id=2239811



--- Comment #8 from Ben Beasley <[email protected]> ---
(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 -- [email protected]
To unsubscribe send an email to [email protected]
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/[email protected]
Do not reply to spam, report it: 
https://pagure.io/fedora-infrastructure/new_issue

Reply via email to