wwivbbs / wwiv

WWIV BBS Software v5
http://www.wwivbbs.org
Other
186 stars 71 forks source link

using -h should display help #1176

Closed granitepenguin closed 5 years ago

granitepenguin commented 5 years ago

using -? is weird for showing help in linux (nobody would ever guess to use it). -h is what's expected in linux. We should add that as an option for displaying help.

wwiv commented 5 years ago

in which binary? all? --help works already IIRC

granitepenguin commented 5 years ago

it works by accident

wwiv@beaglebbs:~$ ./networkc -h Unable to parse command line. unknown_argument_error: Command: ; letter=H ./networkc [5.4.0.2928] for network: wwivnet ./networkc [5.4.0.2928]

granitepenguin commented 5 years ago

There's no reason -h can't be a first-class citizen with -? and --help

toddcarnes commented 5 years ago

When I'm in a Linux environment I would never think to use -h either. I would automatically try to use --help... or a man page. :)

On Sat, Mar 9, 2019 at 9:51 AM granitepenguin notifications@github.com wrote:

using -? is weird for showing help in linux (nobody would ever guess to use it). -h is what's expected in linux. We should add that as an option for displaying help.

— You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub https://github.com/wwivbbs/wwiv/issues/1176, or mute the thread https://github.com/notifications/unsubscribe-auth/AAqXF0o0l7MElVsxudBc9tyf6swnvVsPks5vU_SFgaJpZM4bmz0- .

granitepenguin commented 5 years ago

show me a man page that does not have -h for help

toddcarnes commented 5 years ago

Since you didn't specify what kind of man page I was to show you...

http://man7.org/linux/man-pages/man7/libc.7.html

You really shouldn't take things so seriously, I was half joking about the man page thing, though it's true I would try --help before I would have ever thought to try -h.

On Sun, Mar 10, 2019 at 2:30 PM granitepenguin notifications@github.com wrote:

show me a man page that does not have -h for help

— You are receiving this because you commented. Reply to this email directly, view it on GitHub https://github.com/wwivbbs/wwiv/issues/1176#issuecomment-471355724, or mute the thread https://github.com/notifications/unsubscribe-auth/AAqXF1aJbXRwItmqpUkVO3tX8lRbsdHnks5vVXlggaJpZM4bmz0- .

granitepenguin commented 5 years ago

LOL Well played. :-)

The real point of this request is who in their right mind would ever try -?

toddcarnes commented 5 years ago

Then there are...

https://linux.die.net/man/1/ed

https://linux.die.net/man/6/ccurve

https://linux.die.net/man/1/sed

Actually, sed does have an h command, but it doesn't call a help screen. I think you get the point though.

I could go on, but it would be pointless other than to make it clear that getting snarky with me was totally uneccessary.

For what it's worth, I actually agreed with you over all. It certainly couldn't hurt anything to make -h and official command switch.

Have a nice day,

Todd

On Sun, Mar 10, 2019 at 2:30 PM granitepenguin notifications@github.com wrote:

show me a man page that does not have -h for help

— You are receiving this because you commented. Reply to this email directly, view it on GitHub https://github.com/wwivbbs/wwiv/issues/1176#issuecomment-471355724, or mute the thread https://github.com/notifications/unsubscribe-auth/AAqXF1aJbXRwItmqpUkVO3tX8lRbsdHnks5vVXlggaJpZM4bmz0- .

toddcarnes commented 5 years ago

I totally agree with you.

I don't think I've seen that since the MS DOS days when they used /?.

On Sun, Mar 10, 2019 at 6:11 PM granitepenguin notifications@github.com wrote:

LOL Well played. :-)

The real point of this request is who in their right mind would ever try -?

— You are receiving this because you commented. Reply to this email directly, view it on GitHub https://github.com/wwivbbs/wwiv/issues/1176#issuecomment-471374050, or mute the thread https://github.com/notifications/unsubscribe-auth/AAqXF2g6mW50Iou6QJz5mWXS2przbcw9ks5vVa1NgaJpZM4bmz0- .

wwivsoftwareservices commented 5 years ago

Apple Terminal understands /? In most cases.

Winderz still uses /? In the console but not many folks can even use that these days…. 😊

(Note that I only know this because they force me to use a winderz 10 laptop…)

From: Todd Carnes notifications@github.com Reply-To: wwivbbs/wwiv reply@reply.github.com Date: Sunday, March 10, 2019 at 21:16 To: wwivbbs/wwiv wwiv@noreply.github.com Cc: Subscribed subscribed@noreply.github.com Subject: Re: [wwivbbs/wwiv] using -h should display help (#1176)

I totally agree with you.

I don't think I've seen that since the MS DOS days when they used /?.

On Sun, Mar 10, 2019 at 6:11 PM granitepenguin notifications@github.com wrote:

LOL Well played. :-)

The real point of this request is who in their right mind would ever try -?

— You are receiving this because you commented. Reply to this email directly, view it on GitHub https://github.com/wwivbbs/wwiv/issues/1176#issuecomment-471374050, or mute the thread https://github.com/notifications/unsubscribe-auth/AAqXF2g6mW50Iou6QJz5mWXS2przbcw9ks5vVa1NgaJpZM4bmz0- .

— You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub, or mute the thread.

granitepenguin commented 5 years ago

No harm, no foul. If you can't take a little snark when you dish it out, you have no business dishing it out. ;-)

toddcarnes commented 5 years ago

LOL! True.

On Sun, Mar 10, 2019 at 6:20 PM granitepenguin notifications@github.com wrote:

No harm, no foul. If you can't take a little snark when you dish it out, you have no business dishing it out. ;-)

— You are receiving this because you commented. Reply to this email directly, view it on GitHub https://github.com/wwivbbs/wwiv/issues/1176#issuecomment-471374988, or mute the thread https://github.com/notifications/unsubscribe-auth/AAqXF6x6vIamMKBj6-EcGMuzzEarbJO-ks5vVa9RgaJpZM4bmz0- .

granitepenguin commented 5 years ago

This does make me wonder... should we create man pages? The online docs are nice and all, but having local doc would be nice, too.

wwiv commented 5 years ago

Nice to hear from you @wwivsoftwareservices !

If we can auto-create man pages and online docs from the same source that's good, but otherwise we are duplicating work, and man pages don't work on Windows either. If anyone has good ideas on that, I'm happy to read them.

granitepenguin commented 5 years ago

yeah, I have no intention of duplicating work. :-)

wwiv commented 5 years ago

bbs.exe already uses -H for handle (like elebbs did too)

wwiv commented 5 years ago

I could add it to the network tools only.

wwiv commented 5 years ago

actually that doesn't work. only one short key per long key. Not going to address this one, --help and -? both work