From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 14182 invoked by alias); 8 Oct 2006 18:15:30 -0000 Received: (qmail 14114 invoked by uid 22791); 8 Oct 2006 18:15:29 -0000 X-Spam-Check-By: sourceware.org Received: from relais.videotron.ca (HELO relais.videotron.ca) (24.201.245.36) by sourceware.org (qpsmtpd/0.31) with ESMTP; Sun, 08 Oct 2006 18:15:27 +0000 Received: from [192.168.223.50] ([24.203.249.139]) by VL-MH-MR001.ip.videotron.ca (Sun Java System Messaging Server 6.2-2.05 (built Apr 28 2005)) with ESMTP id <0J6T00NI6XDP29C0@VL-MH-MR001.ip.videotron.ca> for binutils@sources.redhat.com; Sun, 08 Oct 2006 14:15:25 -0400 (EDT) Date: Sun, 08 Oct 2006 18:15:00 -0000 From: Jeff Bailey Subject: RE: Doxygen and bfd code In-reply-to: <02c801c6eae4$10a1a570$a501a8c0@CAM.ARTIMI.COM> To: Dave Korn Cc: binutils@sources.redhat.com Message-id: <1160331304.6041.9.camel@localhost.localdomain> MIME-version: 1.0 X-Mailer: Evolution 2.8.1 Content-type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="=-qgroaxuYavRMDP4rhIzu" References: <02c801c6eae4$10a1a570$a501a8c0@CAM.ARTIMI.COM> Mailing-List: contact binutils-help@sourceware.org; run by ezmlm Precedence: bulk List-Subscribe: List-Archive: List-Post: List-Help: , Sender: binutils-owner@sourceware.org X-SW-Source: 2006-10/txt/msg00051.txt.bz2 --=-qgroaxuYavRMDP4rhIzu Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Content-length: 950 Le dimanche 08 octobre 2006 =C3=A0 15:14 +0100, Dave Korn a =C3=A9crit : > BFD already has its own standard for internal documentation. You should > follow that. Adding doxygen comments would have the twin disadvantages of > requiring a new tool as part of the build process, and generating two sep= arate > and incomplete subsets of documentation in two incompatible formats. Tak= e a > look at bfd.c; all those comments with instructions like 'SECTION', > 'SUBSECTION', 'FUNCTION' etc. are pulled together during the build proces= s and > used to compile the bfd internals manual. Ah cool. I haven't looked at the bfd manual in years, but if there's an existing format I can document in, that should be good enough. I'll go digging and see what I can add. Tks, Jeff Bailey --=20 Although when you're in the situation that RMS is telling you that you're being too ideological about freedom, maybe, just maybe, it's true. - Matthew Wilcox --=-qgroaxuYavRMDP4rhIzu Content-Type: application/pgp-signature; name=signature.asc Content-Description: Ceci est une partie de message =?ISO-8859-1?Q?num=E9riquement?= =?ISO-8859-1?Q?_sign=E9e?= Content-length: 189 -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.3 (GNU/Linux) iD8DBQBFKUAo5M5hmdCYCpkRArgCAKCtEJHgh7N7gMWFM49KIQYyC6tHlgCfYT04 5rB27YkRKErpE8ePtnvUneU= =r1Sz -----END PGP SIGNATURE----- --=-qgroaxuYavRMDP4rhIzu--