On Sun, Aug 28, 2011 at 02:24:04AM +0100, Steve McIntyre wrote: >On Sat, Aug 27, 2011 at 07:45:45PM -0400, Geoffrey Thomas wrote: >>Package: libaudio-dev >>Version: 1.9.2-9 >> >>Hi, >> >>Somewhere between 1.9.2-4 (squeeze) and 1.9.2-9 (wheezy), the >>synopsis for AuStartFlow(3nas) and some others turned from a simple >> >>Synopsis >> void AuStartFlow(server, flow, status) >> AuServer *server; >> AuFlowID flow; >> AuStatus *status; >> >>to a list of enums and includes and structs and unrelated functions, >>finally getting to the synopsis of AuStartFlow itself after about >>twenty screenfuls. (In the words of two people I showed the man page >>to, "What is this I don't even" and "That's no man page! That's an >>include file!") >> >>I don't see anything in the changelog indicating this is intentional, >>so I assume that something that's automatically parsing out the >>synopsis broke in a recent build, and started including too much. >> >>Even if you do intend to include some structs, it's probably not >>helpful to start off with "typedef unsigned char __u_char;" and >>include things like "typedef unsigned long int __ino_t;". > >Ewww, yes. I'm seeing that too here. Apologies, this is *not* meant to >be happening...!
I can see that the difference has happened between 1.9.2-8 and -9. There's nothing changed in the nas sources that could trigger such a change. I've just rebuilt 1.9.2-8 using the latest unstable tools, and it shows the same problem. Previously, the man pages would include a line saying: #include <audio/audiolib.h> but it now seems that somehow that #include is being actioned during the package build and so the junk you're seeing is the contents of audio/audiolib.h. I'm digging a little further now... -- Steve McIntyre, Cambridge, UK. st...@einval.com Support the Campaign for Audiovisual Free Expression: http://www.eff.org/cafe/ -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
