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 [EMAIL PROTECTED]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Reply via email to