Re: misc/37981: shell builtin manpages are for csh(1) only...

["Jeremy C. Reed" <reed%reedmedia.net@localhost>]

The following reply was made to PR misc/37981; it has been noted by GNATS.

From: "Jeremy C. Reed" <reed%reedmedia.net@localhost>
To: gnats-bugs%NetBSD.org@localhost
Cc: 
Subject: Re: misc/37981: shell builtin manpages are for csh(1) only...
Date: Fri, 8 Feb 2008 08:57:15 -0600 (CST)

 On Fri, 8 Feb 2008, Ephaeton%gmx.net@localhost wrote:
 
 >       $ find . -inum $(stat -f %i csh.1)
 >       ./bg.1
 >       ./limit.1
 >       ./csh.1
 >       ./alias.1
 >       ./dirs.1
 >       ./fg.1
 >       ./foreach.1
 >       ./history.1
 >       ./jobs.1
 >       ./popd.1
 >       ./pushd.1
 >       ./rehash.1
 >       ./repeat.1
 >       ./suspend.1
 >       ./stop.1
 >       ./source.1
 > 
 >       $ man alias ;# --> see manpage of csh
 > 
 > >Fix:
 >      - remove links on csh.1
 
 Maybe keep csh-specific links, like limit.1, dirs.1, foreach.1, popd.1, 
 pushd.1, rehash.1, repeat.1, and source.1.
 
 Also history.1 and suspend.1 and stop.1 are csh, but there are aliases for 
 these for other shell(s).
 
 But then it could still be confusing for add-on shells (like bash).
 
 >      - maybe replace by stub manpages as sketched out above
 
 Maybe instead of several just have them link to one.
 
 Some systems have a "builtins.1" man page.
 
 But from your list above, I only see four builtin commands that are 
 generic:
 
 alias
 bg
 fg
 jobs
 
 Unless you want to also add:
 history.1
 suspend.1
 stop.1 
 
 Also a generic "builtins" page could mention echo, kill, time (not in sh 
 though) -- but no symlinks for those manpages.
 
 Another is cd.1 -- its not a link. But it only mentions csh.
 
 And where to stop? What about other common shell builtins like the 
 following?
 
 eval
 exec
 set
 umask
 wait
 
 (Should they be in the "builtins" man page too?)
 
 
 I'll work on this if anyone wants to pursue this.
 
 
   Jeremy C. Reed