Re: manpages refer to source-code file?

[Matthew Dillon <dillon@xxxxxxxxxxxxxxxxxxxx>]

:i have been digging through newbus.. and wanted to know more, how it works
:(for educational purpose).
:
:so, i wanted to know where to find what i want.
:(sys/kern/subr_bus.c, for those interested and who didn't knew)
:
:do you think a section SOURCE, where the source files in the kernel (or in
:libc for that reason) are, is a good idea?
:
:i understand, that everyone working on this, should know how to search
:(ctags and such), but it might still be nice to have that in the manpages.
:
:~ibotty

    For man pages regarding kernel functions, specifying the source file
    is probably a good idea.  But, unfortunately, these man pages tend to
    be mostly out of date so the usefullness would be limited.

    Learning how newbus works is a pretty big bite.  I can barely figure it
    out myself, mainly because since everything is so disconnected its
    hard to figure out the chain of command.

    Basically there is an API specification for various layers within
    newbus, with default function assignments (the .m files you see lying
    around), and individual busses/devices declare a subset of functions 
    that they support, with any unspecified elements being automatically
    initialized to the default.

					-Matt
					Matthew Dillon 
					<dillon@xxxxxxxxxxxxx>