[patch] 2.6.8-rc1-mm1: work around broken USB DocBook generation

From: Adrian Bunk (bunk_at_fs.tum.de)
Date: 07/18/04

  • Next message: Robert M. Stockmann: "Re: Comparing struct pt_regs : asm-i386 vs asm-x86_64" 
    Date:	Sun, 18 Jul 2004 05:53:49 +0200
To: Andrew Morton <akpm@osdl.org>, greg@kroah.com

    On Tue, Jul 13, 2004 at 06:25:59PM -0700, Andrew Morton wrote:
    >...
    > All 252 patches:
    >...
    > bk-usb.patch
    >...

    This causes the following error during "make psdocs":

    <-- snip -->

    ...
      DB2PS Documentation/DocBook/usb.ps
    Using catalogs: /etc/sgml/catalog
    Using style***: /usr/share/docbook-utils/docbook-utils.dsl#print
    Working on:
    /home/bunk/linux/kernel-2.6/linux-2.6.8-rc1-mm1-full/Documentation/DocBook/usb.sgml
    jade:/home/bunk/linux/kernel-2.6/linux-2.6.8-rc1-mm1-full/Documentation/DocBook/usb.sgml:549:16:E:
    end tag for "VARIABLELIST" which is not finished
    make[1]: *** [Documentation/DocBook/usb.ps] Error 8

    <-- snip -->

    The patch below works around this issue by not letting it look like a
    valid kerneldoc.

    Signed-off-by: Adrian Bunk <bunk@fs.tum.de>

    --- linux-2.6.8-rc1-mm1-full/include/linux/usb.h.old 2004-07-18 05:47:38.000000000 +0200
    +++ linux-2.6.8-rc1-mm1-full/include/linux/usb.h 2004-07-18 05:47:51.000000000 +0200
    @@ -289,7 +289,7 @@
     
     struct usb_tt;
     
    -/**
    +/*
      * struct usb_device - kernel's representation of a USB device
      *
      * FIXME: Write the kerneldoc!

    -
    To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
    the body of a message to majordomo@vger.kernel.org
    More majordomo info at http://vger.kernel.org/majordomo-info.html
    Please read the FAQ at http://www.tux.org/lkml/

  • Next message: Robert M. Stockmann: "Re: Comparing struct pt_regs : asm-i386 vs asm-x86_64"