Re: cd --help should output the complete man page

[Jonathan Nieder]

Hi Faheem,

Faheem Mitha wrote:

>       $ cd --help
>       bash: cd: --: invalid option
>       cd: usage: cd [-L|-P] [dir]
>
> I'm don't even know how to get the usage output without
> inducing an error.

Does "help cd" do the trick?

> I think a man page might also be a good idea. You may
> also be aware that in current Debian, the bash manual is not
> packaged

"man builtins" works for me.  It might be worth a wishlist bug to
install cd.1.gz as a symlink to ../man7/builtins.7.gz.

By the way, at least on Debian, we are not quite POSIX conformant with
respect to "cd" and similar non-special builtins.  There should be a
wrapper script on the $PATH so programs using the exec family of
functions can use them (see XCU 1.6 "Built-in utilities").