[Midnightbsd-cvs] src: tools/kerneldoc: Add Doxygen kernel documentation framework (was in
laffer1 at midnightbsd.org
laffer1 at midnightbsd.org
Mon Sep 15 20:50:15 EDT 2008
Log Message:
-----------
Add Doxygen kernel documentation framework (was in src/sys/doc)
Added Files:
-----------
src/tools/kerneldoc:
Doxyfile (r1.1)
Makefile (r1.1)
src/tools/kerneldoc/subsys:
Dependencies (r1.1)
Doxyfile-cam (r1.1)
Doxyfile-crypto (r1.1)
Doxyfile-dev_pci (r1.1)
Doxyfile-dev_sound (r1.1)
Doxyfile-dev_usb (r1.1)
Doxyfile-geom (r1.1)
Doxyfile-i4b (r1.1)
Doxyfile-kern (r1.1)
Doxyfile-libkern (r1.1)
Doxyfile-linux (r1.1)
Doxyfile-net80211 (r1.1)
Doxyfile-netgraph (r1.1)
Doxyfile-netinet (r1.1)
Doxyfile-netinet6 (r1.1)
Doxyfile-netipsec (r1.1)
Doxyfile-opencrypto (r1.1)
Doxyfile-vm (r1.1)
Makefile (r1.1)
README (r1.1)
common-Doxyfile (r1.1)
notreviewed.dox (r1.1)
-------------- next part --------------
--- /dev/null
+++ tools/kerneldoc/Makefile
@@ -0,0 +1,31 @@
+# $MidnightBSD: src/tools/kerneldoc/Makefile,v 1.1 2008/09/16 00:50:12 laffer1 Exp $
+# $FreeBSD: src/tools/kerneldoc/Makefile,v 1.2 2006/07/08 12:31:33 netchild Exp $
+
+.PATH: ${.CURDIR}/../kern
+
+SRCS+= kern
+SRCS+= sys
+MFILES+= device_if.m
+MFILES+= bus_if.m
+
+all: ${MFILES:T:S/.m/.h/} ${SRCS}
+ doxygen
+
+LN?= ln
+AWK?= awk
+S?= ${.CURDIR}/..
+
+CLEANFILES+= ${SRCS}
+.for dir in ${SRCS}
+${dir}:
+ ${LN} -sf ${.CURDIR}/../${dir} .
+.endfor
+
+.for mfile in ${MFILES}
+CLEANFILES+= ${mfile:T:S/.m$/.h/}
+${mfile:T:S/.m$/.h/}: ${mfile}
+ ${AWK} -f $S/tools/makeobjops.awk $> -h
+.endfor
+
+clean::
+ rm -f ${CLEANFILES}
--- /dev/null
+++ tools/kerneldoc/Doxyfile
@@ -0,0 +1,212 @@
+# Doxyfile 1.3.6
+# $FreeBSD: src/tools/kerneldoc/Doxyfile,v 1.2 2006/07/08 12:31:33 netchild Exp $
+# $MidnightBSD: src/tools/kerneldoc/Doxyfile,v 1.1 2008/09/16 00:50:12 laffer1 Exp $
+
+#---------------------------------------------------------------------------
+# Project related configuration options
+#---------------------------------------------------------------------------
+PROJECT_NAME = "MidnightBSD Kernel"
+PROJECT_NUMBER =
+OUTPUT_DIRECTORY =
+OUTPUT_LANGUAGE = English
+USE_WINDOWS_ENCODING = NO
+BRIEF_MEMBER_DESC = YES
+REPEAT_BRIEF = YES
+ABBREVIATE_BRIEF =
+ALWAYS_DETAILED_SEC = NO
+INLINE_INHERITED_MEMB = NO
+FULL_PATH_NAMES = YES
+STRIP_FROM_PATH =
+SHORT_NAMES = NO
+JAVADOC_AUTOBRIEF = NO
+MULTILINE_CPP_IS_BRIEF = NO
+DETAILS_AT_TOP = NO
+INHERIT_DOCS = YES
+DISTRIBUTE_GROUP_DOC = NO
+TAB_SIZE = 8
+ALIASES =
+OPTIMIZE_OUTPUT_FOR_C = YES
+OPTIMIZE_OUTPUT_JAVA = NO
+SUBGROUPING = YES
+#---------------------------------------------------------------------------
+# Build related configuration options
+#---------------------------------------------------------------------------
+EXTRACT_ALL = YES
+EXTRACT_PRIVATE = NO
+EXTRACT_STATIC = YES
+EXTRACT_LOCAL_CLASSES = YES
+HIDE_UNDOC_MEMBERS = NO
+HIDE_UNDOC_CLASSES = NO
+HIDE_FRIEND_COMPOUNDS = NO
+HIDE_IN_BODY_DOCS = NO
+INTERNAL_DOCS = YES
+CASE_SENSE_NAMES = YES
+HIDE_SCOPE_NAMES = NO
+SHOW_INCLUDE_FILES = YES
+INLINE_INFO = YES
+SORT_MEMBER_DOCS = YES
+SORT_BRIEF_DOCS = NO
+SORT_BY_SCOPE_NAME = NO
+GENERATE_TODOLIST = YES
+GENERATE_TESTLIST = YES
+GENERATE_BUGLIST = YES
+GENERATE_DEPRECATEDLIST= YES
+ENABLED_SECTIONS =
+MAX_INITIALIZER_LINES = 30
+SHOW_USED_FILES = YES
+#---------------------------------------------------------------------------
+# configuration options related to warning and progress messages
+#---------------------------------------------------------------------------
+QUIET = NO
+WARNINGS = YES
+WARN_IF_UNDOCUMENTED = NO
+WARN_IF_DOC_ERROR = NO
+WARN_FORMAT = "$file:$line: $text"
+WARN_LOGFILE =
+#---------------------------------------------------------------------------
+# configuration options related to the input files
+#---------------------------------------------------------------------------
+INPUT =
+FILE_PATTERNS = *.c \
+ *.h
+RECURSIVE = YES
+EXCLUDE =
+EXCLUDE_SYMLINKS = NO
+EXCLUDE_PATTERNS =
+EXAMPLE_PATH =
+EXAMPLE_PATTERNS =
+EXAMPLE_RECURSIVE = NO
+IMAGE_PATH =
+INPUT_FILTER =
+FILTER_SOURCE_FILES = NO
+#---------------------------------------------------------------------------
+# configuration options related to source browsing
+#---------------------------------------------------------------------------
+SOURCE_BROWSER = YES
+INLINE_SOURCES = NO
+STRIP_CODE_COMMENTS = YES
+REFERENCED_BY_RELATION = YES
+REFERENCES_RELATION = YES
+VERBATIM_HEADERS = YES
+#---------------------------------------------------------------------------
+# configuration options related to the alphabetical class index
+#---------------------------------------------------------------------------
+ALPHABETICAL_INDEX = YES
+COLS_IN_ALPHA_INDEX = 5
+IGNORE_PREFIX =
+#---------------------------------------------------------------------------
+# configuration options related to the HTML output
+#---------------------------------------------------------------------------
+GENERATE_HTML = YES
+HTML_OUTPUT = html
+HTML_FILE_EXTENSION = .html
+HTML_HEADER =
+HTML_FOOTER =
+HTML_STYLESHEET =
+HTML_ALIGN_MEMBERS = YES
+GENERATE_HTMLHELP = NO
+CHM_FILE =
+HHC_LOCATION =
+GENERATE_CHI = NO
+BINARY_TOC = NO
+TOC_EXPAND = NO
+DISABLE_INDEX = NO
+ENUM_VALUES_PER_LINE = 4
+GENERATE_TREEVIEW = NO
+TREEVIEW_WIDTH = 250
+#---------------------------------------------------------------------------
+# configuration options related to the LaTeX output
+#---------------------------------------------------------------------------
+GENERATE_LATEX = NO
+LATEX_OUTPUT = latex
+LATEX_CMD_NAME = latex
+MAKEINDEX_CMD_NAME = makeindex
+COMPACT_LATEX = NO
+PAPER_TYPE = a4wide
+EXTRA_PACKAGES =
+LATEX_HEADER =
+PDF_HYPERLINKS = NO
+USE_PDFLATEX = NO
+LATEX_BATCHMODE = NO
+LATEX_HIDE_INDICES = NO
+#---------------------------------------------------------------------------
+# configuration options related to the RTF output
+#---------------------------------------------------------------------------
+GENERATE_RTF = NO
+RTF_OUTPUT = rtf
+COMPACT_RTF = NO
+RTF_HYPERLINKS = NO
+RTF_STYLESHEET_FILE =
+RTF_EXTENSIONS_FILE =
+#---------------------------------------------------------------------------
+# configuration options related to the man page output
+#---------------------------------------------------------------------------
+GENERATE_MAN = NO
+MAN_OUTPUT = man
+MAN_EXTENSION = .3
+MAN_LINKS = NO
+#---------------------------------------------------------------------------
+# configuration options related to the XML output
+#---------------------------------------------------------------------------
+GENERATE_XML = NO
+XML_OUTPUT = xml
+XML_SCHEMA =
+XML_DTD =
+XML_PROGRAMLISTING = YES
+#---------------------------------------------------------------------------
+# configuration options for the AutoGen Definitions output
+#---------------------------------------------------------------------------
+GENERATE_AUTOGEN_DEF = NO
+#---------------------------------------------------------------------------
+# configuration options related to the Perl module output
+#---------------------------------------------------------------------------
+GENERATE_PERLMOD = NO
+PERLMOD_LATEX = NO
+PERLMOD_PRETTY = YES
+PERLMOD_MAKEVAR_PREFIX =
+#---------------------------------------------------------------------------
+# Configuration options related to the preprocessor
+#---------------------------------------------------------------------------
+ENABLE_PREPROCESSING = YES
+MACRO_EXPANSION = NO
+EXPAND_ONLY_PREDEF = NO
+SEARCH_INCLUDES = YES
+INCLUDE_PATH =
+INCLUDE_FILE_PATTERNS =
+PREDEFINED = _KERNEL
+EXPAND_AS_DEFINED =
+SKIP_FUNCTION_MACROS = YES
+#---------------------------------------------------------------------------
+# Configuration::additions related to external references
+#---------------------------------------------------------------------------
+TAGFILES =
+GENERATE_TAGFILE = kernel.tags
+ALLEXTERNALS = NO
+EXTERNAL_GROUPS = YES
+PERL_PATH = /usr/bin/perl
+#---------------------------------------------------------------------------
+# Configuration options related to the dot tool
+#---------------------------------------------------------------------------
+CLASS_DIAGRAMS = YES
+HIDE_UNDOC_RELATIONS = YES
+HAVE_DOT = NO
+CLASS_GRAPH = YES
+COLLABORATION_GRAPH = YES
+UML_LOOK = NO
+TEMPLATE_RELATIONS = NO
+INCLUDE_GRAPH = YES
+INCLUDED_BY_GRAPH = YES
+CALL_GRAPH = NO
+GRAPHICAL_HIERARCHY = YES
+DOT_IMAGE_FORMAT = png
+DOT_PATH =
+DOTFILE_DIRS =
+MAX_DOT_GRAPH_WIDTH = 1024
+MAX_DOT_GRAPH_HEIGHT = 1024
+MAX_DOT_GRAPH_DEPTH = 0
+GENERATE_LEGEND = YES
+DOT_CLEANUP = YES
+#---------------------------------------------------------------------------
+# Configuration::additions related to the search engine
+#---------------------------------------------------------------------------
+SEARCHENGINE = NO
--- /dev/null
+++ tools/kerneldoc/subsys/Doxyfile-dev_usb
@@ -0,0 +1,22 @@
+# Doxyfile 1.4.1
+
+# $MidnightBSD: src/tools/kerneldoc/subsys/Doxyfile-dev_usb,v 1.1 2008/09/16 00:50:12 laffer1 Exp $
+# $FreeBSD: src/tools/kerneldoc/subsys/Doxyfile-dev_usb,v 1.3 2006/07/08 12:31:33 netchild Exp $
+
+#---------------------------------------------------------------------------
+# Project related configuration options
+#---------------------------------------------------------------------------
+PROJECT_NAME = "MidnightBSD kernel usb device Code"
+OUTPUT_DIRECTORY = $(DOXYGEN_DEST_PATH)/dev_usb/
+EXTRACT_ALL = YES # for undocumented src, no warnings enabled
+#---------------------------------------------------------------------------
+# configuration options related to the input files
+#---------------------------------------------------------------------------
+INPUT = $(DOXYGEN_SRC_PATH)/dev/usb/ $(NOTREVIEWED)
+
+GENERATE_TAGFILE = dev_usb/dev_usb.tag
+TAGFILES = dev_pci/dev_pci.tag=../../dev_pci/html
+
+ at INCLUDE_PATH = $(DOXYGEN_INCLUDE_PATH)
+ at INCLUDE = common-Doxyfile
+
--- /dev/null
+++ tools/kerneldoc/subsys/Doxyfile-cam
@@ -0,0 +1,21 @@
+# Doxyfile 1.4.1
+
+# $MidnightBSD: src/tools/kerneldoc/subsys/Doxyfile-cam,v 1.1 2008/09/16 00:50:12 laffer1 Exp $
+# $FreeBSD: src/tools/kerneldoc/subsys/Doxyfile-cam,v 1.3 2006/07/08 12:31:33 netchild Exp $
+
+#---------------------------------------------------------------------------
+# Project related configuration options
+#---------------------------------------------------------------------------
+PROJECT_NAME = "MidnightBSD kernel CAM code"
+OUTPUT_DIRECTORY = $(DOXYGEN_DEST_PATH)/cam/
+EXTRACT_ALL = YES # for undocumented src, no warnings enabled
+#--------------------------------------------------------------------------
+# configuration options related to the input files
+#---------------------------------------------------------------------------
+INPUT = $(DOXYGEN_SRC_PATH)/cam/ $(NOTREVIEWED)
+
+GENERATE_TAGFILE = cam/cam.tag
+
+ at INCLUDE_PATH = $(DOXYGEN_INCLUDE_PATH)
+ at INCLUDE = common-Doxyfile
+
--- /dev/null
+++ tools/kerneldoc/subsys/Doxyfile-net80211
@@ -0,0 +1,21 @@
+# Doxyfile 1.4.1
+
+# $MidnightBSD: src/tools/kerneldoc/subsys/Doxyfile-net80211,v 1.1 2008/09/16 00:50:12 laffer1 Exp $
+# $FreeBSD: src/tools/kerneldoc/subsys/Doxyfile-net80211,v 1.3 2006/07/08 12:31:33 netchild Exp $
+
+#---------------------------------------------------------------------------
+# Project related configuration options
+#---------------------------------------------------------------------------
+PROJECT_NAME = "MidnightBSD kernel WLAN code"
+OUTPUT_DIRECTORY = $(DOXYGEN_DEST_PATH)/net80211/
+EXTRACT_ALL = YES # for undocumented src, no warnings enabled
+#--------------------------------------------------------------------------
+# configuration options related to the input files
+#---------------------------------------------------------------------------
+INPUT = $(DOXYGEN_SRC_PATH)/net80211/ $(NOTREVIEWED)
+
+GENERATE_TAGFILE = net80211/net80211.tag
+
+ at INCLUDE_PATH = $(DOXYGEN_INCLUDE_PATH)
+ at INCLUDE = common-Doxyfile
+
--- /dev/null
+++ tools/kerneldoc/subsys/Doxyfile-libkern
@@ -0,0 +1,21 @@
+# Doxyfile 1.4.1
+
+# $MidnightBSD: src/tools/kerneldoc/subsys/Doxyfile-libkern,v 1.1 2008/09/16 00:50:12 laffer1 Exp $
+# $FreeBSD: src/tools/kerneldoc/subsys/Doxyfile-libkern,v 1.3 2006/07/08 12:31:33 netchild Exp $
+
+#---------------------------------------------------------------------------
+# Project related configuration options
+#---------------------------------------------------------------------------
+PROJECT_NAME = "MidnightBSD kernel libkern code"
+OUTPUT_DIRECTORY = $(DOXYGEN_DEST_PATH)/libkern/
+EXTRACT_ALL = YES # for undocumented src, no warnings enabled
+#--------------------------------------------------------------------------
+# configuration options related to the input files
+#---------------------------------------------------------------------------
+INPUT = $(DOXYGEN_SRC_PATH)/libkern/ $(NOTREVIEWED)
+
+GENERATE_TAGFILE = libkern/libkern.tag
+
+ at INCLUDE_PATH = $(DOXYGEN_INCLUDE_PATH)
+ at INCLUDE = common-Doxyfile
+
--- /dev/null
+++ tools/kerneldoc/subsys/Doxyfile-crypto
@@ -0,0 +1,21 @@
+# Doxyfile 1.4.1
+
+# $MidnightBSD: src/tools/kerneldoc/subsys/Doxyfile-crypto,v 1.1 2008/09/16 00:50:12 laffer1 Exp $
+# $FreeBSD: src/tools/kerneldoc/subsys/Doxyfile-crypto,v 1.3 2006/07/08 12:31:33 netchild Exp $
+
+#---------------------------------------------------------------------------
+# Project related configuration options
+#---------------------------------------------------------------------------
+PROJECT_NAME = "MidnightBSD kernel crypto code"
+OUTPUT_DIRECTORY = $(DOXYGEN_DEST_PATH)/crypto/
+EXTRACT_ALL = YES # for undocumented src, no warnings enabled
+#--------------------------------------------------------------------------
+# configuration options related to the input files
+#---------------------------------------------------------------------------
+INPUT = $(DOXYGEN_SRC_PATH)/crypto/ $(NOTREVIEWED)
+
+GENERATE_TAGFILE = crypto/crypto.tag
+
+ at INCLUDE_PATH = $(DOXYGEN_INCLUDE_PATH)
+ at INCLUDE = common-Doxyfile
+
--- /dev/null
+++ tools/kerneldoc/subsys/Doxyfile-kern
@@ -0,0 +1,21 @@
+# Doxyfile 1.4.1
+
+# $MidnightBSD: src/tools/kerneldoc/subsys/Doxyfile-kern,v 1.1 2008/09/16 00:50:12 laffer1 Exp $
+# $FreeBSD: src/tools/kerneldoc/subsys/Doxyfile-kern,v 1.3 2006/07/08 12:31:33 netchild Exp $
+
+#---------------------------------------------------------------------------
+# Project related configuration options
+#---------------------------------------------------------------------------
+PROJECT_NAME = "MidnightBSD kernel kern code"
+OUTPUT_DIRECTORY = $(DOXYGEN_DEST_PATH)/kern/
+EXTRACT_ALL = YES # for undocumented src, no warnings enabled
+#--------------------------------------------------------------------------
+# configuration options related to the input files
+#---------------------------------------------------------------------------
+INPUT = $(DOXYGEN_SRC_PATH)/kern/ $(NOTREVIEWED)
+
+GENERATE_TAGFILE = kern/kern.tag
+
+ at INCLUDE_PATH = $(DOXYGEN_INCLUDE_PATH)
+ at INCLUDE = common-Doxyfile
+
--- /dev/null
+++ tools/kerneldoc/subsys/Doxyfile-geom
@@ -0,0 +1,21 @@
+# Doxyfile 1.4.1
+
+# $MidnightBSD: src/tools/kerneldoc/subsys/Doxyfile-geom,v 1.1 2008/09/16 00:50:12 laffer1 Exp $
+# $FreeBSD: src/tools/kerneldoc/subsys/Doxyfile-geom,v 1.3 2006/07/08 12:31:33 netchild Exp $
+
+#---------------------------------------------------------------------------
+# Project related configuration options
+#---------------------------------------------------------------------------
+PROJECT_NAME = "MidnightBSD kernel GEOM code"
+OUTPUT_DIRECTORY = $(DOXYGEN_DEST_PATH)/geom/
+EXTRACT_ALL = YES # for undocumented src, no warnings enabled
+#--------------------------------------------------------------------------
+# configuration options related to the input files
+#---------------------------------------------------------------------------
+INPUT = $(DOXYGEN_SRC_PATH)/geom/ $(NOTREVIEWED)
+
+GENERATE_TAGFILE = geom/geom.tag
+
+ at INCLUDE_PATH = $(DOXYGEN_INCLUDE_PATH)
+ at INCLUDE = common-Doxyfile
+
--- /dev/null
+++ tools/kerneldoc/subsys/common-Doxyfile
@@ -0,0 +1,267 @@
+# Doxyfile 1.4.1
+
+# $MidnightBSD: src/tools/kerneldoc/subsys/common-Doxyfile,v 1.1 2008/09/16 00:50:12 laffer1 Exp $
+# $FreeBSD: src/tools/kerneldoc/subsys/common-Doxyfile,v 1.2 2006/07/08 12:31:33 netchild Exp $
+
+#---------------------------------------------------------------------------
+# Project related configuration options
+#---------------------------------------------------------------------------
+PROJECT_NUMBER =
+CREATE_SUBDIRS = YES
+OUTPUT_LANGUAGE = English
+USE_WINDOWS_ENCODING = NO
+BRIEF_MEMBER_DESC = YES
+REPEAT_BRIEF = YES
+ABBREVIATE_BRIEF = "The $name class" \
+ "The $name widget" \
+ "The $name file" \
+ is \
+ provides \
+ specifies \
+ contains \
+ represents \
+ a \
+ an \
+ the
+ALWAYS_DETAILED_SEC = NO
+INLINE_INHERITED_MEMB = NO
+FULL_PATH_NAMES = YES
+STRIP_FROM_PATH =
+STRIP_FROM_INC_PATH =
+SHORT_NAMES = NO
+JAVADOC_AUTOBRIEF = NO
+MULTILINE_CPP_IS_BRIEF = NO
+DETAILS_AT_TOP = NO
+INHERIT_DOCS = YES
+DISTRIBUTE_GROUP_DOC = NO
+TAB_SIZE = 8
+ALIASES =
+OPTIMIZE_OUTPUT_FOR_C = YES
+OPTIMIZE_OUTPUT_JAVA = NO
+SUBGROUPING = YES
+#---------------------------------------------------------------------------
+# Build related configuration options
+#---------------------------------------------------------------------------
+EXTRACT_PRIVATE = YES
+EXTRACT_STATIC = YES
+EXTRACT_LOCAL_CLASSES = YES
+EXTRACT_LOCAL_METHODS = NO
+HIDE_UNDOC_MEMBERS = NO
+HIDE_UNDOC_CLASSES = NO
+HIDE_FRIEND_COMPOUNDS = NO
+HIDE_IN_BODY_DOCS = NO
+INTERNAL_DOCS = YES
+CASE_SENSE_NAMES = YES
+HIDE_SCOPE_NAMES = NO
+SHOW_INCLUDE_FILES = YES
+INLINE_INFO = YES
+SORT_MEMBER_DOCS = YES
+SORT_BRIEF_DOCS = NO
+SORT_BY_SCOPE_NAME = NO
+GENERATE_TODOLIST = YES
+GENERATE_TESTLIST = YES
+GENERATE_BUGLIST = YES
+GENERATE_DEPRECATEDLIST= YES
+ENABLED_SECTIONS =
+MAX_INITIALIZER_LINES = 30
+SHOW_USED_FILES = YES
+SHOW_DIRECTORIES = YES
+FILE_VERSION_FILTER =
+#---------------------------------------------------------------------------
+# configuration options related to warning and progress messages
+#---------------------------------------------------------------------------
+QUIET = NO
+WARNINGS = YES
+WARN_IF_UNDOCUMENTED = YES
+WARN_IF_DOC_ERROR = YES
+WARN_NO_PARAMDOC = NO
+WARN_FORMAT = "$file:$line: $text"
+WARN_LOGFILE =
+#---------------------------------------------------------------------------
+# configuration options related to the input files
+#---------------------------------------------------------------------------
+FILE_PATTERNS = *.c \
+ *.cc \
+ *.cxx \
+ *.cpp \
+ *.c++ \
+ *.java \
+ *.ii \
+ *.ixx \
+ *.ipp \
+ *.i++ \
+ *.inl \
+ *.h \
+ *.hh \
+ *.hxx \
+ *.hpp \
+ *.h++ \
+ *.idl \
+ *.odl \
+ *.cs \
+ *.php \
+ *.php3 \
+ *.inc \
+ *.m \
+ *.mm \
+ *.dox \
+ *.C \
+ *.CC \
+ *.C++ \
+ *.II \
+ *.I++ \
+ *.H \
+ *.HH \
+ *.H++ \
+ *.CS \
+ *.PHP \
+ *.PHP3 \
+ *.M \
+ *.MM
+RECURSIVE = YES
+EXCLUDE =
+EXCLUDE_SYMLINKS = NO
+EXCLUDE_PATTERNS = */.\#*
+EXAMPLE_PATH =
+EXAMPLE_PATTERNS = *
+EXAMPLE_RECURSIVE = NO
+IMAGE_PATH =
+INPUT_FILTER =
+FILTER_PATTERNS =
+FILTER_SOURCE_FILES = NO
+#---------------------------------------------------------------------------
+# configuration options related to source browsing
+#---------------------------------------------------------------------------
+SOURCE_BROWSER = YES
+INLINE_SOURCES = NO
+STRIP_CODE_COMMENTS = YES
+REFERENCED_BY_RELATION = YES
+REFERENCES_RELATION = YES
+VERBATIM_HEADERS = YES
+#---------------------------------------------------------------------------
+# configuration options related to the alphabetical class index
+#---------------------------------------------------------------------------
+ALPHABETICAL_INDEX = NO
+COLS_IN_ALPHA_INDEX = 5
+IGNORE_PREFIX =
+#---------------------------------------------------------------------------
+# configuration options related to the HTML output
+#---------------------------------------------------------------------------
+GENERATE_HTML = YES
+HTML_OUTPUT = html
+HTML_FILE_EXTENSION = .html
+HTML_HEADER =
+HTML_FOOTER =
+HTML_STYLESHEET =
+HTML_ALIGN_MEMBERS = YES
+GENERATE_HTMLHELP = NO
+CHM_FILE =
+HHC_LOCATION =
+GENERATE_CHI = NO
+BINARY_TOC = NO
+TOC_EXPAND = NO
+DISABLE_INDEX = NO
+ENUM_VALUES_PER_LINE = 4
+GENERATE_TREEVIEW = YES
+TREEVIEW_WIDTH = 250
+#---------------------------------------------------------------------------
+# configuration options related to the LaTeX output
+#---------------------------------------------------------------------------
+GENERATE_LATEX = YES
+LATEX_OUTPUT = latex
+LATEX_CMD_NAME = latex
+MAKEINDEX_CMD_NAME = makeindex
+COMPACT_LATEX = NO
+PAPER_TYPE = a4wide
+EXTRA_PACKAGES =
+LATEX_HEADER =
+PDF_HYPERLINKS = YES
+USE_PDFLATEX = YES
+LATEX_BATCHMODE = NO
+LATEX_HIDE_INDICES = NO
+#---------------------------------------------------------------------------
+# configuration options related to the RTF output
+#---------------------------------------------------------------------------
+GENERATE_RTF = NO
+RTF_OUTPUT = rtf
+COMPACT_RTF = NO
+RTF_HYPERLINKS = NO
+RTF_STYLESHEET_FILE =
+RTF_EXTENSIONS_FILE =
+#---------------------------------------------------------------------------
+# configuration options related to the man page output
+#---------------------------------------------------------------------------
+GENERATE_MAN = NO
+MAN_OUTPUT = man
+MAN_EXTENSION = .3
+MAN_LINKS = NO
+#---------------------------------------------------------------------------
+# configuration options related to the XML output
+#---------------------------------------------------------------------------
+GENERATE_XML = NO
+XML_OUTPUT = xml
+XML_SCHEMA =
+XML_DTD =
+XML_PROGRAMLISTING = YES
+#---------------------------------------------------------------------------
+# configuration options for the AutoGen Definitions output
+#---------------------------------------------------------------------------
+GENERATE_AUTOGEN_DEF = NO
+#---------------------------------------------------------------------------
+# configuration options related to the Perl module output
+#---------------------------------------------------------------------------
+GENERATE_PERLMOD = NO
+PERLMOD_LATEX = NO
+PERLMOD_PRETTY = YES
+PERLMOD_MAKEVAR_PREFIX =
+#---------------------------------------------------------------------------
+# Configuration options related to the preprocessor
+#---------------------------------------------------------------------------
+ENABLE_PREPROCESSING = YES
+MACRO_EXPANSION = YES
+EXPAND_ONLY_PREDEF = YES
+SEARCH_INCLUDES = YES
+INCLUDE_PATH = $(DOXYGEN_SRC_INCLUDE_PATH) .
+INCLUDE_FILE_PATTERNS = *.h
+PREDEFINED = "_KERNEL" \
+ "__FreeBSD__=7" \
+ "__${TARGET_ARCH}__=1" \
+ "__${TARGET_ARCH}=1"
+EXPAND_AS_DEFINED =
+SKIP_FUNCTION_MACROS = YES
+#---------------------------------------------------------------------------
+# Configuration::additions related to external references
+#---------------------------------------------------------------------------
+ALLEXTERNALS = NO
+EXTERNAL_GROUPS = YES
+PERL_PATH = /usr/bin/perl
+#---------------------------------------------------------------------------
+# Configuration options related to the dot tool
+#---------------------------------------------------------------------------
+CLASS_DIAGRAMS = NO
+HIDE_UNDOC_RELATIONS = YES
+HAVE_DOT = YES
+CLASS_GRAPH = YES
+COLLABORATION_GRAPH = YES
+GROUP_GRAPHS = YES
+UML_LOOK = NO
+TEMPLATE_RELATIONS = NO
+INCLUDE_GRAPH = YES
+INCLUDED_BY_GRAPH = YES
+CALL_GRAPH = YES
+GRAPHICAL_HIERARCHY = YES
+DIRECTORY_GRAPH = YES
+DOT_IMAGE_FORMAT = png
+DOT_PATH =
+DOTFILE_DIRS =
+MAX_DOT_GRAPH_WIDTH = 1024
+MAX_DOT_GRAPH_HEIGHT = 1024
+MAX_DOT_GRAPH_DEPTH = 1000
+DOT_TRANSPARENT = NO
+DOT_MULTI_TARGETS = YES
+GENERATE_LEGEND = YES
+DOT_CLEANUP = YES
+#---------------------------------------------------------------------------
+# Configuration::additions related to the search engine
+#---------------------------------------------------------------------------
+SEARCHENGINE = NO
--- /dev/null
+++ tools/kerneldoc/subsys/Doxyfile-linux
@@ -0,0 +1,22 @@
+# Doxyfile 1.4.1
+
+# $MidnightBSD: src/tools/kerneldoc/subsys/Doxyfile-linux,v 1.1 2008/09/16 00:50:12 laffer1 Exp $
+# $FreeBSD: src/tools/kerneldoc/subsys/Doxyfile-linux,v 1.3 2006/07/08 12:31:33 netchild Exp $
+
+#---------------------------------------------------------------------------
+# Project related configuration options
+#---------------------------------------------------------------------------
+PROJECT_NAME = "MidnightBSD kernel $(DOXYGEN_TARGET_ARCH) linuxolator code"
+OUTPUT_DIRECTORY = $(DOXYGEN_DEST_PATH)/linux/
+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) $(NOTREVIEWED)
+
+GENERATE_TAGFILE = linux/linux.tag
+
+ at INCLUDE_PATH = $(DOXYGEN_INCLUDE_PATH)
+ at INCLUDE = common-Doxyfile
+
--- /dev/null
+++ tools/kerneldoc/subsys/notreviewed.dox
@@ -0,0 +1,15 @@
+/* $MidnightBSD: src/tools/kerneldoc/subsys/notreviewed.dox,v 1.1 2008/09/16 00:50:12 laffer1 Exp $ */
+/* $FreeBSD: src/tools/kerneldoc/subsys/notreviewed.dox,v 1.2 2006/07/08 12:31:33 netchild Exp $ */
+
+/** @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.
+ */
--- /dev/null
+++ tools/kerneldoc/subsys/Doxyfile-i4b
@@ -0,0 +1,22 @@
+# Doxyfile 1.4.1
+
+# $MidnightBSD: src/tools/kerneldoc/subsys/Doxyfile-i4b,v 1.1 2008/09/16 00:50:12 laffer1 Exp $
+# $FreeBSD: src/tools/kerneldoc/subsys/Doxyfile-i4b,v 1.3 2006/07/08 12:31:33 netchild Exp $
+
+#---------------------------------------------------------------------------
+# Project related configuration options
+#---------------------------------------------------------------------------
+PROJECT_NAME = "MidnightBSD kernel ISDN code"
+OUTPUT_DIRECTORY = $(DOXYGEN_DEST_PATH)/i4b/
+EXTRACT_ALL = YES # for undocumented src, no warnings enabled
+#--------------------------------------------------------------------------
+# configuration options related to the input files
+#---------------------------------------------------------------------------
+INPUT = $(DOXYGEN_SRC_PATH)/i4b/ $(NOTREVIEWED)
+
+GENERATE_TAGFILE = i4b/i4b.tag
+TAGFILES = dev_pci/dev_pci.tag=../../dev_pci/html
+
+ at INCLUDE_PATH = $(DOXYGEN_INCLUDE_PATH)
+ at INCLUDE = common-Doxyfile
+
--- /dev/null
+++ tools/kerneldoc/subsys/Doxyfile-netinet6
@@ -0,0 +1,21 @@
+# Doxyfile 1.4.1
+
+# $MidnightBSD: src/tools/kerneldoc/subsys/Doxyfile-netinet6,v 1.1 2008/09/16 00:50:12 laffer1 Exp $
+# $FreeBSD: src/tools/kerneldoc/subsys/Doxyfile-netinet6,v 1.3 2006/07/08 12:31:33 netchild Exp $
+
+#---------------------------------------------------------------------------
+# Project related configuration options
+#---------------------------------------------------------------------------
+PROJECT_NAME = "MidnightBSD kernel IPv6 code"
+OUTPUT_DIRECTORY = $(DOXYGEN_DEST_PATH)/netinet6/
+EXTRACT_ALL = YES # for undocumented src, no warnings enabled
+#--------------------------------------------------------------------------
+# configuration options related to the input files
+#---------------------------------------------------------------------------
+INPUT = $(DOXYGEN_SRC_PATH)/netinet6/ $(NOTREVIEWED)
+
+GENERATE_TAGFILE = netinet6/netinet6.tag
+
+ at INCLUDE_PATH = $(DOXYGEN_INCLUDE_PATH)
+ at INCLUDE = common-Doxyfile
+
--- /dev/null
+++ tools/kerneldoc/subsys/Doxyfile-opencrypto
@@ -0,0 +1,21 @@
+# Doxyfile 1.4.1
+
+# $MidnightBSD: src/tools/kerneldoc/subsys/Doxyfile-opencrypto,v 1.1 2008/09/16 00:50:12 laffer1 Exp $
+# $FreeBSD: src/tools/kerneldoc/subsys/Doxyfile-opencrypto,v 1.3 2006/07/08 12:31:33 netchild Exp $
+
+#---------------------------------------------------------------------------
+# Project related configuration options
+#---------------------------------------------------------------------------
+PROJECT_NAME = "MidnightBSD kernel opencrypto code"
+OUTPUT_DIRECTORY = $(DOXYGEN_DEST_PATH)/opencrypto/
+EXTRACT_ALL = YES # for undocumented src, no warnings enabled
+#--------------------------------------------------------------------------
+# configuration options related to the input files
+#---------------------------------------------------------------------------
+INPUT = $(DOXYGEN_SRC_PATH)/opencrypto/ $(NOTREVIEWED)
+
+GENERATE_TAGFILE = opencrypto/opencrypto.tag
+
+ at INCLUDE_PATH = $(DOXYGEN_INCLUDE_PATH)
+ at INCLUDE = common-Doxyfile
+
--- /dev/null
+++ tools/kerneldoc/subsys/Makefile
@@ -0,0 +1,135 @@
+# $MidnightBSD: src/tools/kerneldoc/subsys/Makefile,v 1.1 2008/09/16 00:50:12 laffer1 Exp $
+# $FreeBSD: src/tools/kerneldoc/subsys/Makefile,v 1.7 2007/07/11 05:01:14 delphij Exp $
+#
+
+_ALL!= cd ${.CURDIR} && ls Doxyfile-*
+ALL= ${_ALL:C/Doxyfile-//g}
+PDF_ALL=${_ALL:C/Doxyfile/pdf/g}
+
+TARGET_ARCH?= ${MACHINE_ARCH}
+S?=/usr/src/sys
+LOCALBASE?=/usr/local
+
+MFILES+=dev/acpica/acpi_if.m
+MFILES+=dev/ata/ata_if.m
+MFILES+=dev/eisa/eisa_if.m
+MFILES+=dev/iicbus/iicbb_if.m
+MFILES+=dev/iicbus/iicbus_if.m
+MFILES+=dev/mii/miibus_if.m
+MFILES+=dev/mmc/mmcbr_if.m
+MFILES+=dev/mmc/mmcbus_if.m
+MFILES+=dev/ofw/ofw_bus_if.m
+MFILES+=dev/pccard/card_if.m
+MFILES+=dev/pccard/power_if.m
+MFILES+=dev/pci/pci_if.m
+MFILES+=dev/pci/pcib_if.m
+MFILES+=dev/ppbus/ppbus_if.m
+MFILES+=dev/scc/scc_if.m
+MFILES+=dev/smbus/smbus_if.m
+MFILES+=dev/sound/midi/mpu_if.m
+MFILES+=dev/sound/midi/mpufoi_if.m
+MFILES+=dev/sound/midi/synth_if.m
+MFILES+=dev/sound/pcm/ac97_if.m
+MFILES+=dev/sound/pcm/channel_if.m
+MFILES+=dev/sound/pcm/feeder_if.m
+MFILES+=dev/sound/pcm/mixer_if.m
+MFILES+=dev/spibus/spibus_if.m
+MFILES+=dev/uart/uart_if.m
+MFILES+=dev/usb/usb_if.m
+MFILES+=geom/part/g_part_if.m
+MFILES+=isa/isa_if.m
+MFILES+=kern/bus_if.m
+MFILES+=kern/clock_if.m
+MFILES+=kern/cpufreq_if.m
+MFILES+=kern/device_if.m
+MFILES+=kern/linker_if.m
+MFILES+=kern/serdev_if.m
+MFILES+=libkern/iconv_converter_if.m
+MFILES+=opencrypto/cryptodev_if.m
+MFILES+=pc98/pc98/canbus_if.m
+MFILES+=pci/agp_if.m
+MFILES+=powerpc/powerpc/mmu_if.m
+MFILES+=powerpc/powerpc/pic_if.m
+MFILES+=sparc64/pci/ofw_pci_if.m
+MFILES+=sun4v/mdesc/mdesc_bus_if.m
+
+HFILES= ${MFILES:T:S/.m$/.h/}
+AWK?= awk
+
+.MAIN: usage
+
+usage:
+ @echo "Possible targets are:"
+.for entry in ${ALL}
+ @echo " ${entry}"
+ @echo " pdf-${entry}"
+ @echo " clean-${entry}"
+.endfor
+ @echo
+ @echo " all"
+ @echo " pdf-all"
+ @echo " clean"
+
+all: ${ALL}
+pdf-all:${PDF_ALL}
+
+mfiles: ${HFILES:S/^/${.OBJDIR}\//}
+
+DOXYGEN_DEST_PATH= ${.OBJDIR}
+DOXYGEN_LATEX_DEST_PATH=${.OBJDIR}
+DOXYGEN_PDF_DEST_PATH= ${.OBJDIR}
+
+.if exists{${S}/${TARGET_ARCH}/linux}
+DOXYGEN_LINUX_PATH= ${S}/${TARGET_ARCH}/linux
+.endif
+.if exists{${S}/${TARGET_ARCH}/linux32}
+DOXYGEN_LINUX_PATH+= ${S}/${TARGET_ARCH}/linux32
+.endif
+
+#
+# generate the necessary targets
+#
+.for target in ${ALL}
+${target}: mfiles ${.OBJDIR}/${target}/${target}.tag
+
+${.OBJDIR}/${target}/${target}.tag:
+ @mkdir -p ${.OBJDIR}/${target}
+ @cd ${.OBJDIR} && \
+ env DOXYGEN_INCLUDE_PATH=${.CURDIR} \
+ DOXYGEN_SRC_PATH=${S} \
+ DOXYGEN_DEST_PATH=${DOXYGEN_DEST_PATH} \
+ 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 \
+ PATH=${LOCALBASE}/bin:${PATH} \
+ doxygen ${.CURDIR}/Doxyfile-${target}
+ @echo "API docs for ${target} are now available in ${.OBJDIR}/${target}/." | /usr/bin/fmt
+
+pdf-${target}: ${.OBJDIR}/${target}/${target}.tag
+ @cd ${DOXYGEN_LATEX_DEST_PATH}/${target}/latex && ${MAKE} refman.pdf && cp refman.pdf ${DOXYGEN_PDF_DEST_PATH}/${target}.pdf
+ @echo "API docs for ${target} are now available in ${DOXYGEN_PDF_DEST_PATH}/." | /usr/bin/fmt
+
+CLEANDIRS+= ${DOXYGEN_DEST_PATH}/${target}
+CLEANDIRS+= ${.OBJDIR}/${target}/
+CLEANFILES+= ${DOXYGEN_PDF_DEST_PATH}/${target}.pdf
+clean-${target}:
+ rm -rf ${DOXYGEN_DEST_PATH}/${target} ${.OBJDIR}/${target}
+.endfor
+
+.for file in ${MFILES}
+CLEANDIRS+= ${.OBJDIR}/${file:T:S/.m$/.h/}
+${.OBJDIR}/${file:T:S/.m$/.h/}: ${S}/${file}
+ cd ${.OBJDIR}; ${AWK} -f $S/tools/makeobjops.awk ${S}/${file} -h
+.endfor
+
+#
+# update target for the config files {config syntax change}
+#
+update-doxys:
+.for config_file in ${_ALL}
+ @doxygen -u ${config_file}
+.endfor
+
+.include "Dependencies"
+.include <bsd.obj.mk>
--- /dev/null
+++ tools/kerneldoc/subsys/Doxyfile-netipsec
@@ -0,0 +1,21 @@
+# Doxyfile 1.4.1
+
+# $MidnightBSD: src/tools/kerneldoc/subsys/Doxyfile-netipsec,v 1.1 2008/09/16 00:50:12 laffer1 Exp $
+# $FreeBSD: src/tools/kerneldoc/subsys/Doxyfile-netipsec,v 1.3 2006/07/08 12:31:33 netchild Exp $
+
+#---------------------------------------------------------------------------
+# Project related configuration options
+#---------------------------------------------------------------------------
+PROJECT_NAME = "MidnightBSD kernel IPsec code"
+OUTPUT_DIRECTORY = $(DOXYGEN_DEST_PATH)/netipsec/
+EXTRACT_ALL = YES # for undocumented src, no warnings enabled
+#--------------------------------------------------------------------------
+# configuration options related to the input files
+#---------------------------------------------------------------------------
+INPUT = $(DOXYGEN_SRC_PATH)/netipsec/ $(NOTREVIEWED)
+
+GENERATE_TAGFILE = netipsec/netipsec.tag
+
+ at INCLUDE_PATH = $(DOXYGEN_INCLUDE_PATH)
+ at INCLUDE = common-Doxyfile
+
--- /dev/null
+++ tools/kerneldoc/subsys/Doxyfile-dev_pci
@@ -0,0 +1,23 @@
+# Doxyfile 1.4.1
+
+# $MidnightBSD: src/tools/kerneldoc/subsys/Doxyfile-dev_pci,v 1.1 2008/09/16 00:50:12 laffer1 Exp $
+# $FreeBSD: src/tools/kerneldoc/subsys/Doxyfile-dev_pci,v 1.3 2006/07/08 12:31:33 netchild Exp $
+
+#---------------------------------------------------------------------------
+# Project related configuration options
+#---------------------------------------------------------------------------
+PROJECT_NAME = "MidnightBSD kernel $(DOXYGEN_TARGET_ARCH) PCI device code"
+OUTPUT_DIRECTORY = $(DOXYGEN_DEST_PATH)/dev_pci/
+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/ \
+ $(NOTREVIEWED)
+
+GENERATE_TAGFILE = dev_pci/dev_pci.tag
+
+ at INCLUDE_PATH = $(DOXYGEN_INCLUDE_PATH)
+ at INCLUDE = common-Doxyfile
+
--- /dev/null
+++ tools/kerneldoc/subsys/Doxyfile-dev_sound
@@ -0,0 +1,23 @@
+# Doxyfile 1.4.1
+
+# $MidnightBSD: src/tools/kerneldoc/subsys/Doxyfile-dev_sound,v 1.1 2008/09/16 00:50:12 laffer1 Exp $
+# $FreeBSD: src/tools/kerneldoc/subsys/Doxyfile-dev_sound,v 1.3 2006/07/08 12:31:33 netchild Exp $
+
+#---------------------------------------------------------------------------
+# Project related configuration options
+#---------------------------------------------------------------------------
+PROJECT_NAME = "MidnightBSD kernel sound device code"
+OUTPUT_DIRECTORY = $(DOXYGEN_DEST_PATH)/dev_sound/
+EXTRACT_ALL = YES # for undocumented src, no warnings enabled
+#---------------------------------------------------------------------------
+# configuration options related to the input files
+#---------------------------------------------------------------------------
+INPUT = $(DOXYGEN_SRC_PATH)/dev/sound/ $(NOTREVIEWED)
+
+GENERATE_TAGFILE = dev_sound/dev_sound.tag
+TAGFILES = dev_pci/dev_pci.tag=../../dev_pci/html \
+ dev_usb/dev_usb.tag=../../dev_usb/html
+
+ at INCLUDE_PATH = $(DOXYGEN_INCLUDE_PATH)
+ at INCLUDE = common-Doxyfile
+
--- /dev/null
+++ tools/kerneldoc/subsys/Dependencies
@@ -0,0 +1,22 @@
+# $MidnightBSD: src/tools/kerneldoc/subsys/Dependencies,v 1.1 2008/09/16 00:50:12 laffer1 Exp $
+# $FreeBSD: src/tools/kerneldoc/subsys/Dependencies,v 1.2 2006/07/08 12:31:33 netchild Exp $
+#
+# makefile dependencies for doxygen tag files
+#
+
+$(.OBJDIR)/dev_sound/dev_sound.tag: $(.OBJDIR)/dev_pci/dev_pci.tag \
+ $(.OBJDIR)/dev_usb/dev_usb.tag \
+ $(.OBJDIR)/ac97_if.h \
+ $(.OBJDIR)/channel_if.h \
+ $(.OBJDIR)/feeder_if.h \
+ $(.OBJDIR)/mixer_if.h
+
+$(.OBJDIR)/dev_usb/dev_usb.tag: $(.OBJDIR)/dev_pci/dev_pci.tag \
+ $(.OBJDIR)/usb_if.h
+
+$(.OBJDIR)/dev_pci/dev_pci.tag: $(.OBJDIR)/pci_if.h \
+ $(.OBJDIR)/pcib_if.h \
+ $(.OBJDIR)/bus_if.h
+
+$(.OBJDIR)/i4b/i4b.tag: $(.OBJDIR)/dev_pci/dev_pci.tag
+
--- /dev/null
+++ tools/kerneldoc/subsys/Doxyfile-vm
@@ -0,0 +1,21 @@
+# Doxyfile 1.4.1
+
+# $MidnightBSD: src/tools/kerneldoc/subsys/Doxyfile-vm,v 1.1 2008/09/16 00:50:12 laffer1 Exp $
+# $FreeBSD: src/tools/kerneldoc/subsys/Doxyfile-vm,v 1.3 2006/07/08 12:31:33 netchild Exp $
+
+#---------------------------------------------------------------------------
+# Project related configuration options
+#---------------------------------------------------------------------------
+PROJECT_NAME = "MidnightBSD virtual memory subsystem code"
+OUTPUT_DIRECTORY = $(DOXYGEN_DEST_PATH)/vm/
+EXTRACT_ALL = YES # for undocumented src, no warnings enabled
+#---------------------------------------------------------------------------
+# configuration options related to the input files
+#---------------------------------------------------------------------------
+INPUT = $(DOXYGEN_SRC_PATH)/vm/ $(NOTREVIEWED)
+
+GENERATE_TAGFILE = vm/vm.tag
+
+ at INCLUDE_PATH = $(DOXYGEN_INCLUDE_PATH)
+ at INCLUDE = common-Doxyfile
+
--- /dev/null
+++ tools/kerneldoc/subsys/Doxyfile-netinet
@@ -0,0 +1,21 @@
+# Doxyfile 1.4.1
+
+# $MidnightBSD: src/tools/kerneldoc/subsys/Doxyfile-netinet,v 1.1 2008/09/16 00:50:12 laffer1 Exp $
+# $FreeBSD: src/tools/kerneldoc/subsys/Doxyfile-netinet,v 1.3 2006/07/08 12:31:33 netchild Exp $
+
+#---------------------------------------------------------------------------
+# Project related configuration options
+#---------------------------------------------------------------------------
+PROJECT_NAME = "MidnightBSD kernel IPv4 code"
+OUTPUT_DIRECTORY = $(DOXYGEN_DEST_PATH)/netinet/
+EXTRACT_ALL = YES # for undocumented src, no warnings enabled
+#--------------------------------------------------------------------------
+# configuration options related to the input files
+#---------------------------------------------------------------------------
+INPUT = $(DOXYGEN_SRC_PATH)/netinet/ $(NOTREVIEWED)
+
+GENERATE_TAGFILE = netinet/netinet.tag
+
+ at INCLUDE_PATH = $(DOXYGEN_INCLUDE_PATH)
+ at INCLUDE = common-Doxyfile
+
--- /dev/null
+++ tools/kerneldoc/subsys/README
@@ -0,0 +1,33 @@
+ The kernel subsystem API documentation generation framework.
+ --------------------------------------------------------------
+
+For every Doxyfile-(.*) the Makefile adds the public targets $1, pdf-$1 and
+clean-$1. For e.g. Doxyfile-dev_pci this translates to the targets dev_pci,
+pdf-dev_pci and clean-dev_pci.
+
+Additionally, the targets 'all', 'pdf-all' and 'clean' to generate or remove
+the documentation for all targets are available.
+
+The file 'Dependencies' contains dependencies for the .tag files.
+
+To add another part to the documentation just copy a Doxyfile and add
+the necessary dependencies to the file 'Dependencies'.
+
+The following environment variables can be used in the Doxyfile:
+ - DOXYGEN_SRC_PATH (/usr/src/sys)
+ - DOXYGEN_DEST_PATH (where the docs are generated)
+ - DOXYGEN_TARGET_ARCH (${TARGET_ARCH} if set, else ${MACHINE_ARCH})
+
+For the PDF generation you may have to change some limits in the latex
+configuration (the build may fail and an error about e.g. "pool size" is
+shown), for print/teTeX this is done in
+ /usr/local/share/texmf/web2c/texmf.cnf
+
+Programs needed to generate the API docs:
+ - devel/doxygen
+ - print/teTeX
+ - graphics/graphviz
+
+--
+$MidnightBSD: src/tools/kerneldoc/subsys/README,v 1.1 2008/09/16 00:50:12 laffer1 Exp $
+$FreeBSD: src/tools/kerneldoc/subsys/README,v 1.2 2006/07/08 12:31:33 netchild Exp $
--- /dev/null
+++ tools/kerneldoc/subsys/Doxyfile-netgraph
@@ -0,0 +1,21 @@
+# Doxyfile 1.4.1
+
+# $MidnightBSD: src/tools/kerneldoc/subsys/Doxyfile-netgraph,v 1.1 2008/09/16 00:50:12 laffer1 Exp $
+# $FreeBSD: src/tools/kerneldoc/subsys/Doxyfile-netgraph,v 1.3 2006/07/08 12:31:33 netchild Exp $
+
+#---------------------------------------------------------------------------
+# Project related configuration options
+#---------------------------------------------------------------------------
+PROJECT_NAME = "MidnightBSD kernel netgraph code"
+OUTPUT_DIRECTORY = $(DOXYGEN_DEST_PATH)/netgraph/
+EXTRACT_ALL = YES # for undocumented src, no warnings enabled
+#--------------------------------------------------------------------------
+# configuration options related to the input files
+#---------------------------------------------------------------------------
+INPUT = $(DOXYGEN_SRC_PATH)/netgraph/ $(NOTREVIEWED)
+
+GENERATE_TAGFILE = netgraph/netgraph.tag
+
+ at INCLUDE_PATH = $(DOXYGEN_INCLUDE_PATH)
+ at INCLUDE = common-Doxyfile
+
More information about the Midnightbsd-cvs
mailing list