On Thu, 25 Oct 2007 13:25:37 -0500 Rob Landley wrote: > On Thursday 25 October 2007 10:40:39 am Randy Dunlap wrote: > > On Thu, 25 Oct 2007 06:06:03 -0500 Rob Landley wrote: > > > The rest sort of seems to make sense, although the kerneldoc comments in > > > include/scsi/scsi_device.h are before #defines instead of before function > > > definitions so the make xmldocs infrastructure (something in either > > > scripts/basic/docproc.c or scripts/kernel-doc) skips right over it > > > because it can't figure out the argument types. Separate issue, todo > > > item for later... > > > > scripts/kernel-doc is supposed to (and usually does) handle > > kernel-doc notation of a #define macro. Are these 2 not working? > > Not when I tried it. > > > $ make xmldocs > > make -C /home/landley/linux/hg O=/home/landley/linux/temp xmldocs > > DOCPROC Documentation/DocBook/scsi_midlayer.xml > > Warning(/home/landley/linux/hg//include/scsi/scsi_device.h): no structured > > comments found > > Entirely possible I'm doing something wrong: > > <sect1 id="scsi_device.h"> > <title>include/scsi/scsi_device.h</title> > <para> > </para> > !Einclude/scsi/scsi_device.h > </sect1> !E is for exported symbols and that file has none. USe !I instead. --- ~Randy - To unsubscribe from this list: send the line "unsubscribe linux-scsi" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
