Newsgroups: php.internals Path: news.php.net Xref: news.php.net php.internals:29911 Return-Path: Mailing-List: contact internals-help@lists.php.net; run by ezmlm Delivered-To: mailing list internals@lists.php.net Received: (qmail 93299 invoked by uid 1010); 29 May 2007 23:41:41 -0000 Delivered-To: ezmlm-scan-internals@lists.php.net Delivered-To: ezmlm-internals@lists.php.net Received: (qmail 93284 invoked from network); 29 May 2007 23:41:41 -0000 Received: from unknown (HELO lists.php.net) (127.0.0.1) by localhost with SMTP; 29 May 2007 23:41:41 -0000 Authentication-Results: pb1.pair.com header.from=kingwez@gmail.com; sender-id=pass; domainkeys=bad Authentication-Results: pb1.pair.com smtp.mail=kingwez@gmail.com; spf=pass; sender-id=pass Received-SPF: pass (pb1.pair.com: domain gmail.com designates 64.233.166.180 as permitted sender) DomainKey-Status: bad X-DomainKeys: Ecelerity dk_validate implementing draft-delany-domainkeys-base-01 X-PHP-List-Original-Sender: kingwez@gmail.com X-Host-Fingerprint: 64.233.166.180 py-out-1112.google.com Linux 2.4/2.6 Received: from [64.233.166.180] ([64.233.166.180:14070] helo=py-out-1112.google.com) by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP id 00/4D-10662-53ABC564 for ; Tue, 29 May 2007 19:41:41 -0400 Received: by py-out-1112.google.com with SMTP id a25so3831018pyi for ; Tue, 29 May 2007 16:41:39 -0700 (PDT) DKIM-Signature: a=rsa-sha1; c=relaxed/relaxed; d=gmail.com; s=beta; h=domainkey-signature:received:received:message-id:date:from:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; b=gqByCoMgBr4gjevv9SzcJVipcm7CZM4Bn094KwyAkqdQL3Xv4gl7vmLFLY4HrRIeEt6dw6y8HnBkld6pKfi8VrPDtyp3P9gNr7VmcZ8fYULh+dSjhVP83CIjWm77eo7dNRUZVcI839GiB2xke2l9F0TE2ZXfrckHvClELqFTuRo= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=beta; h=received:message-id:date:from:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; b=WyKfkZhifVfl8JJuucTfYNGydsOOjJBigSAV33qCPP9vpKg3WHmVjb6Vc9xBGe4c5kB+vagHkiT5t+aeOiOqS8M33Kg6SVqKM+AJTOeESs7cXADTGPOXy/Y+AESvXdqipzlTYRal7YdVjtEk0UARM3rekXzdqRqwlP5Vosm9IAI= Received: by 10.35.57.2 with SMTP id j2mr14018686pyk.1180482098583; Tue, 29 May 2007 16:41:38 -0700 (PDT) Received: by 10.35.108.15 with HTTP; Tue, 29 May 2007 16:41:38 -0700 (PDT) Message-ID: <4e89b4260705291641r20cdb21bg276e4ce8fc1c61fd@mail.gmail.com> Date: Tue, 29 May 2007 19:41:38 -0400 To: "Antony Dovgal" Cc: "Gwynne Raskind" , internals@lists.php.net In-Reply-To: <462FD093.90402@zend.com> MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Content-Disposition: inline References: <97180F0D-CB4C-4071-A859-38059C0DD1FF@wanderingknights.org> <0DFF3A59-3419-4A25-B907-E0E71FD41360@wanderingknights.org> <462FD093.90402@zend.com> Subject: Re: [PHP-DEV] Documenting the Zend2 extension API From: kingwez@gmail.com ("Wez Furlong") We use doxygen for the developer portions of our customer facing manual. The trick is to have it output xml and then massage that to fit into docbook. --Wez. On 4/25/07, Antony Dovgal wrote: > Doxygen (which seems to be uses by the majority of F/OSS projects) generates completely unreadable docs. > Every time I look into ICU docs (generated by Doxygen) I get lost for 10 minutes trying to find a function _by name_. > In the same time, other tools do not provide such a wide range of output formats as available in Doxygen. > > Anyways ZE internals documentation definitely needs serious update and this would be very much appreciated. > The only problem is that you need to know the internals a bit (or at least want to learn it) to be > able to document it, and all the people with this knowledge are busy with other things most of the time.. > You can count on me if you need any help/hints, though.