From owner-cvs-all@FreeBSD.ORG Fri May 26 18:24:56 2006 Return-Path: X-Original-To: cvs-all@FreeBSD.org Delivered-To: cvs-all@FreeBSD.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 65A8C16A878; Fri, 26 May 2006 18:24:56 +0000 (UTC) (envelope-from sam@errno.com) Received: from ebb.errno.com (ebb.errno.com [69.12.149.25]) by mx1.FreeBSD.org (Postfix) with ESMTP id E198043D60; Fri, 26 May 2006 18:24:55 +0000 (GMT) (envelope-from sam@errno.com) Received: from [10.0.0.248] (trouble.errno.com [10.0.0.248]) (authenticated bits=0) by ebb.errno.com (8.13.6/8.12.6) with ESMTP id k4QIOsLn089430 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Fri, 26 May 2006 11:24:55 -0700 (PDT) (envelope-from sam@errno.com) Message-ID: <447747F6.6010308@errno.com> Date: Fri, 26 May 2006 11:24:54 -0700 From: Sam Leffler User-Agent: Thunderbird 1.5.0.2 (X11/20060508) MIME-Version: 1.0 To: Alexander Leidinger References: <200605261806.k4QI67D3007680@repoman.freebsd.org> In-Reply-To: <200605261806.k4QI67D3007680@repoman.freebsd.org> X-Enigmail-Version: 0.94.0.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: cvs-src@FreeBSD.org, src-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: 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 ... X-BeenThere: cvs-all@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: CVS commit messages for the entire tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 26 May 2006 18:25:06 -0000 Alexander Leidinger wrote: > netchild 2006-05-26 18:06:07 UTC > > FreeBSD src repository > > Added files: > 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 Doxyfile-netgraph > Doxyfile-netinet Doxyfile-netinet6 > Doxyfile-netipsec Doxyfile-opencrypto > Doxyfile-vm Makefile README > common-Doxyfile > Log: > This is the kernel subsystem API documentation generation framework. > > It uses doxygen to generate the API documentation. For each subsystem > a very small (about 20 lines with comments) subsystem specific Doxyfile > has to be written (have a look at the README for more). All common doxygen > options are specified in a separate file. > > The framework is configured to not only generate the HTML version, but also > a PDF version (the paper size is hardcoded to DIN A4 currently and depending > on the subsystem you have to increase some limits in the latex configuration > of your system, the README tells more about this). > > It also allows cross-references between the subsystems (it generates doxygen > tag files). > > Currently the docs are generated in OBJDIR, but this may change after > coordination with doc@. The makefile is prepared to generate/move various > parts of the generated docs to different destinations. > > TARGET_ARCH is respected and some env-vars are set for architecture specific > handling of the source (the README tells more). > > Subsystems for which docs are generated: > - cam - crypto - dev_pci > - dev_sound - dev_usb - geom > - i4b - kern - libkern > - linux - net80211 - netgraph > - netinet - netinet6 - netipsec > - opencrypto - vm > > Requested by: gnn Can someone explain the purpose of this? Is the intent to annotate source code for generating documentation? I don't recall seeing a discussion about this. Sam