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

[Adrian Bunk]

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 stylesheet: /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@xxxxxxxxx>

--- 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@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/