public inbox for linux-kernel@vger.kernel.org
 help / color / mirror / Atom feed
From: Adrian Bunk <bunk@fs.tum.de>
To: Andrew Morton <akpm@osdl.org>, greg@kroah.com
Cc: linux-kernel@vger.kernel.org, linux-usb-devel@lists.sourceforge.net
Subject: [patch] 2.6.8-rc1-mm1: work around broken USB DocBook generation
Date: Sun, 18 Jul 2004 05:53:49 +0200	[thread overview]
Message-ID: <20040718035349.GR14733@fs.tum.de> (raw)
In-Reply-To: <20040713182559.7534e46d.akpm@osdl.org>

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!


  parent reply	other threads:[~2004-07-18  3:53 UTC|newest]

Thread overview: 18+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2004-07-14  1:25 2.6.8-rc1-mm1 Andrew Morton
2004-07-14  7:29 ` 2.6.8-rc1-mm1 Andrew Morton
2004-07-14  8:11   ` 2.6.8-rc1-mm1 David Howells
2004-07-14 16:36 ` 2.6.8-rc1-mm1 John Cherry
2004-07-14 18:49 ` [patch] 2.6.8-rc1-mm1: USB w9968cf compile error Adrian Bunk
2004-07-14 19:03   ` Greg KH
2004-07-14 19:08   ` Adrian Bunk
2004-07-14 20:29 ` 2.6.8-rc1-mm1 Dominik Karall
2004-07-14 20:43   ` [patch] 2.6.8-rc1-mm1: 8139too: uninline rtl8139_start_thread Adrian Bunk
2004-07-14 20:45     ` Jeff Garzik
2004-07-27 18:00     ` Jeff Garzik
2004-07-14 21:08 ` 2.6.8-rc1-mm1 Dominik Karall
2004-07-14 21:53 ` 2.6.8-rc1-mm1 Tim Bird
2004-07-15 10:35 ` 2.6.8-rc1-mm1 Ralf Hildebrandt
2004-07-18  3:53 ` Adrian Bunk [this message]
2004-07-20  0:02 ` 2.6.8-rc1-mm1 J.A. Magallon
2004-07-22 12:56   ` 2.6.8-rc1-mm1 Jens Axboe
2004-07-20  0:05 ` 2.6.8-rc1-mm1 J.A. Magallon

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20040718035349.GR14733@fs.tum.de \
    --to=bunk@fs.tum.de \
    --cc=akpm@osdl.org \
    --cc=greg@kroah.com \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linux-usb-devel@lists.sourceforge.net \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox