diff options
author | netchild <netchild@FreeBSD.org> | 2006-05-26 18:10:06 +0000 |
---|---|---|
committer | netchild <netchild@FreeBSD.org> | 2006-05-26 18:10:06 +0000 |
commit | e14fcb8fd5522b9ebd84644f8a0c6c38609591a0 (patch) | |
tree | 646b316f0c1ebfe618cee83ec3121e8645342eee | |
parent | db261387073c8a6b1a1606b7f5fe95ed1cc10b35 (diff) | |
download | FreeBSD-src-e14fcb8fd5522b9ebd84644f8a0c6c38609591a0.zip FreeBSD-src-e14fcb8fd5522b9ebd84644f8a0c6c38609591a0.tar.gz |
Connect the kernel subsystem API documentation generation framework to
the build infrastructure: "make doxygen"
Changes to the man pages will be made when some defaults are revisited.
Requested by: gnn
-rw-r--r-- | Makefile | 9 | ||||
-rw-r--r-- | Makefile.inc1 | 13 |
2 files changed, 18 insertions, 4 deletions
@@ -15,6 +15,7 @@ # reinstallkernel - Reinstall the kernel and the kernel-modules. # reinstallkernel.debug # kernel - buildkernel + installkernel. +# doxygen - Build API documentation of the kernel, needs doxygen. # update - Convenient way to update your source tree (cvs). # check-old - Print a list of old files/directories in the system. # delete-old - Delete obsolete files and directories interactively. @@ -69,10 +70,10 @@ # TGTS= all all-man buildenv buildkernel buildworld check-old checkdpadd \ clean cleandepend cleandir delete-old delete-old-libs depend \ - distribute distributeworld distrib-dirs distribution everything \ - hierarchy install installcheck installkernel installkernel.debug\ - reinstallkernel reinstallkernel.debug installworld \ - kernel-toolchain libraries lint maninstall \ + distribute distributeworld distrib-dirs distribution doxygen \ + everything hierarchy install installcheck installkernel \ + installkernel.debug reinstallkernel reinstallkernel.debug \ + installworld kernel-toolchain libraries lint maninstall \ obj objlink regress rerelease showconfig tags toolchain update \ _worldtmp _legacy _bootstrap-tools _cleanobj _obj \ _build-tools _cross-tools _includes _libraries _depend \ diff --git a/Makefile.inc1 b/Makefile.inc1 index 0a4d4f4..6e5bb1e 100644 --- a/Makefile.inc1 +++ b/Makefile.inc1 @@ -17,6 +17,7 @@ # The intended user-driven targets are: # buildworld - rebuild *everything*, including glue to help do upgrades # installworld- install everything built by "buildworld" +# doxygen - build API documentation of the kernel # update - convenient way to update your source tree (eg: cvsup/cvs) # # Standard targets (not defined here) are documented in the makefiles in @@ -711,6 +712,18 @@ reinstallkernel reinstallkernel.debug: installcheck ${MAKE} KERNEL=${INSTKERNNAME} ${.TARGET:S/kernel//} # +# doxygen +# +# Build the API documentation with doxygen +# +doxygen: + @if [ ! -x `/usr/bin/which doxygen` ]; then \ + echo "You need doxygen (devel/doxygen) to generate the API documentation of the kernel." | /usr/bin/fmt; \ + exit 1; \ + fi + cd ${.CURDIR}/sys/doc/subsys && ${MAKE} obj all + +# # update # # Update the source tree, by running cvsup and/or running cvs to update to the |