* Re: zsh: bad option, bash works [not found] <4EEF2F30.7090404@ebi.ac.uk> @ 2011-12-20 0:46 ` Cameron Simpson 2011-12-20 3:54 ` Phil Pennock 0 siblings, 1 reply; 3+ messages in thread From: Cameron Simpson @ 2011-12-20 0:46 UTC (permalink / raw) To: Rich Boyce; +Cc: Community support for Fedora users, zsh-users [ CC'd to zsh-users@zsh.org. My apologies for this. - Cameron ] On 19Dec2011 12:33, Rich Boyce <rich@ebi.ac.uk> wrote: | On 18/12/11 22:11, Cameron Simpson wrote: | >On 18Dec2011 22:51, Zind<wzmindlog@gmail.com> wrote: | >| Thanks a trillion. :-) | > | >Did you consult the manual? "man "zshbuiltins" says: | | Hmm. If you're unaware that type is a builtin, when using zsh 'man | type' actually gives me BASH_BUILTINS(1). That is a bit of a clue right there. | If I don't know what a | builtin is, and read about type in there, it tells me that '-t' is a | valid option. Indeed. There's no particular clue that the options don't work for all shells. | Perhaps when you do 'man type' or any other of the builtins, you | should be shown the man page for the shell you're actually using? Ugh. Via the normal man command? Please not. Via some shell builtin (:-) alias? Maybe, provided it has big flashing lwaning lights and an indicator of how to get the "real" manual entry. Better, maybe, would be a "help" builtin for bash, zsh etc that documented builtins and other topics, and offered to divert to "man" as well (or on no hit). Hmm. I see "bash" has a help comment. Zsh doesn't. Cheers, -- Cameron Simpson <cs@zip.com.au> DoD#743 http://www.cskk.ezoshosting.com/cs/ Clymer's photographs of this procedure show a very clean head. This is a lie. There is oil in here, and lots of it. - Mike Mitten, rec.moto, 29sep1993 ^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: zsh: bad option, bash works 2011-12-20 0:46 ` zsh: bad option, bash works Cameron Simpson @ 2011-12-20 3:54 ` Phil Pennock 2011-12-20 12:03 ` Rich Boyce 0 siblings, 1 reply; 3+ messages in thread From: Phil Pennock @ 2011-12-20 3:54 UTC (permalink / raw) To: Cameron Simpson; +Cc: Rich Boyce, Community support for Fedora users, zsh-users On 2011-12-20 at 11:46 +1100, Cameron Simpson wrote: > Better, maybe, would be a "help" builtin for bash, zsh etc that > documented builtins and other topics, and offered to divert to "man" > as well (or on no hit). > > Hmm. I see "bash" has a help comment. Zsh doesn't. zsh uses the run-help function and ZLE widget, and you can choose to create per-builtin files at install time, or do so later and repoint $HELPDIR to somewhere appropriate. By default, with Emacs key-bindings, run-help is bound to Esc-H. The RPM .spec I use at $work for building zsh does this: ----------------------------8< cut here >8------------------------------ # HELPDIR support helpfiles=$PWD/Util/helpfiles pushd $RPM_BUILD_ROOT%_datadir/zsh/%srcversion && { mkdir help && cd help && \ man -M $RPM_BUILD_ROOT%_mandir zshbuiltins | colcrt - | perl $helpfiles popd } ----------------------------8< cut here >8------------------------------ So I enter "type anything at all" at a command-prompt, enter Esc-H, get the relevant documentation from the man-page, and *only* the relevant documentation, for the word in the command position and when I quit the text viewer, my command-line is still there waiting for me. If you want: alias help=run-help and you then have the help command you want. I don't know why the HELPDIR content isn't generated by default in the build-process, unless it's the Perl dependency. -- https://twitter.com/syscomet ^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: zsh: bad option, bash works 2011-12-20 3:54 ` Phil Pennock @ 2011-12-20 12:03 ` Rich Boyce 0 siblings, 0 replies; 3+ messages in thread From: Rich Boyce @ 2011-12-20 12:03 UTC (permalink / raw) To: Cameron Simpson, Community support for Fedora users, zsh-users On 20/12/11 03:54, Phil Pennock wrote: > On 2011-12-20 at 11:46 +1100, Cameron Simpson wrote: >> Better, maybe, would be a "help" builtin for bash, zsh etc that >> documented builtins and other topics, and offered to divert to "man" >> as well (or on no hit). >> >> Hmm. I see "bash" has a help comment. Zsh doesn't. > > zsh uses the run-help function and ZLE widget, and you can choose to > create per-builtin files at install time, or do so later and repoint > $HELPDIR to somewhere appropriate. > > By default, with Emacs key-bindings, run-help is bound to Esc-H. > > The RPM .spec I use at $work for building zsh does this: > ----------------------------8< cut here>8------------------------------ > # HELPDIR support > helpfiles=$PWD/Util/helpfiles > pushd $RPM_BUILD_ROOT%_datadir/zsh/%srcversion&& { > mkdir help&& cd help&& \ > man -M $RPM_BUILD_ROOT%_mandir zshbuiltins | colcrt - | perl $helpfiles > popd > } > ----------------------------8< cut here>8------------------------------ > > So I enter "type anything at all" at a command-prompt, enter Esc-H, get > the relevant documentation from the man-page, and *only* the relevant > documentation, for the word in the command position and when I quit the > text viewer, my command-line is still there waiting for me. That's a nice fix. With stock zsh, I of course get the BASH_BUILTINS man page. This seems like a bug to me, so I've filed one: https://bugzilla.redhat.com/show_bug.cgi?id=769264 Feel free to add your code as a suggested fix. Rich ^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2011-12-20 12:13 UTC | newest] Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed) -- links below jump to the message on this page -- [not found] <4EEF2F30.7090404@ebi.ac.uk> 2011-12-20 0:46 ` zsh: bad option, bash works Cameron Simpson 2011-12-20 3:54 ` Phil Pennock 2011-12-20 12:03 ` Rich Boyce
Code repositories for project(s) associated with this public inbox https://git.vuxu.org/mirror/zsh/ This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for NNTP newsgroup(s).