From owner-freebsd-current@FreeBSD.ORG Sun May 1 15:59:54 2005 Return-Path: Delivered-To: freebsd-current@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id B61F116A4CE for ; Sun, 1 May 2005 15:59:54 +0000 (GMT) Received: from critter.freebsd.dk (0x535c0e2a.sgnxx1.adsl-dhcp.tele.dk [83.92.14.42]) by mx1.FreeBSD.org (Postfix) with ESMTP id A912B43D2D for ; Sun, 1 May 2005 15:59:53 +0000 (GMT) (envelope-from phk@critter.freebsd.dk) Received: from critter.freebsd.dk (localhost [127.0.0.1]) by critter.freebsd.dk (8.13.3/8.13.3) with ESMTP id j41FxqDV011871; Sun, 1 May 2005 17:59:52 +0200 (CEST) (envelope-from phk@critter.freebsd.dk) To: Alexander Leidinger From: "Poul-Henning Kamp" In-Reply-To: Your message of "Sun, 01 May 2005 17:08:00 +0200." <20050501170800.1bf7e377@Magellan.Leidinger.net> Date: Sun, 01 May 2005 17:59:52 +0200 Message-ID: <11870.1114963192@critter.freebsd.dk> Sender: phk@critter.freebsd.dk cc: current@freebsd.org Subject: Re: Doxygen generated PDF's of parts of the kernel available X-BeenThere: freebsd-current@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Discussions about the use of FreeBSD-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 01 May 2005 15:59:54 -0000 In message <20050501170800.1bf7e377@Magellan.Leidinger.net>, Alexander Leidinge r writes: As far as I can tell, this gives us very little over a normal code reading because we have not marked up our source code. If we mark up the source code for doxygen, does that buy us anything besides more text in the pdf files ? Or to put the question another way: Is the doxygen markup *semantically* useful for any automated code-munching tools ? Will anything tell us "you have an inconsistency here" or "this is ambiguous" etc ? It's not that I am against marking up for doxygen, that is probably a good idea at some level. My primary interest is tools which will tell us something about our source code which we didn't know before, not just pretty-print what we told it ourselves. Poul-Henning >Hi, > >I've generated the doxygen docs for some parts of the kernel, in >particular for: > - cam > - crypto > - dev/pci > - dev/sound > - dev/usb > - geom > - i4b > - kern > - libkern > - net80211 > - netgraph > - netinet > - netinet6 > - netipsec > - opencrypto > - vm > >Since the content of all html trees sums up to >360 MB, I'm just >uploading (it will need some minutes) the PDF's to > http://www.leidinger.net/FreeBSD/src_docs/ > >They describe -current as of today (and may contain some local >patches, I've used my development tree...). > >Bye, >Alexander. > >-- > The computer revolution is over. The computers won. > >http://www.Leidinger.net Alexander @ Leidinger.net > GPG fingerprint = C518 BC70 E67F 143F BE91 3365 79E2 9C60 B006 3FE7 >_______________________________________________ >freebsd-current@freebsd.org mailing list >http://lists.freebsd.org/mailman/listinfo/freebsd-current >To unsubscribe, send any mail to "freebsd-current-unsubscribe@freebsd.org" > -- Poul-Henning Kamp | UNIX since Zilog Zeus 3.20 phk@FreeBSD.ORG | TCP/IP since RFC 956 FreeBSD committer | BSD since 4.3-tahoe Never attribute to malice what can adequately be explained by incompetence.