cvs commit: src/sys/doc/subsys Dependencies Doxyfile-cam Doxyfile-crypto Doxyfile-dev_pci Doxyfile-dev_sound Doxyfile-dev_usb Doxyfile-geom Doxyfile-i4b Doxyfile-kern Doxyfile-libkern Doxyfile-linux Doxyfile-net80211 ...

[Robert Watson]

On Sat, 27 May 2006, Alexander Leidinger wrote:

>> There is no automatic way to make this determination, you need somebody to 
>> look at each and every function to decide it.
>
> That's the same way I think about @internal.

@internal is exactly backwards from the way API documentation should work. 
Things should be explicitly marked @external, and otherwise either be 
undocumented, or be heavily marked "NOT FOR EXTERNAL USE".

Robert N M Watson