diff options
author | netchild <netchild@FreeBSD.org> | 2006-05-28 15:25:18 +0000 |
---|---|---|
committer | netchild <netchild@FreeBSD.org> | 2006-05-28 15:25:18 +0000 |
commit | a13a275341ba58af1d15c4a955742f30713d338b (patch) | |
tree | 3397cf627973fd6fc58354bc9e8a7fea2d2325de | |
parent | 531d197d819fca6835d6d1064ceb5c53c3851741 (diff) | |
download | FreeBSD-src-a13a275341ba58af1d15c4a955742f30713d338b.zip FreeBSD-src-a13a275341ba58af1d15c4a955742f30713d338b.tar.gz |
Add a disclaimer regarding public/internal functions to every subsystem for
now.
Discussed on: cvs-all
Helped with the wording: "Ben Kaduk" <minimarmot@gmail.com>
38 files changed, 68 insertions, 34 deletions
diff --git a/sys/doc/subsys/Doxyfile-cam b/sys/doc/subsys/Doxyfile-cam index 55e7771..006cdcb 100644 --- a/sys/doc/subsys/Doxyfile-cam +++ b/sys/doc/subsys/Doxyfile-cam @@ -11,7 +11,7 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #-------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/cam/ +INPUT = $(DOXYGEN_SRC_PATH)/cam/ $(NOTREVIEWED) GENERATE_TAGFILE = cam/cam.tag diff --git a/sys/doc/subsys/Doxyfile-crypto b/sys/doc/subsys/Doxyfile-crypto index 4eadf59..f3e6c5a 100644 --- a/sys/doc/subsys/Doxyfile-crypto +++ b/sys/doc/subsys/Doxyfile-crypto @@ -11,7 +11,7 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #-------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/crypto/ +INPUT = $(DOXYGEN_SRC_PATH)/crypto/ $(NOTREVIEWED) GENERATE_TAGFILE = crypto/crypto.tag diff --git a/sys/doc/subsys/Doxyfile-dev_pci b/sys/doc/subsys/Doxyfile-dev_pci index 9690796..d8d91a7 100644 --- a/sys/doc/subsys/Doxyfile-dev_pci +++ b/sys/doc/subsys/Doxyfile-dev_pci @@ -12,7 +12,8 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled # configuration options related to the input files #--------------------------------------------------------------------------- INPUT = $(DOXYGEN_SRC_PATH)/dev/pci/ \ - $(DOXYGEN_SRC_PATH)/$(DOXYGEN_TARGET_ARCH)/pci/ + $(DOXYGEN_SRC_PATH)/$(DOXYGEN_TARGET_ARCH)/pci/ \ + $(NOTREVIEWED) GENERATE_TAGFILE = dev_pci/dev_pci.tag diff --git a/sys/doc/subsys/Doxyfile-dev_sound b/sys/doc/subsys/Doxyfile-dev_sound index 430960e..5a55398 100644 --- a/sys/doc/subsys/Doxyfile-dev_sound +++ b/sys/doc/subsys/Doxyfile-dev_sound @@ -11,7 +11,7 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #--------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/dev/sound/ +INPUT = $(DOXYGEN_SRC_PATH)/dev/sound/ $(NOTREVIEWED) GENERATE_TAGFILE = dev_sound/dev_sound.tag TAGFILES = dev_pci/dev_pci.tag=../../dev_pci/html \ diff --git a/sys/doc/subsys/Doxyfile-dev_usb b/sys/doc/subsys/Doxyfile-dev_usb index 7a05dfa..731a018 100644 --- a/sys/doc/subsys/Doxyfile-dev_usb +++ b/sys/doc/subsys/Doxyfile-dev_usb @@ -11,7 +11,7 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #--------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/dev/usb/ +INPUT = $(DOXYGEN_SRC_PATH)/dev/usb/ $(NOTREVIEWED) GENERATE_TAGFILE = dev_usb/dev_usb.tag TAGFILES = dev_pci/dev_pci.tag=../../dev_pci/html diff --git a/sys/doc/subsys/Doxyfile-geom b/sys/doc/subsys/Doxyfile-geom index 30c9c0c..374665f 100644 --- a/sys/doc/subsys/Doxyfile-geom +++ b/sys/doc/subsys/Doxyfile-geom @@ -11,7 +11,7 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #-------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/geom/ +INPUT = $(DOXYGEN_SRC_PATH)/geom/ $(NOTREVIEWED) GENERATE_TAGFILE = geom/geom.tag diff --git a/sys/doc/subsys/Doxyfile-i4b b/sys/doc/subsys/Doxyfile-i4b index 0a3251e..5573e84 100644 --- a/sys/doc/subsys/Doxyfile-i4b +++ b/sys/doc/subsys/Doxyfile-i4b @@ -11,7 +11,7 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #-------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/i4b/ +INPUT = $(DOXYGEN_SRC_PATH)/i4b/ $(NOTREVIEWED) GENERATE_TAGFILE = i4b/i4b.tag TAGFILES = dev_pci/dev_pci.tag=../../dev_pci/html diff --git a/sys/doc/subsys/Doxyfile-kern b/sys/doc/subsys/Doxyfile-kern index b2ba51f..5857465 100644 --- a/sys/doc/subsys/Doxyfile-kern +++ b/sys/doc/subsys/Doxyfile-kern @@ -11,7 +11,7 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #-------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/kern/ +INPUT = $(DOXYGEN_SRC_PATH)/kern/ $(NOTREVIEWED) GENERATE_TAGFILE = kern/kern.tag diff --git a/sys/doc/subsys/Doxyfile-libkern b/sys/doc/subsys/Doxyfile-libkern index 5191c9e..42c53de 100644 --- a/sys/doc/subsys/Doxyfile-libkern +++ b/sys/doc/subsys/Doxyfile-libkern @@ -11,7 +11,7 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #-------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/libkern/ +INPUT = $(DOXYGEN_SRC_PATH)/libkern/ $(NOTREVIEWED) GENERATE_TAGFILE = libkern/libkern.tag diff --git a/sys/doc/subsys/Doxyfile-linux b/sys/doc/subsys/Doxyfile-linux index 8de57f3..3f21047 100644 --- a/sys/doc/subsys/Doxyfile-linux +++ b/sys/doc/subsys/Doxyfile-linux @@ -11,7 +11,8 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #-------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/compat/linux $(DOXYGEN_LINUX_PATH) +INPUT = $(DOXYGEN_SRC_PATH)/compat/linux \ + $(DOXYGEN_LINUX_PATH) $(NOTREVIEWED) GENERATE_TAGFILE = linux/linux.tag diff --git a/sys/doc/subsys/Doxyfile-net80211 b/sys/doc/subsys/Doxyfile-net80211 index 75ada25..869f06b 100644 --- a/sys/doc/subsys/Doxyfile-net80211 +++ b/sys/doc/subsys/Doxyfile-net80211 @@ -11,7 +11,7 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #-------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/net80211/ +INPUT = $(DOXYGEN_SRC_PATH)/net80211/ $(NOTREVIEWED) GENERATE_TAGFILE = net80211/net80211.tag diff --git a/sys/doc/subsys/Doxyfile-netgraph b/sys/doc/subsys/Doxyfile-netgraph index b203e68..5641cb0 100644 --- a/sys/doc/subsys/Doxyfile-netgraph +++ b/sys/doc/subsys/Doxyfile-netgraph @@ -11,7 +11,7 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #-------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/netgraph/ +INPUT = $(DOXYGEN_SRC_PATH)/netgraph/ $(NOTREVIEWED) GENERATE_TAGFILE = netgraph/netgraph.tag diff --git a/sys/doc/subsys/Doxyfile-netinet b/sys/doc/subsys/Doxyfile-netinet index c5c91dc..7fedb3d 100644 --- a/sys/doc/subsys/Doxyfile-netinet +++ b/sys/doc/subsys/Doxyfile-netinet @@ -11,7 +11,7 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #-------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/netinet/ +INPUT = $(DOXYGEN_SRC_PATH)/netinet/ $(NOTREVIEWED) GENERATE_TAGFILE = netinet/netinet.tag diff --git a/sys/doc/subsys/Doxyfile-netinet6 b/sys/doc/subsys/Doxyfile-netinet6 index 57c0f8c..2f902d3 100644 --- a/sys/doc/subsys/Doxyfile-netinet6 +++ b/sys/doc/subsys/Doxyfile-netinet6 @@ -11,7 +11,7 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #-------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/netinet6/ +INPUT = $(DOXYGEN_SRC_PATH)/netinet6/ $(NOTREVIEWED) GENERATE_TAGFILE = netinet6/netinet6.tag diff --git a/sys/doc/subsys/Doxyfile-netipsec b/sys/doc/subsys/Doxyfile-netipsec index b962e2c..b7038f2 100644 --- a/sys/doc/subsys/Doxyfile-netipsec +++ b/sys/doc/subsys/Doxyfile-netipsec @@ -11,7 +11,7 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #-------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/netipsec/ +INPUT = $(DOXYGEN_SRC_PATH)/netipsec/ $(NOTREVIEWED) GENERATE_TAGFILE = netipsec/netipsec.tag diff --git a/sys/doc/subsys/Doxyfile-opencrypto b/sys/doc/subsys/Doxyfile-opencrypto index c14a59f..33f1654 100644 --- a/sys/doc/subsys/Doxyfile-opencrypto +++ b/sys/doc/subsys/Doxyfile-opencrypto @@ -11,7 +11,7 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #-------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/opencrypto/ +INPUT = $(DOXYGEN_SRC_PATH)/opencrypto/ $(NOTREVIEWED) GENERATE_TAGFILE = opencrypto/opencrypto.tag diff --git a/sys/doc/subsys/Doxyfile-vm b/sys/doc/subsys/Doxyfile-vm index c232997..22bb8c5 100644 --- a/sys/doc/subsys/Doxyfile-vm +++ b/sys/doc/subsys/Doxyfile-vm @@ -11,7 +11,7 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #--------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/vm/ +INPUT = $(DOXYGEN_SRC_PATH)/vm/ $(NOTREVIEWED) GENERATE_TAGFILE = vm/vm.tag diff --git a/sys/doc/subsys/Makefile b/sys/doc/subsys/Makefile index 35aed6c..ab6f987 100644 --- a/sys/doc/subsys/Makefile +++ b/sys/doc/subsys/Makefile @@ -92,6 +92,7 @@ ${.OBJDIR}/${target}/${target}.tag: DOXYGEN_SRC_INCLUDE_PATH="${S}/sys ${S}/../include ${S}/${TARGET_ARCH}/include" \ DOXYGEN_TARGET_ARCH=${TARGET_ARCH} \ DOXYGEN_LINUX_PATH=${DOXYGEN_LINUX_PATH} \ + NOTREVIEWED=${.CURDIR}/notreviewed.dox \ doxygen ${.CURDIR}/Doxyfile-${target} @echo "API docs for ${target} are now available in ${.OBJDIR}/${target}/." | /usr/bin/fmt diff --git a/sys/doc/subsys/notreviewed.dox b/sys/doc/subsys/notreviewed.dox new file mode 100644 index 0000000..bcc4bed --- /dev/null +++ b/sys/doc/subsys/notreviewed.dox @@ -0,0 +1,14 @@ +/* $FreeBSD$ */ + +/** @mainpage + * <b>IMPORTANT:</b> This API documentation may contain both functions which + * are public and functions that are for internal use only. Since we have not + * reviewed every part of the documentation yet, <i>some internal functions + * are not marked as such</i>. Until we finish reviewing the API documentation + * and add appropriate comments to functions which are only for internal use, + * you should take this into account. In case you want to use a function of + * this kernel subsystem in another kernel subsystem you should search for + * precedence of use outside this subsystem. If the function is not used + * outside this subsystem you should ask on the mailinglists about it, else + * you risk breaking something. + */ diff --git a/tools/kerneldoc/subsys/Doxyfile-cam b/tools/kerneldoc/subsys/Doxyfile-cam index 55e7771..006cdcb 100644 --- a/tools/kerneldoc/subsys/Doxyfile-cam +++ b/tools/kerneldoc/subsys/Doxyfile-cam @@ -11,7 +11,7 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #-------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/cam/ +INPUT = $(DOXYGEN_SRC_PATH)/cam/ $(NOTREVIEWED) GENERATE_TAGFILE = cam/cam.tag diff --git a/tools/kerneldoc/subsys/Doxyfile-crypto b/tools/kerneldoc/subsys/Doxyfile-crypto index 4eadf59..f3e6c5a 100644 --- a/tools/kerneldoc/subsys/Doxyfile-crypto +++ b/tools/kerneldoc/subsys/Doxyfile-crypto @@ -11,7 +11,7 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #-------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/crypto/ +INPUT = $(DOXYGEN_SRC_PATH)/crypto/ $(NOTREVIEWED) GENERATE_TAGFILE = crypto/crypto.tag diff --git a/tools/kerneldoc/subsys/Doxyfile-dev_pci b/tools/kerneldoc/subsys/Doxyfile-dev_pci index 9690796..d8d91a7 100644 --- a/tools/kerneldoc/subsys/Doxyfile-dev_pci +++ b/tools/kerneldoc/subsys/Doxyfile-dev_pci @@ -12,7 +12,8 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled # configuration options related to the input files #--------------------------------------------------------------------------- INPUT = $(DOXYGEN_SRC_PATH)/dev/pci/ \ - $(DOXYGEN_SRC_PATH)/$(DOXYGEN_TARGET_ARCH)/pci/ + $(DOXYGEN_SRC_PATH)/$(DOXYGEN_TARGET_ARCH)/pci/ \ + $(NOTREVIEWED) GENERATE_TAGFILE = dev_pci/dev_pci.tag diff --git a/tools/kerneldoc/subsys/Doxyfile-dev_sound b/tools/kerneldoc/subsys/Doxyfile-dev_sound index 430960e..5a55398 100644 --- a/tools/kerneldoc/subsys/Doxyfile-dev_sound +++ b/tools/kerneldoc/subsys/Doxyfile-dev_sound @@ -11,7 +11,7 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #--------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/dev/sound/ +INPUT = $(DOXYGEN_SRC_PATH)/dev/sound/ $(NOTREVIEWED) GENERATE_TAGFILE = dev_sound/dev_sound.tag TAGFILES = dev_pci/dev_pci.tag=../../dev_pci/html \ diff --git a/tools/kerneldoc/subsys/Doxyfile-dev_usb b/tools/kerneldoc/subsys/Doxyfile-dev_usb index 7a05dfa..731a018 100644 --- a/tools/kerneldoc/subsys/Doxyfile-dev_usb +++ b/tools/kerneldoc/subsys/Doxyfile-dev_usb @@ -11,7 +11,7 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #--------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/dev/usb/ +INPUT = $(DOXYGEN_SRC_PATH)/dev/usb/ $(NOTREVIEWED) GENERATE_TAGFILE = dev_usb/dev_usb.tag TAGFILES = dev_pci/dev_pci.tag=../../dev_pci/html diff --git a/tools/kerneldoc/subsys/Doxyfile-geom b/tools/kerneldoc/subsys/Doxyfile-geom index 30c9c0c..374665f 100644 --- a/tools/kerneldoc/subsys/Doxyfile-geom +++ b/tools/kerneldoc/subsys/Doxyfile-geom @@ -11,7 +11,7 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #-------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/geom/ +INPUT = $(DOXYGEN_SRC_PATH)/geom/ $(NOTREVIEWED) GENERATE_TAGFILE = geom/geom.tag diff --git a/tools/kerneldoc/subsys/Doxyfile-i4b b/tools/kerneldoc/subsys/Doxyfile-i4b index 0a3251e..5573e84 100644 --- a/tools/kerneldoc/subsys/Doxyfile-i4b +++ b/tools/kerneldoc/subsys/Doxyfile-i4b @@ -11,7 +11,7 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #-------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/i4b/ +INPUT = $(DOXYGEN_SRC_PATH)/i4b/ $(NOTREVIEWED) GENERATE_TAGFILE = i4b/i4b.tag TAGFILES = dev_pci/dev_pci.tag=../../dev_pci/html diff --git a/tools/kerneldoc/subsys/Doxyfile-kern b/tools/kerneldoc/subsys/Doxyfile-kern index b2ba51f..5857465 100644 --- a/tools/kerneldoc/subsys/Doxyfile-kern +++ b/tools/kerneldoc/subsys/Doxyfile-kern @@ -11,7 +11,7 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #-------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/kern/ +INPUT = $(DOXYGEN_SRC_PATH)/kern/ $(NOTREVIEWED) GENERATE_TAGFILE = kern/kern.tag diff --git a/tools/kerneldoc/subsys/Doxyfile-libkern b/tools/kerneldoc/subsys/Doxyfile-libkern index 5191c9e..42c53de 100644 --- a/tools/kerneldoc/subsys/Doxyfile-libkern +++ b/tools/kerneldoc/subsys/Doxyfile-libkern @@ -11,7 +11,7 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #-------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/libkern/ +INPUT = $(DOXYGEN_SRC_PATH)/libkern/ $(NOTREVIEWED) GENERATE_TAGFILE = libkern/libkern.tag diff --git a/tools/kerneldoc/subsys/Doxyfile-linux b/tools/kerneldoc/subsys/Doxyfile-linux index 8de57f3..3f21047 100644 --- a/tools/kerneldoc/subsys/Doxyfile-linux +++ b/tools/kerneldoc/subsys/Doxyfile-linux @@ -11,7 +11,8 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #-------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/compat/linux $(DOXYGEN_LINUX_PATH) +INPUT = $(DOXYGEN_SRC_PATH)/compat/linux \ + $(DOXYGEN_LINUX_PATH) $(NOTREVIEWED) GENERATE_TAGFILE = linux/linux.tag diff --git a/tools/kerneldoc/subsys/Doxyfile-net80211 b/tools/kerneldoc/subsys/Doxyfile-net80211 index 75ada25..869f06b 100644 --- a/tools/kerneldoc/subsys/Doxyfile-net80211 +++ b/tools/kerneldoc/subsys/Doxyfile-net80211 @@ -11,7 +11,7 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #-------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/net80211/ +INPUT = $(DOXYGEN_SRC_PATH)/net80211/ $(NOTREVIEWED) GENERATE_TAGFILE = net80211/net80211.tag diff --git a/tools/kerneldoc/subsys/Doxyfile-netgraph b/tools/kerneldoc/subsys/Doxyfile-netgraph index b203e68..5641cb0 100644 --- a/tools/kerneldoc/subsys/Doxyfile-netgraph +++ b/tools/kerneldoc/subsys/Doxyfile-netgraph @@ -11,7 +11,7 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #-------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/netgraph/ +INPUT = $(DOXYGEN_SRC_PATH)/netgraph/ $(NOTREVIEWED) GENERATE_TAGFILE = netgraph/netgraph.tag diff --git a/tools/kerneldoc/subsys/Doxyfile-netinet b/tools/kerneldoc/subsys/Doxyfile-netinet index c5c91dc..7fedb3d 100644 --- a/tools/kerneldoc/subsys/Doxyfile-netinet +++ b/tools/kerneldoc/subsys/Doxyfile-netinet @@ -11,7 +11,7 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #-------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/netinet/ +INPUT = $(DOXYGEN_SRC_PATH)/netinet/ $(NOTREVIEWED) GENERATE_TAGFILE = netinet/netinet.tag diff --git a/tools/kerneldoc/subsys/Doxyfile-netinet6 b/tools/kerneldoc/subsys/Doxyfile-netinet6 index 57c0f8c..2f902d3 100644 --- a/tools/kerneldoc/subsys/Doxyfile-netinet6 +++ b/tools/kerneldoc/subsys/Doxyfile-netinet6 @@ -11,7 +11,7 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #-------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/netinet6/ +INPUT = $(DOXYGEN_SRC_PATH)/netinet6/ $(NOTREVIEWED) GENERATE_TAGFILE = netinet6/netinet6.tag diff --git a/tools/kerneldoc/subsys/Doxyfile-netipsec b/tools/kerneldoc/subsys/Doxyfile-netipsec index b962e2c..b7038f2 100644 --- a/tools/kerneldoc/subsys/Doxyfile-netipsec +++ b/tools/kerneldoc/subsys/Doxyfile-netipsec @@ -11,7 +11,7 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #-------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/netipsec/ +INPUT = $(DOXYGEN_SRC_PATH)/netipsec/ $(NOTREVIEWED) GENERATE_TAGFILE = netipsec/netipsec.tag diff --git a/tools/kerneldoc/subsys/Doxyfile-opencrypto b/tools/kerneldoc/subsys/Doxyfile-opencrypto index c14a59f..33f1654 100644 --- a/tools/kerneldoc/subsys/Doxyfile-opencrypto +++ b/tools/kerneldoc/subsys/Doxyfile-opencrypto @@ -11,7 +11,7 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #-------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/opencrypto/ +INPUT = $(DOXYGEN_SRC_PATH)/opencrypto/ $(NOTREVIEWED) GENERATE_TAGFILE = opencrypto/opencrypto.tag diff --git a/tools/kerneldoc/subsys/Doxyfile-vm b/tools/kerneldoc/subsys/Doxyfile-vm index c232997..22bb8c5 100644 --- a/tools/kerneldoc/subsys/Doxyfile-vm +++ b/tools/kerneldoc/subsys/Doxyfile-vm @@ -11,7 +11,7 @@ EXTRACT_ALL = YES # for undocumented src, no warnings enabled #--------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = $(DOXYGEN_SRC_PATH)/vm/ +INPUT = $(DOXYGEN_SRC_PATH)/vm/ $(NOTREVIEWED) GENERATE_TAGFILE = vm/vm.tag diff --git a/tools/kerneldoc/subsys/Makefile b/tools/kerneldoc/subsys/Makefile index 35aed6c..ab6f987 100644 --- a/tools/kerneldoc/subsys/Makefile +++ b/tools/kerneldoc/subsys/Makefile @@ -92,6 +92,7 @@ ${.OBJDIR}/${target}/${target}.tag: DOXYGEN_SRC_INCLUDE_PATH="${S}/sys ${S}/../include ${S}/${TARGET_ARCH}/include" \ DOXYGEN_TARGET_ARCH=${TARGET_ARCH} \ DOXYGEN_LINUX_PATH=${DOXYGEN_LINUX_PATH} \ + NOTREVIEWED=${.CURDIR}/notreviewed.dox \ doxygen ${.CURDIR}/Doxyfile-${target} @echo "API docs for ${target} are now available in ${.OBJDIR}/${target}/." | /usr/bin/fmt diff --git a/tools/kerneldoc/subsys/notreviewed.dox b/tools/kerneldoc/subsys/notreviewed.dox new file mode 100644 index 0000000..bcc4bed --- /dev/null +++ b/tools/kerneldoc/subsys/notreviewed.dox @@ -0,0 +1,14 @@ +/* $FreeBSD$ */ + +/** @mainpage + * <b>IMPORTANT:</b> This API documentation may contain both functions which + * are public and functions that are for internal use only. Since we have not + * reviewed every part of the documentation yet, <i>some internal functions + * are not marked as such</i>. Until we finish reviewing the API documentation + * and add appropriate comments to functions which are only for internal use, + * you should take this into account. In case you want to use a function of + * this kernel subsystem in another kernel subsystem you should search for + * precedence of use outside this subsystem. If the function is not used + * outside this subsystem you should ask on the mailinglists about it, else + * you risk breaking something. + */ |