lkml.org 
[lkml]   [2004]   [Jul]   [17]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
Patch in this message
/
Date
From
Subject[patch] 2.6.8-rc1-mm1: work around broken USB DocBook generation
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@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/

\
 
 \ /
  Last update: 2005-03-22 14:04    [W:0.622 / U:0.044 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site