> X>
>
> Boyd Adamson wrote:
> > On 3/12/07, Roland Mainz <roland.mainz at nrubsig.org> wrote:
> > > Is there any special manual page section for:
> > > 1. shell functions (e.g. $ function foobar { echo "blabla" ; } #)
> > > 2. math shell functions (e.g. $ print $(( cos(666) )) #)
> > >
> > > [1] is close to normal commands (e.g. shell functions behave in many
> > > cases just like normal commands) while [2] are closer to normal C/C++
> > > library functions... but I am still not sure how I should categorise
> > > this stuff...
> >
> > Since both of them are (I presume) specific to ksh93, rather than
> > available for general use (e.g. callable from C programs directly) I
> > wonder whether a new section may be suited -- 1ksh or something?
>
> This isn't really ksh93-specific... or better: My question targets
> ksh93's new C99 math functions but I think we have a more general issue
> to solve first since are other shells like bash and zsh which have
> similar facilities.
>
> If there is no such thing... what about adding a section like "3SHELL"
> and "3SHELLMATH" for the two types (or "1SHELLFUNC"... but that would
> not be consistent since shell functions in ksh93/bash/zsh are loadable
> on demand. Using something like "3KSH93SHELL" sounds like an overkill
> and is slightly problematic since normal shell functions can be shared
> between implementations of the POSIX shell if they restrict themselves
> to the POSIX subset of their functionality) ?
>
> ----
We generally document shell commands on the particular shell man page. For
example, we document the csh built-in commands on csh(1) and the ksh built-in
commands on ksh(1). We also have a shell_builtins(1) man page that lists the
built-in commands for all the shells. If a particular built-in command is
also present as a binary, then we have a separate man page for that command/
utility in section 1 as well.
As for the math functions, they are all documented in section 3m.
Hope this helps.
Doug Stevenson
Senior man page Writer
SunOS man pages
document the
