Ok, so I love fish in general and the original guy who was complaining before 
was a bit rude, but I liked a few of his ideas.  Namely that help should have a 
consistent interface and it is currently kind of a mess.

I've been scouring the 'net when needing fish help and forgot why since it has 
been so long.  Not to mention googling "fish shell ..." is just as likely to 
return seafood recipes, hahah.

Perhaps I have something misconfigured (2.1 on Ubuntu) but here are my results:

     ~>help for
     cat: : No such file or directory
     cat: invalid option -- 'f'
     Try 'cat --help' for more information.
     cat: invalid option -- 'f'

     ... snip 20x ...

     cat: cygstart: No such file or directory
     cat: xdg-open: No such file or directory
     help: Could not find a web browser.
     Please set the variable $BROWSER to a suitable browser and try again.

Didn't work.  I don't mind a web browser showing things, but I didn't ask for 
that, and just expect it to work in any case.  If I'm in a terminal, I'd expect 
it to print to stdout unless I ask for something different.  I tried it on my 
linux console/ssh also, same error... not sure what we're thinking looking for 
a 
browser in those environments?

I shouldn't have to set a variable and forced to get help from a GUI browser. 
What if my system is broken and I'm trying to fix it?

     ~>fish_config
     Web config started at 'http://localhost:8001/'. Hit enter to stop.

     (process:25106): GLib-CRITICAL **: g_slice_set_config: assertion 
'sys_page_size == 0' failed
     127.0.0.1 - - [08/May/2015 12:22:39] code 404, message File not found
     127.0.0.1 - - [08/May/2015 12:22:39] code 404, message File not found
     ^C
     Shutting down.

This did work and found my browser, so there is some inconsistency somewhere. 
Must be using different code.

I notice that fish isn't consistent with --help either:

     - echo <nl>     # prints a nl
     - echo --help   # prints help :)

     - for <nl>      # prints errors, then help, repopulates cmd-line
     - for --help    # prints errors, then help, repopulates cmd-line

     - while <nl>    # prints errors, then help, repopulates cmd-line
     - while --help  # gets stuck, needs ^C to escape


TL;DR  Would be nice if fish could...

- Give help on builtins as well with the help command,
     - perhaps default output to the terminal its in,
         - unless a switch was given to use the browser
             - unless that fails, fall back to terminal, perhaps with warning

- Have builtins recognize --help, skipping errors, as most external commands do.

- Consolidate all help code into a single function or module to ensure it is 
consistent everywhere.

Thanks for reading,
-Mike


On 05/08/2015 09:48 AM, fish-users-requ...@lists.sourceforge.net wrote:
>     2. Re: 5 minutes fish from 15 years bash impression (Diego Zamboni)

------------------------------------------------------------------------------
One dashboard for servers and applications across Physical-Virtual-Cloud 
Widest out-of-the-box monitoring support with 50+ applications
Performance metrics, stats and reports that give you Actionable Insights
Deep dive visibility with transaction tracing using APM Insight.
http://ad.doubleclick.net/ddm/clk/290420510;117567292;y
_______________________________________________
Fish-users mailing list
Fish-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/fish-users

Reply via email to